Cara Install Composer di Windows: Panduan Lengkap + Perintah Utama

Irman Firmansyah
Irman Firmansyah

Kalau kamu baru mulai belajar PHP, cepat atau lambat kamu akan bertemu dengan istilah Composer. Alat ini hampir selalu jadi syarat wajib sebelum bisa menjalankan framework populer seperti Laravel atau Symfony. Sayangnya, banyak pemula yang bingung di tahap awal karena Composer butuh PHP terlebih dahulu, lalu bingung lagi soal perintah-perintah dasarnya. Artikel ini akan membahas tuntas cara install Composer di Windows dari nol, mengenal perintah-perintah utamanya, sampai contoh kasus penggunaannya di project nyata.

Daftar isi

Apa itu Composer?

Composer adalah alat pengelola dependency (dependency manager) untuk PHP. Tugas utamanya adalah mengurus library apa saja yang dibutuhkan sebuah project, lalu mengunduh dan memasangnya secara otomatis ke folder vendor. Alih-alih mengunduh library satu per satu secara manual dari internet, kamu cukup menuliskan nama dan versi library yang dibutuhkan, dan Composer akan mengurus sisanya — termasuk mengunduh library lain yang menjadi dependency dari library tersebut.

Perbedaan dengan package manager sistem: Composer bukan seperti Apt atau Yum yang menginstal aplikasi secara global ke sistem operasi. Composer bekerja per-project — setiap project punya folder vendor-nya sendiri, sehingga versi library di satu project tidak akan bentrok dengan project lain.

Persiapan Sebelum Install Composer

Install PHP Terlebih Dahulu

Karena Composer sendiri adalah program yang ditulis dengan bahasa PHP, komputer Windows-mu wajib sudah memiliki PHP terpasang sebelum Composer bisa dijalankan. Langkah-langkahnya:

  1. Buka halaman resmi windows.php.net lalu unduh paket PHP untuk Windows. Disarankan memakai build x64 karena hampir semua Windows saat ini sudah 64-bit, dan pilih varian Non Thread Safe (NTS) jika hanya untuk pemakaian di command line (CLI).
  2. Ekstrak file zip yang sudah diunduh ke folder tertentu, misalnya C:\php.
  3. Di dalam folder tersebut, salin file php.ini-development (untuk lingkungan belajar/testing) menjadi php.ini.

Menambahkan PHP ke PATH Windows

Supaya perintah php bisa dipanggil dari Command Prompt di direktori mana pun, folder PHP tadi (misalnya C:\php) perlu ditambahkan ke environment variable PATH:

  1. Buka Control Panel > System > Advanced system settings, atau ketik "environment variables" di kotak pencarian Windows.
  2. Klik tombol Environment Variables.
  3. Pada bagian System variables, cari variabel Path, lalu klik Edit dan tambahkan baris baru berisi lokasi folder PHP, misalnya C:\php.
  4. Klik OK di semua jendela, lalu tutup dan buka ulang Command Prompt.
  5. Cek apakah berhasil dengan mengetik php -v — jika muncul versi PHP, berarti sudah benar.
Kalau setelah menambahkan PATH perintah php -v masih tidak dikenali, pastikan kamu menutup semua jendela Command Prompt yang lama dan membuka yang baru. PATH hanya dibaca ulang saat terminal baru dibuka.

Cara Install Composer di Windows

Download Composer-Setup.exe

Cara paling mudah memasang Composer di Windows adalah lewat installer resminya. Buka halaman Download di situs resmi getcomposer.org, lalu unduh file Composer-Setup.exe. Installer ini nantinya juga akan otomatis mengatur PATH sehingga perintah composer bisa dipanggil dari terminal mana saja.

Langkah-Langkah Instalasi

  1. Jalankan file Composer-Setup.exe yang sudah diunduh dengan cara klik dua kali.
  2. Pada pilihan tipe instalasi, pilih Install for all users (opsi yang direkomendasikan) supaya Composer bisa dipakai oleh semua akun pengguna di komputer tersebut.
  3. Installer akan mencoba mendeteksi lokasi php.exe secara otomatis. Jika lokasi yang ditampilkan sudah benar (misalnya C:\php\php.exe), lanjutkan saja. Jika belum terdeteksi, arahkan manual ke lokasi PHP yang sudah kamu install sebelumnya.
  4. Bagian pengaturan proxy bisa dilewati (kosongkan) jika kamu tidak berada di jaringan kantor/kampus yang mewajibkan proxy.
  5. Klik Install, tunggu proses selesai, lalu klik Finish.
Setelah instalasi selesai, tutup jendela Command Prompt atau terminal apa pun yang sedang terbuka, lalu buka yang baru. Ini penting karena PATH yang baru saja diatur oleh installer hanya akan terbaca oleh terminal yang dibuka setelahnya.

Verifikasi Instalasi

Buka Command Prompt (atau PowerShell) yang baru, lalu ketik:

composer -V

Jika instalasi berhasil, akan muncul output berisi versi Composer yang terpasang, misalnya Composer version 2.x.x. Kamu juga bisa mengetik composer saja tanpa parameter untuk melihat daftar lengkap perintah yang tersedia.

Mengenal composer.json dan composer.lock

Sebelum masuk ke perintah-perintah utamanya, penting untuk mengenal dua file inti yang selalu berdampingan dengan Composer:

composer.json — file yang mendeskripsikan project-mu, termasuk daftar library yang dibutuhkan beserta batasan versinya (version constraint). File ini yang kamu tulis atau yang dihasilkan otomatis saat memakai perintah tertentu.

composer.lock — file yang mencatat versi persis dari setiap library yang berhasil dipasang. Tujuannya supaya semua orang yang mengerjakan project yang sama mendapat versi library yang identik, sehingga menghindari bug "di komputer saya kok jalan" karena perbedaan versi.

Contoh isi sederhana sebuah composer.json:

{
  "require": {
    "monolog/monolog": "2.0.*"
  }
}

Baris "monolog/monolog": "2.0.*" di atas artinya project ini membutuhkan library monolog/monolog dengan versi berapa saja di jalur 2.0, atau dengan kata lain versi yang lebih besar atau sama dengan 2.0 tapi kurang dari 2.1.

Perintah-Perintah Utama Composer

Berikut perintah-perintah Composer yang paling sering dipakai sehari-hari, lengkap dengan fungsinya masing-masing.

composer init

Dipakai untuk membuat file composer.json baru secara interaktif. Composer akan menanyakan nama package, deskripsi, author, dan sebagainya lewat serangkaian pertanyaan di terminal.

composer init

composer require

Perintah ini menambahkan library baru ke composer.json, lalu langsung mengunduh dan memasangnya. Kalau kamu tidak menuliskan versi tertentu, Composer akan otomatis memilih versi stabil terbaru yang sesuai.

composer require nesbot/carbon

Perintah di atas akan menambahkan library nesbot/carbon (library untuk mengolah tanggal-waktu di PHP) ke project. Kamu juga bisa menentukan versi spesifik, misalnya composer require nesbot/carbon:^2.0.

composer install

Perintah ini membaca composer.json (atau composer.lock jika ada) lalu memasang semua library yang tercantum di dalamnya ke folder vendor. Perintah ini yang paling sering dijalankan ketika kamu baru saja meng-clone sebuah project dari Git.

composer install
Kalau file composer.lock sudah ada di project, composer install akan memasang versi persis yang tercatat di file tersebut, bukan versi terbaru yang mungkin sudah rilis. Ini disengaja demi konsistensi antar-developer.

composer update

Berbeda dengan install, perintah update akan mencari versi terbaru dari setiap library sesuai batasan di composer.json, lalu memperbarui composer.lock dengan versi-versi baru tersebut.

composer update

Kamu juga bisa meng-update satu library saja tanpa menyentuh yang lain:

composer update nesbot/carbon

composer remove

Menghapus sebuah library dari composer.json sekaligus menghapus file-filenya dari folder vendor.

composer remove nesbot/carbon

composer dump-autoload

Composer punya sistem autoload yang membuat kelas-kelas PHP bisa langsung dipakai tanpa perlu di-require manual satu per satu. Kalau kamu menambah class baru dan autoload-nya belum ter-generate ulang (misalnya karena memakai classmap), jalankan perintah ini untuk memperbarui file vendor/autoload.php tanpa perlu menjalankan install atau update penuh.

composer dump-autoload
Tambahkan opsi -o (composer dump-autoload -o) saat project akan dipakai di server produksi. Opsi ini mengubah autoloader menjadi format classmap yang lebih cepat dibaca PHP, dengan trade-off waktu generate yang sedikit lebih lama.

composer create-project

Dipakai untuk membuat project baru dari sebuah package yang sudah ada, misalnya membuat instalasi Laravel baru dari nol. Perintah ini setara dengan meng-clone repository package tersebut lalu langsung menjalankan composer install di dalamnya.

composer create-project laravel/laravel nama-project

Perintah Bantu Lainnya

Beberapa perintah lain yang juga berguna untuk dikenal:

  • composer show — menampilkan daftar semua library yang terpasang di project.
  • composer outdated — menampilkan library mana saja yang punya versi lebih baru tersedia.
  • composer validate — memeriksa apakah composer.json valid, sebaiknya dijalankan sebelum melakukan commit.
  • composer self-update — memperbarui Composer itu sendiri ke versi terbaru.
  • composer diagnose — menjalankan pengecekan otomatis untuk masalah-masalah umum pada instalasi Composer.

Contoh Kasus Penggunaan

Membuat Project Laravel Baru

Skenario paling umum bagi pemula: ingin mulai belajar Laravel dari komputer yang baru saja dipasangi Composer. Buka Command Prompt, arahkan ke folder tempat project ingin dibuat (misalnya D:\Project), lalu jalankan:

composer create-project laravel/laravel blog-saya

Composer akan mengunduh framework Laravel beserta seluruh dependency-nya ke dalam folder baru bernama blog-saya. Setelah proses selesai, project sudah siap dijalankan dengan php artisan serve dari dalam folder tersebut.

Menambahkan Library ke Project yang Sudah Ada

Misalnya kamu sedang mengerjakan project dan butuh library untuk membuat file Excel, seperti phpoffice/phpspreadsheet. Di dalam folder project (yang sudah punya composer.json), jalankan:

composer require phpoffice/phpspreadsheet

Composer otomatis menambahkan baris library tersebut ke composer.json, mengunduh filenya ke vendor/phpoffice/phpspreadsheet, dan memperbarui composer.lock. Kamu langsung bisa memakai class-nya di kode PHP setelah memuat vendor/autoload.php.

Memperbarui Dependency Setelah Pull dari Git

Skenario umum berikutnya: kamu bekerja dalam tim, lalu rekan kerja menambahkan library baru dan meng-commit perubahan pada composer.json serta composer.lock ke Git. Setelah kamu melakukan git pull, folder vendor di komputermu belum berisi library baru tersebut. Cukup jalankan:

composer install

Karena composer.lock sudah ikut ter-pull, Composer akan memasang versi library yang persis sama dengan yang dipakai rekan kerjamu — bukan composer update, karena tujuannya menyamakan versi, bukan mencari versi terbaru.

Masalah Umum Saat Install

"composer" bukan perintah yang dikenali — biasanya terjadi karena terminal belum ditutup-buka ulang setelah instalasi selesai, atau PATH belum ter-set dengan benar. Coba restart Command Prompt, atau bahkan restart komputer jika masih bermasalah.
Installer tidak menemukan php.exe — pastikan PHP sudah benar-benar terpasang dan diarahkan manual ke lokasi php.exe saat proses instalasi Composer berlangsung.
Tekan Ctrl + C di Command Prompt jika proses composer install atau composer update terasa macet terlalu lama dan ingin dibatalkan, lalu coba jalankan ulang — biasanya masalah koneksi ke Packagist.org yang lambat.

Referensi

Related Posts

Memuat…

Posting Komentar