Kegagalan menjalankan source code sering bukan karena kodenya, melainkan karena lingkungan pengembangan belum lengkap. Tiga komponen wajib untuk hampir semua aplikasi Laravel adalah PHP, Composer, dan sebuah database (umumnya MySQL/MariaDB). Mari siapkan ketiganya dengan rapi.
Cara Tercepat: Paket All-in-One
Bagi pemula, memasang paket siap pakai jauh lebih hemat waktu daripada memasang komponen satu per satu:
- Windows: Laragon (ringan, sudah termasuk PHP, MySQL, Apache/Nginx, dan Composer).
- macOS: Laravel Herd atau Homebrew.
- Lintas platform: XAMPP untuk PHP + MySQL, lalu pasang Composer terpisah.
Jika memakai paket ini, Anda bisa melompat ke bagian verifikasi di bawah.
Memasang PHP
Laravel versi modern umumnya butuh PHP 8.1 ke atas beserta beberapa ekstensi. Setelah PHP terpasang, verifikasi:
php -v
php -m
Perintah pertama menampilkan versi, perintah kedua menampilkan daftar ekstensi aktif. Pastikan ekstensi berikut ada: mbstring, openssl, pdo_mysql, tokenizer, xml, ctype, json, dan bcmath. Bila ada yang hilang, aktifkan di file php.ini dengan menghapus tanda titik koma di depan barisnya.
Memasang Composer
Composer adalah manajer paket PHP. Ia yang mengunduh Laravel dan seluruh library ke folder vendor/. Setelah dipasang dari getcomposer.org, verifikasi:
composer --version
Jika perintah tidak dikenali, berarti Composer belum masuk PATH sistem. Pada Windows, installer resmi biasanya mengurus ini otomatis; jika tidak, tambahkan lokasi composer.phar ke variabel PATH.
Memasang MySQL / MariaDB
Database menyimpan data aplikasi. MySQL dan MariaDB dapat dipertukarkan untuk sebagian besar kasus. Melalui phpMyAdmin (bawaan Laragon/XAMPP) Anda bisa membuat database baru dengan beberapa klik. Untuk membuat database lewat baris perintah:
mysql -u root -p
CREATE DATABASE aplikasi_saya CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Gunakan utf8mb4 agar emoji dan karakter khusus tersimpan dengan benar.
Verifikasi Semuanya Bekerja Bersama
Uji cepat: buat project Laravel percobaan.
composer create-project laravel/laravel coba-env
cd coba-env
php artisan serve
Bila halaman sambutan Laravel muncul di http://127.0.0.1:8000, berarti PHP dan Composer sehat. Selanjutnya isi konfigurasi database di .env lalu jalankan php artisan migrate; bila tabel terbuat tanpa error, koneksi database Anda juga siap.
Alat Pendukung yang Layak Dipasang
- Node.js + npm untuk membangun aset front-end (Vite/Tailwind).
- Git untuk melacak perubahan kode.
- VS Code dengan ekstensi PHP Intelephense dan Laravel.
Setelah lingkungan ini beres sekali, semua project Laravel berikutnya akan jauh lebih mudah dijalankan.