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

Blog / Umum / Panduan Lengkap Instalasi Lara...
Umum

Panduan Lengkap Instalasi Laravel di Windows Menggunakan Laragon: Dari Setup hingga Aplikasi Pertama

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
4 min read
37 views

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

  • php tidak dikenali: gunakan terminal Laragon atau tambahkan direktori PHP yang benar ke PATH, lalu buka terminal baru.
  • composer tidak dikenali: instal Composer dan pastikan instalasi mengarah ke PHP yang sesuai.
  • Port 8000 sedang digunakan: jalankan php artisan serve --port=8001 atau identifikasi proses yang memakai port tersebut.
  • Vite manifest tidak ditemukan: jalankan npm install dan npm run dev, atau buat asset dengan npm 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.

Bagikan artikel:

Artikel lainnya

Cari Artikel