Overview
Composer mengelola dependency PHP, sedangkan NPM mengelola dependency JavaScript dan tool frontend. Mengabaikan lockfile atau memperbarui semua package tanpa pemeriksaan dapat menyebabkan konflik, build gagal, dan perbedaan perilaku antara lokal dengan production. Artikel ini menjelaskan manifest, lockfile, instalasi, update, audit, serta cara memulihkan dependency secara terkendali.
Prinsip utama pengelolaan dependency adalah reproducibility: developer dan pipeline deployment sebaiknya memasang versi dependency yang telah disepakati, bukan mendapatkan versi berbeda setiap kali aplikasi dipasang.
Prerequisites
- PHP sesuai requirement proyek.
- Composer 2.x.
- Node.js dan NPM yang kompatibel.
- Proyek Laravel dengan
composer.jsondan, bila menggunakan Vite,package.json. - Git untuk meninjau perubahan manifest dan lockfile.
Step-by-step tutorial
1. Pahami manifest dan lockfile
| PHP / Composer | Frontend / NPM |
|---|---|
composer.json |
package.json |
composer.lock |
package-lock.json |
vendor/ |
node_modules/ |
composer install |
npm install atau npm ci |
Manifest menjelaskan dependency dan batas versinya. Lockfile mencatat versi hasil resolusi sehingga instalasi lebih konsisten. Pada aplikasi, lockfile umumnya perlu disimpan di Git, sementara direktori dependency biasanya tidak perlu di-commit.
2. Instal dependency yang terkunci
composer install
npm install
Dalam CI yang menggunakan package-lock.json, npm ci sering lebih sesuai karena memasang dependency berdasarkan lockfile dan gagal bila manifest tidak cocok dengan lockfile:
npm ci
Pilih command sesuai kondisi proyek. Jangan menghapus lockfile hanya untuk menghilangkan error tanpa memahami penyebabnya.
3. Tambahkan package PHP
composer require vendor/package
composer require --dev vendor/testing-package
Nama vendor/package adalah placeholder. Ganti dengan package nyata setelah memeriksa reputasi, kompatibilitas Laravel/PHP, lisensi, aktivitas pemeliharaan, dan kebutuhan proyek. Gunakan --dev untuk dependency yang hanya dibutuhkan saat development atau testing.
4. Tambahkan package frontend
npm install nama-package
npm install --save-dev nama-tool
Perintah kedua digunakan untuk tool yang hanya dibutuhkan selama development/build. Periksa dokumentasi package mengenai cara import, peer dependency, kompatibilitas, dan dampak terhadap ukuran bundle.
5. Periksa dependency dan audit
composer validate
composer outdated
composer audit
npm audit
Ketersediaan opsi dan detail output dapat berbeda menurut versi tool. Audit tidak berarti semua temuan aman diperbaiki otomatis. Baca advisory, versi perbaikan, dampak kompatibilitas, dan kemungkinan mitigasi sebelum mengubah dependency.
6. Update secara terkontrol
Buat branch khusus untuk perubahan dependency. Command berikut dapat memperbarui banyak package dalam batas constraint yang ada:
composer update
npm update
Untuk mengurangi risiko, pertimbangkan memperbarui package tertentu terlebih dahulu. Tinjau composer.lock dan package-lock.json, baca changelog, lalu jalankan test dan build.
7. Jalankan test dan build
php artisan test
npm run build
Jalankan juga lint atau static analysis jika tersedia. Tinjau git diff untuk memastikan perubahan hanya menyentuh dependency dan file yang diharapkan.
8. Pulihkan instalasi
Jika instalasi bermasalah, baca pesan error sebelum menghapus folder dependency. Pasang ulang berdasarkan lockfile:
composer install
npm ci
Jika npm ci gagal karena manifest tidak cocok dengan lockfile, perbaiki dependency secara sengaja, tinjau perubahan lockfile, dan commit kedua file terkait.
Troubleshooting
- Composer dependency conflict: periksa versi PHP, constraint, ekstensi, dan requirement package.
Your requirements could not be resolved: identifikasi package yang bertentangan, jangan menghapus constraint secara membabi buta.- NPM peer dependency conflict: periksa kompatibilitas package dan framework; hindari memaksa instalasi sebagai solusi permanen.
- Build berbeda di CI: samakan versi Node.js dan gunakan lockfile.
- Package tidak tersedia di production: periksa apakah package diletakkan sebagai dependency development padahal dibutuhkan saat runtime.
- Security audit menemukan advisory: evaluasi risiko, versi perbaikan, dan dampak upgrade.
Best practices
Commit composer.lock dan package-lock.json untuk aplikasi. Gunakan composer install pada deployment, bukan composer update tanpa kontrol. Lakukan update melalui branch, tinjau changelog, jalankan test/build, dan hindari package yang tidak terpelihara. Jangan menonaktifkan pemeriksaan keamanan hanya untuk membuat build berhasil.
Related articles
Last tested
Tanggal penyusunan: 19 Oktober 2026. Command merupakan workflow umum Composer/NPM dan belum dijalankan terhadap manifest proyek tertentu. Periksa versi tool dan script proyek sebelum digunakan.