Overview
Masalah yang diselesaikan. Dependency adalah sumber masalah yang diam-diam: aplikasi tiba-tiba rusak setelah composer update, versi paket berbeda antara laptop dan server, celah keamanan di paket lama yang tak terpantau, atau node_modules yang membengkak dan korup. Banyak tim memakai composer update dan npm install secara serampangan karena tidak memahami perbedaannya.
Hasil akhir: Anda memahami peran composer.json, composer.lock, package.json, dan package-lock.json. Anda tahu perintah yang tepat untuk tiap situasi (pasang, tambah, perbarui, hapus, audit), cara membaca version constraint, serta alur yang aman untuk lokal, CI, dan production.
Prerequisites
Komponen | Kebutuhan |
|---|---|
PHP | 8.3+ (Laravel 13) atau 8.2+ (Laravel 12) |
Composer | 2.x |
Node.js | LTS terbaru (22 atau lebih baru) |
npm | Terpasang bersama Node.js |
Git | Untuk melacak berkas |
php -v
composer -V
node -v
npm -v
Step-by-Step Tutorial
1. Dua Dunia Dependency
PHP (Composer) | JavaScript (npm) | |
|---|---|---|
Berkas deklarasi |
|
|
Berkas kunci versi |
|
|
Folder paket |
|
|
Registri | Packagist | npm registry |
Dipakai untuk | Framework, library PHP, Artisan | Vite, Tailwind/Bootstrap, JS |
Aturan yang berlaku di keduanya:
Berkas | Commit ke Git? |
|---|---|
| Ya |
| Ya (menjamin versi sama di semua mesin) |
| Tidak (dibuat ulang dari berkas lock) |
2. Memahami Version Constraint
Di composer.json:
"require": {
"php": "^8.3",
"laravel/framework": "^13.0",
"laravel/tinker": "^2.10"
},
"require-dev": {
"fakerphp/faker": "^1.23",
"laravel/pint": "^1.13",
"phpunit/phpunit": "^11.0"
}
Penulisan | Artinya | Contoh |
|---|---|---|
|
| 1.2.3 sampai 1.99.x |
|
| Hanya perbaikan patch |
| Semua patch 1.2 | 1.2.0 sampai 1.2.x |
| Versi persis | Hanya 1.2.3 |
| Versi apa pun | Hindari |
| Cabang pengembangan | Hindari di production |
Untuk ^0.x, tanda ^ lebih ketat: ^0.3.2 berarti >=0.3.2 <0.4.0.
require vs require-dev: paket yang hanya dipakai saat pengembangan (test, linter, debugbar) masuk require-dev agar tidak ikut terpasang di production.
3. Perbedaan Penting: install vs update
Ini kesalahan paling umum.
Perintah | Membaca | Menulis lock? | Kapan |
|---|---|---|---|
|
| Tidak | Setelah clone, di CI, di server (versi persis sama) |
|
| Ya | Sengaja ingin memperbarui versi |
|
| Ya | Menambah paket baru |
Alur yang benar:
# mesin developer baru, CI, atau server
composer install
# memperbarui secara sadar
composer update # semua paket (hati-hati)
composer update vendor/paket # hanya satu paket (disarankan)
Hasil composer update harus diperiksa (lihat perubahan composer.lock), dijalankan test, lalu di-commit.
4. Perintah Composer yang Sering Dipakai
# tambah paket
composer require spatie/laravel-permission
composer require barryvdh/laravel-debugbar --dev
# hapus paket
composer remove spatie/laravel-permission
# lihat paket terpasang dan informasi
composer show
composer show laravel/framework
composer show --tree
# cek yang usang
composer outdated
composer outdated --direct
# kenapa paket ini terpasang / tidak bisa naik versi
composer why vendor/paket
composer why-not laravel/framework 13.0
# validasi dan autoload
composer validate
composer dump-autoload -o
# audit keamanan
composer audit
Contoh keluaran composer outdated --direct:
Legend:
! patch or minor release available - update recommended
~ major release available - update possible
Direct dependencies required in composer.json:
Package Version Latest Description
laravel/framework v13.2.0 v13.5.1 The Laravel Framework.
spatie/laravel-permission 6.9.0 ~ 7.0.0 Permission handling for Laravel
Memperbarui satu paket secara terkendali:
composer update laravel/framework --with-dependencies
composer update spatie/laravel-permission --dry-run
Opsi --dry-run menampilkan apa yang akan berubah tanpa mengubah apa pun.
5. Production: Pasang Tanpa Paket Dev
composer install --no-dev --optimize-autoloader --no-interaction
Opsi | Fungsi |
|---|---|
| Lewati |
| Autoload lebih cepat |
| Cocok untuk skrip otomatis |
6. Menyamakan Versi PHP lewat platform
Jika PHP di server berbeda dari lokal, Composer bisa memilih versi paket yang tidak jalan di server. Kunci platform:
"config": {
"platform": {
"php": "8.3.0"
},
"sort-packages": true,
"optimize-autoloader": true
}
Dengan ini, Composer memilih versi paket yang kompatibel dengan PHP 8.3.0, apa pun versi PHP lokal Anda.
7. Dasar-Dasar npm
# pasang semua dari package.json (+ buat/perbarui lock bila perlu)
npm install
# pasang persis sesuai lock (CI/production) - hapus node_modules lebih dulu
npm ci
# tambah paket
npm install alpinejs
npm install --save-dev sass
# hapus paket
npm uninstall alpinejs
# lihat yang usang dan celah keamanan
npm outdated
npm audit
|
| |
|---|---|---|
Memakai lock | Ya, bisa memperbarui lock | Ya, harus cocok (gagal jika tidak) |
Menghapus | Tidak | Ya |
Kecepatan | Lebih lambat | Lebih cepat |
Dipakai di | Lokal | CI dan deploy |
dependencies vs devDependencies di package.json: untuk proyek Laravel, alat build (Vite, Tailwind, Sass) umumnya masuk devDependencies, karena hasil build-lah yang dipakai di production.
"devDependencies": {
"@tailwindcss/vite": "^4.0.0",
"laravel-vite-plugin": "^2.0.0",
"vite": "^7.0.0"
}
Versi di atas hanya ilustrasi. Gunakan angka dari skeleton proyek Anda.
8. Audit Keamanan Rutin
composer audit
npm audit
Found 1 security vulnerability advisory affecting 1 package:
+-------------------+----------------------------------------------+
| Package | league/commonmark |
| CVE | CVE-XXXX-XXXXX |
| Title | Contoh judul advisory |
| Affected versions | <2.x.x |
+-------------------+----------------------------------------------+
Perbaikan:
composer update league/commonmark --with-dependencies
npm audit fix # perbaikan aman (tanpa breaking change)
Hati-hati dengan npm audit fix --force: perintah ini bisa menaikkan versi mayor dan merusak build. Gunakan hanya dengan sadar dan uji sesudahnya.
9. Alur Kerja yang Disarankan
Menambah paket:
git checkout -b chore/tambah-spatie-permission
composer require spatie/laravel-permission
php artisan test
git add composer.json composer.lock
git commit -m "chore: tambah spatie/laravel-permission"
Pembaruan rutin (misalnya tiap bulan):
git checkout -b chore/update-dependencies
composer outdated --direct
composer update --with-all-dependencies
npm outdated
npm update
php artisan test
npm run build
composer audit; npm audit
Jika ada yang rusak, kembali ke versi lama dengan git checkout composer.lock lalu composer install.
Pipeline CI:
- uses: shivammathur/setup-php@v2
with:
php-version: '8.3'
tools: composer:v2
- run: composer install --no-interaction --prefer-dist
- run: composer audit
- uses: actions/setup-node@v4
with: { node-version: 22, cache: npm }
- run: npm ci
- run: npm run build
10. Menyiapkan Proyek Setelah git clone
git clone git@github.com:username/toko.git
cd toko
composer install
copy .env.example .env
php artisan key:generate
npm ci
npm run build # atau npm run dev
php artisan migrate
11. Memilih Paket dengan Bijak
Sebelum memasang paket, periksa:
Pertanyaan | Mengapa penting |
|---|---|
Kapan rilis terakhir? | Paket yang ditinggalkan = risiko keamanan |
Mendukung versi Laravel dan PHP Anda? | Cek |
Berapa pengunduhnya, dan siapa pembuatnya? | Indikator keandalan |
Apakah ada isu keamanan terbuka? | Cek halaman GitHub |
Lisensinya? | Penting untuk proyek komersial |
Apakah benar-benar dibutuhkan? | Setiap paket menambah permukaan serangan dan beban pemeliharaan |
Waspadai typosquatting: paket dengan nama mirip paket populer. Periksa nama vendor dengan teliti sebelum composer require.
Troubleshooting
Gejala | Penyebab | Solusi |
|---|---|---|
|
|
|
| Konflik versi antar paket, atau PHP tidak cocok | Baca pesan, jalankan |
| PHP lokal lebih rendah dari syarat paket | Naikkan PHP, atau pilih versi paket lebih lama |
| Ekstensi | Aktifkan |
| Memori PHP kecil |
|
| Sertifikat CA tidak terpasang | Perbarui |
| Autoload belum diperbarui |
|
| Versi Composer berbeda antar developer, atau | Samakan versi Composer, gunakan |
Paket baru tak muncul di server | Server belum menjalankan | Tambahkan ke langkah deploy |
| Kebijakan eksekusi PowerShell |
|
| Konflik peer dependency | Baca pesan; perbarui paket terkait. |
|
| Jalankan |
| Instalasi terputus atau lintas OS | Hapus |
Build berhasil di lokal, gagal di server | Versi Node.js berbeda | Samakan versi ( |
| Antivirus atau proses lain mengunci berkas | Tutup dev server, kecualikan folder dari antivirus |
Perintah bantu diagnosis:
composer diagnose
composer clear-cache
composer why-not laravel/framework 13.0
npm cache verify
Best Practices
Keamanan
Jalankan
composer auditdannpm auditsecara rutin dan di CI.Commit
composer.lockdanpackage-lock.jsonagar semua lingkungan memakai versi yang sama dan teruji.Di production, pasang dengan
--no-dev.Jangan memasang paket dari sumber tak jelas. Periksa pembuat dan riwayat paket.
Pada skrip CI, gunakan
npm ci, bukannpm install, agar versi tidak bergeser.Hindari
composer.jsonyang mengizinkandev-*atau*untuk paket produksi.
Performa
composer install --no-dev --optimize-autoloaderdi production.Hapus paket yang tidak dipakai (
composer remove), karena menambah waktu autoload dan permukaan serangan.Cache dependency di CI (
cache: npm, cache Composer) untuk mempercepat pipeline.
Maintainability
Perbarui dependency sedikit demi sedikit dan sering, bukan menumpuk bertahun-tahun lalu memperbarui sekaligus.
Gunakan
composer update vendor/paketuntuk perubahan terarah, bukancomposer updatebuta.Satu perubahan dependency per commit atau PR, dengan test lulus.
Tulis versi PHP dan Node.js yang dibutuhkan di
README.md,composer.json(require.php), danpackage.json(engines).Gunakan
config.platform.phpbila versi PHP lokal berbeda dari server.Pantau pembaruan otomatis dengan Dependabot atau Renovate.
Related Articles
Laravel dengan Vite: Setup Tailwind CSS, Bootstrap, dan Asset Frontend
Panduan Lengkap Instalasi Laravel di Windows Menggunakan Laragon
Last Tested
Catatan jujur: disusun dari dokumentasi resmi Composer dan npm. Keluaran contoh bersifat ilustrasi, dan belum dijalankan ulang oleh penulis. Nomor versi paket pada contoh hanya contoh. Verifikasi dengan
composer outdateddannpm outdateddi proyek Anda.
Komponen | Versi acuan penulisan | Versi saat Anda menguji |
|---|---|---|
PHP | 8.3.x | |
Composer | 2.x | |
Node.js | 22 LTS | |
npm | 10.x | |
Laravel | 13.x (kompatibel dengan 12.x) | |
Tanggal uji |