Laravel Artisan adalah antarmuka baris perintah (Command Line Interface) bawaan yang disertakan dengan framework Laravel. Artisan menyediakan sejumlah perintah membantu dalam membangun dan mengelola aplikasi web berbasis Laravel, mulai dari manajemen database, pembuatan file boilerplate, hingga pengelolaan cache dan konfigurasi sistem.
Melalui terminal atau command prompt, pengembang dapat menjalankan skrip otomatisasi tanpa harus membuat file PHP terpisah secara manual. Seluruh perintah dasar diakses dengan memanggil file pengendali artisan yang terletak di direktori root proyek Laravel.
Cara Menggunakan Laravel Artisan CLI
Untuk menjalankan perintah Artisan, buka terminal pada direktori utama proyek Laravel Anda, lalu ketikkan perintah dengan format dasar:
php artisan [nama-perintah] [opsi/argumen]Jika Anda ingin melihat seluruh daftar perintah yang tersedia beserta deskripsi singkatnya, jalankan perintah berikut di terminal:
php artisan listSedangkan untuk melihat panduan penggunaan mendetail dari suatu perintah tertentu (misalnya perintah untuk membuat migrasi database), gunakan opsi help:
php artisan help make:migrationTabel Daftar Perintah Penting Laravel Artisan
Berikut adalah tabel komparasi perintah Artisan yang paling sering digunakan sehari-hari oleh pengembang Laravel:
| Kategori | Perintah Artisan | Fungsi Utama |
|---|---|---|
| Aplikasi | php artisan serve | Menjalankan server pengembangan lokal berbasis PHP. |
| Aplikasi | php artisan down | Menempatkan aplikasi ke mode pemeliharaan (maintenance mode). |
| Aplikasi | php artisan up | Mengembalikan aplikasi dari mode pemeliharaan ke mode normal. |
| Database | php artisan migrate | Menjalankan migrasi database yang belum dieksekusi. |
| Database | php artisan migrate:rollback | Membatalkan sekumpulan migrasi database terakhir. |
| Database | php artisan db:seed | Mengisi database dengan data dummy atau awal menggunakan seeder. |
| Make / Generator | php artisan make:model NamaModel | Membuat file Model Eloquent baru. |
| Make / Generator | php artisan make:controller NamaController | Membuat file Controller baru. |
| Make / Generator | php artisan make:migration create_tabel | Membuat file migrasi database baru. |
| Cache | php artisan cache:clear | Membersihkan seluruh cache aplikasi. |
| Cache | php artisan config:cache | Membuat file cache konfigurasi untuk optimasi performa produksi. |
| Route | php artisan route:list | Menampilkan seluruh daftar rute (routes) yang terdaftar dalam aplikasi. |
Membuat Perintah Artisan Kustom
Laravel memungkinkan pengembang untuk membuat perintah Artisan sendiri sesuai kebutuhan spesifik aplikasi. Pembuatan perintah kustom dapat dilakukan melalui perintah generator bawaan:
php artisan make:command KirimEmailPenggunaPerintah di atas akan menghasilkan file baru di direktori app/Console/Commands/KirimEmailPengguna.php. Di dalam file tersebut, Anda dapat mendefinisikan nama signature perintah serta logika pemrograman yang akan dieksekusi ketika perintah dipanggil melalui terminal.
Tips Troubleshooting Artisan
Ketika menghadapi kendala saat menjalankan perintah Artisan, berikut beberapa langkah pengecekan cepat yang dapat dilakukan:
- Pastikan versi PHP yang terinstal di komputer sesuai dengan batasan versi yang disyaratkan oleh versi Laravel yang digunakan.
- Jika terjadi perubahan pada konfigurasi atau file kelas, jalankan
php artisan optimize:clearuntuk membersihkan cache lama yang mungkin masih tersimpan. - Periksa hak akses (permissions) pada folder
storagedanbootstrap/cacheagar proses penulisan log dan cache berjalan lancar.