Composer sendiri hanyalah satu berkas PHP berbentuk arsip .phar (PHP Archive) yang berisi seluruh kode programnya. Karena berbentuk berkas biasa, proses instalasinya sederhana: pastikan PHP CLI tersedia, unduh berkas composer.phar, lalu tempatkan berkas tersebut di lokasi yang mudah dipanggil. Pada chapter ini kita menjalankan ketiga langkah tersebut dengan installer resmi, membandingkannya dengan alternatif seperti Homebrew dan apt, lalu menutup dengan rutinitas pemeliharaan berupa self-update dan diagnose. Seluruh output terminal di chapter ini diambil dari sesi nyata sehingga Anda tahu persis apa yang harus muncul di layar.

Prasyarat: PHP di Baris Perintah #

Composer berjalan di atas PHP versi baris perintah (CLI), jadi pemeriksaan pertama kita adalah memastikan PHP dapat dipanggil dari terminal. Jalankan perintah berikut:

bash 
php -v

Output yang Dihasilkan:

text 
PHP 8.4.23 (cli) (built: Jul  7 2026 05:22:53) (NTS gcc 14.2.0)
Copyright (c) The PHP Group
Built by static-php-cli 2.8.6
Zend Engine v4.4.23, Copyright (c) Zend Technologies

Baris pertama menunjukkan versi PHP beserta tanggal build-nya; angka pada mesin Anda mungkin berbeda mengikuti versi yang terpasang. Composer versi 2.x membutuhkan PHP 7.2.5 atau lebih baru, sehingga instalasi PHP 8 mana pun aman dipakai. Jika perintah php tidak dikenal, instal PHP CLI terlebih dahulu melalui package manager sistem operasi Anda sebelum melanjutkan.

Mengunduh dan Menjalankan Installer Resmi #

Cara instalasi yang direkomendasikan situs resmi Composer adalah melalui installer: sebuah skrip PHP berukuran puluhan kilobyte yang memeriksa pengaturan PHP Anda, lalu mengunduh composer.phar versi terbaru. Kita unduh installer tersebut lalu jalankan dengan PHP:

bash 
curl -sS https://getcomposer.org/installer -o composer-setup.php
php composer-setup.php

Output yang Dihasilkan:

text 
All settings correct for using Composer
Downloading...

Composer (version 2.10.3) successfully installed to: /tmp/belajar-composer/composer.phar
Use it: php composer.phar

Mari kita baca output tersebut baris demi baris:

  1. All settings correct for using Composer: pemeriksaan environment lolos — versi PHP memadai dan ekstensi yang dibutuhkan tersedia.
  2. Downloading...: installer mengunduh berkas composer.phar dari server resmi getcomposer.org.
  3. successfully installed to: /tmp/belajar-composer/composer.phar: berkas phar tersimpan di folder tempat Anda menjalankan installer; lokasi pada mesin Anda menyesuaikan folder aktif terminal.
  4. Use it: php composer.phar: petunjuk cara menjalankan Composer yang baru terpasang.

Menjalankan composer.phar #

Berkas .phar adalah arsip yang berisi aplikasi PHP utuh dan dapat dieksekusi langsung oleh interpreter. Composer yang baru terpasang kita jalankan dengan menyertakan composer.phar sebagai argumen PHP:

bash 
php composer.phar --version

Output yang Dihasilkan:

text 
Composer version 2.10.3 2026-08-27 13:34:23

Angka 2.10.3 adalah versi Composer, sedangkan tanggal di belakangnya menandai waktu rilis versi tersebut — keduanya akan berbeda apabila Anda mengunduh rilis yang lebih baru. Selama berada di folder yang sama dengan composer.phar, seluruh perintah Composer pada chapter-chapter selanjutnya dapat dijalankan dengan pola php composer.phar <perintah>.

Memindahkan composer.phar ke PATH #

Mengetik php composer.phar ... dari satu folder saja tentu tidak praktis. Agar Composer dapat dipanggil cukup dengan kata composer dari folder mana pun, pindahkan berkas phar ke salah satu direktori yang terdaftar di PATH sistem, misalnya /usr/local/bin pada Linux dan macOS:

bash 
sudo mv composer.phar /usr/local/bin/composer
composer --version

Setelah perintah mv berhasil, perintah composer --version menghasilkan output yang sama dengan sesi sebelumnya. Pada Windows, installer grafis Composer-Setup.exe yang tersedia di halaman unduhan resmi menangani penempatan PATH secara otomatis, jadi langkah pemindahan manual di atas tidak diperlukan.

Alternatif: Package Manager Sistem #

Selain installer resmi, Composer juga tersedia melalui package manager sistem operasi. Pengguna macOS dan Linux dapat memakai Homebrew dengan brew install composer, sedangkan pengguna Debian dan Ubuntu dapat memakai sudo apt install composer. Dua jalur tersebut nyaman karena pembaruan ikut ditangani package manager.

Perlu dicatat satu kehati-hatian: versi Composer di repositori distro Linux sering kali tertinggal beberapa rilis dari versi terbaru. Karena Composer berkembang cukup cepat — baik dari sisi fitur resolver maupun dukungan keamanan — banyak pengembang tetap memilih installer resmi dan memakai self-update agar selalu berada di versi mutakhir. Jalur mana pun yang Anda pilih, perintah-perintah Composer yang dibahas di course ini bekerja dengan cara yang sama.

Memperbarui Composer #

Composer dapat memperbarui dirinya sendiri tanpa perlu mengunduh ulang installer. Perintah self-update mengganti berkas phar lama dengan rilis stabil terbaru:

bash 
composer self-update

Output yang Dihasilkan:

text 
You are already using the latest available Composer version 2.10.3 (stable channel).

Output di atas muncul karena versi 2.10.3 memang rilis stabil terbaru saat sesi dijalankan; apabila ada versi lebih baru, Composer akan mengunduh dan mengganti berkasnya lalu melaporkan versi baru yang terpasang. Biasakan menjalankan self-update secara berkala — misalnya sekali sebulan — karena pembaruan Composer juga membawa perbaikan resolusi dependensi dan pemeriksaan keamanan.

Memeriksa Kesehatan Instalasi #

Ketika Composer berperilaku aneh — unduhan gagal, autoloader tidak terbentuk, atau pesan error membingungkan — perintah diagnose memeriksa seluruh komponen yang dibutuhkan Composer satu per satu:

bash 
composer diagnose

Output yang Dihasilkan:

text 
Checking pubkeys: 
Tags Public Key Fingerprint: 57815BA2 7E54DC31 7ECC7CC5 573090D0  87719BA6 8F3BB723 4E5D42D0 84A14642
Dev Public Key Fingerprint: 4AC45767 E5EC2265 2F0C1167 CBBB8A2B  0C708369 153E328C AD90147D AFE50952
OK
Checking Composer version: OK
Composer version: 2.10.3
Checking Composer and its dependencies for vulnerabilities: OK
PHP version: 8.4.23
Checking platform settings: OK
Checking git settings: OK git version 2.47.3
Checking http connectivity to packagist: OK
Checking https connectivity to packagist: OK
Checking disk free space: OK

Setiap baris OK menandakan satu pemeriksaan yang lolos: kunci publik untuk verifikasi pembaruan, koneksi ke Packagist, pengaturan platform PHP, hingga ruang disk yang tersisa. Status WARNING atau FAILED pada baris tertentu menunjukkan titik masalah yang perlu dibereskan, biasanya berupa koneksi jaringan atau konfigurasi git.

Dengan Composer terpasang dan sehat, kita siap masuk ke inti penggunaannya: berkas deklarasi composer.json yang menjadi pusat kendali seluruh dependensi proyek — topik chapter berikutnya.

Referensi #