Overview
Artikel ini membahas cara menyiapkan lingkungan pengembangan Laravel di Windows menggunakan Laragon, membuat aplikasi pertama, lalu memverifikasi bahwa aplikasi berjalan. Tujuan akhirnya adalah memiliki fondasi development lokal yang konsisten sehingga proses membuat fitur, menjalankan test, dan melakukan debugging dapat dilakukan tanpa harus langsung menyewa server.
Laragon mempermudah pengelolaan web server, PHP, dan database lokal. Namun, instalasi yang berhasil bukan hanya soal menekan tombol Start: versi PHP CLI harus sesuai dengan kebutuhan Laravel, Composer harus dapat dijalankan, dan Node.js diperlukan apabila proyek menggunakan Vite untuk asset frontend.
Prerequisites
- Windows 10/11 64-bit.
- Laragon dengan PHP dan web server yang kompatibel.
- PHP 8.2 atau lebih baru sebagai baseline untuk Laravel 11/12; selalu cocokkan dengan requirement versi yang dipilih.
- Composer 2.x.
- Node.js versi LTS yang kompatibel dengan Vite dan package frontend.
- MySQL atau MariaDB jika aplikasi memerlukan database.
- Terminal PowerShell, Command Prompt, atau terminal Laragon.
Periksa tool yang tersedia:
php -v
composer --version
node -v
npm -v
Jika salah satu command tidak dikenali, gunakan terminal Laragon atau periksa konfigurasi PATH.
Step-by-step tutorial
1. Jalankan Laragon
Buka Laragon dan pilih Start All. Pastikan web server berjalan. Jalankan database service jika aplikasi akan menggunakan database. Nama menu atau service dapat berbeda menurut versi Laragon dan pilihan web server.
2. Pastikan versi PHP yang digunakan
Jalankan php -v dari terminal yang akan dipakai. Jika Laragon memiliki beberapa versi PHP, pilih versi yang sesuai melalui menu Laragon, kemudian tutup dan buka kembali terminal. Hal ini penting karena versi PHP di terminal belum tentu sama dengan versi yang digunakan oleh web server.
3. Buat proyek Laravel
Pindah ke direktori proyek Laragon:
cd C:\laragon\www
composer create-project laravel/laravel belajar-laravel
cd belajar-laravel
Untuk aplikasi yang harus menggunakan major version tertentu, periksa constraint Composer yang tersedia dan dokumentasi resmi sebelum menambahkan batas versi. Hindari menyalin command dari tutorial lama tanpa memeriksa kompatibilitasnya.
4. Jalankan aplikasi
php artisan serve
Buka alamat yang ditampilkan terminal, biasanya http://127.0.0.1:8000. Alternatifnya, gunakan virtual host Laragon. Jika memakai virtual host, pastikan document root diarahkan ke direktori public, bukan root proyek, agar file konfigurasi dan kode aplikasi tidak terekspos.
5. Siapkan environment
Laravel biasanya menyediakan .env saat proses instalasi. Jika belum tersedia:
Copy-Item .env.example .env
php artisan key:generate
Jangan mengganti application key pada aplikasi production secara sembarangan. Key digunakan untuk fitur enkripsi, sehingga rotasi key harus direncanakan agar data terenkripsi yang lama tidak kehilangan akses.
6. Instal dan jalankan asset frontend
Jika proyek menggunakan Vite:
npm install
npm run dev
Biarkan proses Vite tetap berjalan saat development. Untuk membangun asset yang akan dipakai saat deployment, jalankan npm run build.
7. Verifikasi aplikasi
php artisan about
php artisan route:list
Pastikan halaman dapat dibuka, route tampil, dan tidak ada error di terminal. Jika aplikasi memerlukan database, lanjutkan dengan konfigurasi pada artikel tentang environment dan koneksi MySQL/MariaDB.
Troubleshooting
phptidak dikenali: gunakan terminal Laragon atau tambahkan direktori PHP yang benar kePATH, lalu buka terminal baru.composertidak dikenali: instal Composer dan pastikan instalasi mengarah ke PHP yang sesuai.- Port 8000 sedang digunakan: jalankan
php artisan serve --port=8001atau identifikasi proses yang memakai port tersebut. - Vite manifest tidak ditemukan: jalankan
npm installdannpm run dev, atau buat asset dengannpm run build. - Virtual host menghasilkan 403/404: periksa document root agar mengarah ke folder
public. - Ekstensi PHP tidak tersedia: aktifkan ekstensi yang dibutuhkan pada konfigurasi PHP yang benar, lalu restart service.
Best practices
Gunakan versi PHP yang konsisten antara terminal, web server, CI, dan production. Jangan commit .env, credential, atau backup database ke Git. Mulai gunakan Git sejak awal, catat versi runtime yang dipakai, dan jalankan test sebelum memperbarui dependency utama. php artisan serve cocok untuk development, tetapi production perlu web server dan konfigurasi keamanan yang sesuai.
Related articles
Last tested
Tanggal penyusunan: 19 Oktober 2026. Contoh command belum dieksekusi pada mesin Windows/Laragon dalam sesi penulisan ini. Sebelum publikasi, uji dengan versi Laragon, PHP, Composer, dan Node.js yang benar-benar digunakan.