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

Blog / Tooling / Cara Mengelola Dependency Lara...
Tooling

Cara Mengelola Dependency Laravel Menggunakan Composer dan NPM dengan Benar

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
8 min read
12 views

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 *.lock

php -v
composer -V
node -v
npm -v

Step-by-Step Tutorial

1. Dua Dunia Dependency

PHP (Composer)

JavaScript (npm)

Berkas deklarasi

composer.json

package.json

Berkas kunci versi

composer.lock

package-lock.json

Folder paket

vendor/

node_modules/

Registri

Packagist

npm registry

Dipakai untuk

Framework, library PHP, Artisan

Vite, Tailwind/Bootstrap, JS

Aturan yang berlaku di keduanya:

Berkas

Commit ke Git?

composer.json, package.json

Ya

composer.lock, package-lock.json

Ya (menjamin versi sama di semua mesin)

vendor/, node_modules/

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 ^13.0 mengizinkan

^1.2.3

>=1.2.3 <2.0.0 (kompatibel semantik)

1.2.3 sampai 1.99.x

~1.2.3

>=1.2.3 <1.3.0

Hanya perbaikan patch

1.2.*

Semua patch 1.2

1.2.0 sampai 1.2.x

1.2.3

Versi persis

Hanya 1.2.3

*

Versi apa pun

Hindari

dev-main

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

composer install

composer.lock

Tidak

Setelah clone, di CI, di server (versi persis sama)

composer update

composer.json

Ya

Sengaja ingin memperbarui versi

composer require x/y

composer.json

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

--no-dev

Lewati require-dev (lebih kecil, lebih aman)

--optimize-autoloader (-o)

Autoload lebih cepat

--no-interaction

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

npm install

npm ci

Memakai lock

Ya, bisa memperbarui lock

Ya, harus cocok (gagal jika tidak)

Menghapus node_modules dulu

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 require di halaman Packagist

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

Your lock file does not contain a compatible set of packages

composer.json diubah tanpa memperbarui lock

composer update (atau composer update vendor/paket), commit lock

Your requirements could not be resolved to an installable set of packages

Konflik versi antar paket, atau PHP tidak cocok

Baca pesan, jalankan composer why-not paket versi, sesuaikan constraint atau versi PHP

requires php ^8.3 ... your php version (8.2.x) does not satisfy

PHP lokal lebih rendah dari syarat paket

Naikkan PHP, atau pilih versi paket lebih lama

The zip extension and unzip/7z commands are both missing

Ekstensi zip mati

Aktifkan zip di PHP

Allowed memory size of ... exhausted saat Composer

Memori PHP kecil

php -d memory_limit=-1 vendor\bin\composer update, atau naikkan memory_limit

curl error 60: SSL certificate problem

Sertifikat CA tidak terpasang

Perbarui cacert.pem dan atur curl.cainfo / openssl.cafile di php.ini

Class "X" not found setelah menambah paket

Autoload belum diperbarui

composer dump-autoload

composer.lock selalu berubah di Git

Versi Composer berbeda antar developer, atau update tak sengaja

Samakan versi Composer, gunakan install, bukan update

Paket baru tak muncul di server

Server belum menjalankan composer install

Tambahkan ke langkah deploy

npm : ... running scripts is disabled on this system

Kebijakan eksekusi PowerShell

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, atau pakai CMD

npm ERR! ERESOLVE could not resolve

Konflik peer dependency

Baca pesan; perbarui paket terkait. --legacy-peer-deps hanya sebagai jalan keluar sementara

npm ci gagal: lock tidak sinkron

package.json diubah tanpa memperbarui lock

Jalankan npm install lokal, commit package-lock.json

node_modules korup / aneh

Instalasi terputus atau lintas OS

Hapus node_modules, lalu npm ci

Build berhasil di lokal, gagal di server

Versi Node.js berbeda

Samakan versi (.nvmrc atau engines)

EPERM, EBUSY saat npm di Windows

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 audit dan npm audit secara rutin dan di CI.

  • Commit composer.lock dan package-lock.json agar 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, bukan npm install, agar versi tidak bergeser.

  • Hindari composer.json yang mengizinkan dev-* atau * untuk paket produksi.

Performa

  • composer install --no-dev --optimize-autoloader di 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/paket untuk perubahan terarah, bukan composer update buta.

  • 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), dan package.json (engines).

  • Gunakan config.platform.php bila versi PHP lokal berbeda dari server.

  • Pantau pembaruan otomatis dengan Dependabot atau Renovate.

Related Articles

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 outdated dan npm outdated di 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

Bagikan artikel:

Artikel lainnya