Composer PHP: Cara Install Package dan Autoload Class

Composer adalah package manager untuk PHP. Jalankan composer require vendor/package di folder proyekmu: Composer mengunduh library itu ke vendor/, mencatatnya di composer.json, lalu kamu memuatnya, bersama semua yang sudah kamu instal, dengan satu baris, require __DIR__ . '/vendor/autoload.php';.

composer require monolog/monolog

<?php
require __DIR__ . '/vendor/autoload.php';

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Level;

$log = new Logger('app');
$log->pushHandler(new StreamHandler(__DIR__ . '/app.log', Level::Warning));
$log->warning('Disk almost full', ['free' => '2%']);

Tidak perlu include untuk setiap file: autoloader memuat Logger, StreamHandler, dan semua yang mereka pakai saat setiap class pertama kali dibutuhkan. Package diambil dari Packagist, registry publik yang dicari Composer secara bawaan.

Menginstal Composer

Composer butuh PHP di komputermu lebih dulu (lihat menginstal PHP).

Windows: unduh dan jalankan Composer-Setup.exe dari getcomposer.org. Installer ini menemukan php.exe milikmu dan menambahkan composer ke PATH. Setelah itu, buka terminal baru.

macOS dengan Homebrew:

brew install composer

Linux: paket dari distribusimu (sudo apt install composer di Debian dan Ubuntu) bisa dipakai, tetapi sering kali versinya lebih lama. Installer resmi memberikan versi terbaru:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Halaman unduhan di getcomposer.org juga menampilkan satu baris yang memeriksa hash installer sebelum menjalankannya; salin perintahnya dari sana untuk mendapatkan hash terbaru. Lalu periksa apakah Composer sudah bekerja:

composer --version

composer.json dan composer.lock

composer init menanyakan beberapa hal lalu menulis composer.json, atau composer require membuatnya saat package pertama ditambahkan. Contoh yang umum:

{
    "name": "acme/shop",
    "require": {
        "php": ">=8.2",
        "monolog/monolog": "^3.0",
        "vlucas/phpdotenv": "^5.6"
    },
    "require-dev": {
        "phpunit/phpunit": "^11.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

• require berisi apa saja yang dibutuhkan proyek untuk berjalan, termasuk versi PHP.
• require-dev berisi alat khusus untuk development (test, analisis statis). composer require --dev phpunit/phpunit menambah isinya, dan composer install --no-dev melewatinya di server production.
• autoload memberi tahu Composer di mana class milikmu sendiri berada (lihat di bawah).

Di sebelahnya, Composer menulis composer.lock berisi versi persis dari setiap package yang diinstal, termasuk package yang dibutuhkan oleh package-package milikmu. Commit kedua file itu. Jangan commit vendor/: tambahkan ke .gitignore, karena composer install membangunnya ulang dari file lock.

composer install vs composer update

composer install          # install exactly what composer.lock says
composer update           # pick the newest allowed versions, rewrite composer.lock
composer update monolog/monolog   # update one package only
composer remove monolog/monolog   # uninstall and remove from composer.json
composer outdated         # list packages with newer versions available

Jalankan composer install setelah clone proyek dan di setiap deploy: semua orang mendapatkan versi yang sama dengan yang sudah diuji. Jalankan composer update hanya saat kamu berniat upgrade, lalu uji dan commit composer.lock yang baru. Menjalankan update di server production akan menginstal versi yang belum diuji siapa pun.

Batasan versi: ^ dan ~

composer require vendor/package tanpa versi akan memilih rilis stabil terbaru dan menulis batasan ^ untuknya, dan biasanya itulah yang kamu mau.

Autoload class milikmu sendiri dengan PSR-4

PSR-4 adalah konvensi yang memetakan namespace ke sebuah folder: dengan "App\\": "src/", class App\Text\Slug berada di src/Text/Slug.php. Setelah menambahkan bagian autoload, jalankan:

composer dump-autoload

Autoloader Composer adalah fungsi yang didaftarkan dengan spl_autoload_register(), yang dipanggil PHP setiap kali kode memakai class yang belum dimuat. Blok ini menulis dua file class dan mendaftarkan autoloader PSR-4 kecil buatannya sendiri, jadi kamu bisa melihat pemetaannya bekerja. Tambahkan file class ketiga lalu pakai.

<?php
// Two class files, laid out the PSR-4 way
is_dir('src/Text') || mkdir('src/Text', 0777, true);

file_put_contents('src/Greeter.php', <<<'PHP'
<?php
namespace App;

class Greeter
{
    public function hello(string $name): string
    {
        return "Hello, $name";
    }
}
PHP);

file_put_contents('src/Text/Slug.php', <<<'PHP'
<?php
namespace App\Text;

class Slug
{
    public static function from(string $title): string
    {
        return trim(preg_replace('/[^a-z0-9]+/', '-', strtolower($title)), '-');
    }
}
PHP);

// What vendor/autoload.php does for "App\\": "src/"
spl_autoload_register(function (string $class): void {
    $prefix = 'App\\';
    if (!str_starts_with($class, $prefix)) {
        return;
    }
    $file = __DIR__ . '/src/' . str_replace('\\', '/', substr($class, strlen($prefix))) . '.php';
    echo "autoload: $class => ", substr($file, strlen(__DIR__) + 1), "\n";
    if (is_file($file)) {
        require $file;
    }
});

echo (new App\Greeter())->hello('Ada'), "\n";
echo App\Text\Slug::from('Composer & PSR-4, Explained'), "\n";
echo App\Text\Slug::from('Loaded once, used twice'), "\n";

Autoloader berjalan sekali untuk setiap class: panggilan Slug::from() yang kedua tidak mencetak baris autoload:, karena class-nya sudah dimuat. Di proyek sungguhan, kamu tidak pernah menulis fungsi ini sendiri; vendor/autoload.php mendaftarkan versi milik Composer, yang juga menangani package di vendor/. Namespace dibahas di halaman namespace.

Error yang sering muncul

• Class "Monolog\Logger" not found. Script tidak menjalankan require 'vendor/autoload.php', atau path-nya salah. Pakai __DIR__ . '/vendor/autoload.php' supaya path-nya tidak bergantung pada direktori saat ini.
• Class milikmu sendiri tidak ditemukan setelah ditambahkan ke autoload. Jalankan composer dump-autoload, lalu periksa bahwa path file-nya cocok persis dengan namespace-nya, termasuk huruf besar dan kecil: App\Text\Slug harus berada di src/Text/Slug.php, dan server Linux menganggap src/text/slug.php sebagai file yang berbeda.
• Your requirements could not be resolved to an installable set of packages. Dua package butuh versi yang tidak cocok dari sesuatu, sering kali PHP itu sendiri. Pesannya menyebutkan konfliknya; composer why-not vendor/package 2.0 menjelaskan apa yang menghalangi sebuah versi.
• composer tidak dikenali. Terminal dibuka sebelum instalasi, atau folder-nya tidak ada di PATH. Buka terminal baru, atau panggil php composer.phar secara langsung.