Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Umum / Cara Mengelola Dependency Lara...
Umum

Cara Mengelola Dependency Laravel Menggunakan Composer dan NPM dengan Benar

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
4 min read
20 views

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.json dan, 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.

Bagikan artikel:

Artikel lainnya

Cari Artikel