Panduan Lengkap: Cara Install Laravel Terbaru di Windows untuk Developer Modern

Bagi developer web, Laravel adalah salah satu framework PHP yang paling dicari dan banyak digunakan. Popularitasnya tidak lepas dari sintaksis yang elegan, fitur-fitur yang lengkap, dan ekosistem yang mendukung produktivitas tinggi. Jika Anda seorang developer yang menggunakan Windows dan ingin memulai petualangan dengan Laravel, Anda berada di tempat yang tepat. Panduan ini akan membawa Anda langkah demi langkah untuk melakukan instalasi Laravel terbaru di sistem operasi Windows Anda, memastikan lingkungan development yang siap pakai.

Menginstall Laravel di Windows memang memerlukan beberapa persiapan. Ini bukan sekadar mengunduh dan mengklik “install”, tetapi lebih kepada menyiapkan sebuah lingkungan di mana PHP, web server, database, dan alat-alat pendukung lainnya bisa bekerja secara harmonis. Dengan mengikuti panduan ini, Anda akan memiliki setup yang stabil dan efisien, memungkinkan Anda fokus pada pengembangan aplikasi, bukan pada masalah konfigurasi.

Persiapan Lingkungan Development di Windows

Sebelum kita bisa menginstall Laravel, ada beberapa “bahan baku” yang perlu kita siapkan. Ini adalah fondasi dari lingkungan development PHP di Windows. Pastikan semua prasyarat ini terpenuhi untuk menghindari masalah di kemudian hari.

1. PHP, Web Server, dan Database (Pilih XAMPP atau Laragon)

Laravel adalah framework PHP, jadi jelas kita butuh PHP. Selain itu, kita juga memerlukan web server (seperti Apache atau Nginx) dan database (umumnya MySQL/MariaDB) untuk menyimpan data aplikasi. Di Windows, cara termudah untuk mendapatkan ketiganya adalah dengan menggunakan paket server lokal seperti XAMPP atau Laragon.

• XAMPP: Pilihan populer yang sudah lama ada. Mudah diinstal, menyediakan Apache, MySQL, PHP, dan Perl. Kekurangannya, kadang terkesan sedikit “berat” dan kurang fleksibel dalam manajemen versi PHP atau virtual host dibandingkan Laragon.

  Anda bisa mengunduh XAMPP dari situs resminya: apachefriends.org.

• Laragon: Ini adalah pilihan favorit banyak developer Laravel di Windows karena sangat ringan, cepat, dan fiturnya sangat powerful untuk development. Laragon memungkinkan Anda dengan mudah beralih versi PHP, membuat virtual host, dan memiliki integrasi Composer, Node.js, Git, serta Redis yang lebih rapi. Jika Anda serius dengan Laravel di Windows, saya sangat merekomendasikan Laragon.

  Anda bisa mengunduh Laragon dari situs resminya: laragon.org.

Rekomendasi: Laragon

Untuk panduan ini, kita akan fokus pada penggunaan Laragon karena kemudahannya dan fitur-fitur yang lebih lengkap untuk developer Laravel.

Langkah Instalasi Laragon:

1. Unduh installer Laragon (Full Edition direkomendasikan).
2. Jalankan installer, ikuti langkah-langkahnya. Pastikan Anda memilih lokasi instalasi yang mudah diingat (misalnya, C:\laragon).
3. Setelah instalasi selesai, jalankan Laragon.
4. Klik tombol “Start All” untuk memulai Apache (atau Nginx) dan MySQL.
5. Laragon biasanya sudah menyertakan PHP versi terbaru. Untuk memastikan atau mengganti versi PHP, klik ikon roda gigi (Settings) > “Menu” > “PHP” > “Version”. Pilih versi PHP 8.2 atau yang lebih baru, karena Laravel terbaru (misalnya Laravel 11) membutuhkan PHP 8.2 ke atas. Jika versi yang diinginkan tidak ada, Anda bisa mengunduhnya melalui “Menu” > “PHP” > “Add PHP Version”.

Pastikan PHP sudah ditambahkan ke PATH sistem Anda. Laragon biasanya menangani ini secara otomatis, tapi tidak ada salahnya memeriksa. Buka Command Prompt atau PowerShell dan ketik php -v. Jika menampilkan versi PHP, berarti sudah benar.

2. Composer

Composer adalah manajer dependensi untuk PHP. Ini seperti npm di Node.js atau pip di Python. Laravel sangat bergantung pada Composer untuk mengelola library dan paket-paketnya.

Langkah Instalasi Composer:

1. Unduh Composer-Setup.exe dari situs resminya: getcomposer.org/download.
2. Jalankan installer. Pastikan Anda memilih versi PHP yang sudah terinstal melalui XAMPP/Laragon.
3. Ikuti petunjuk instalasi. Pastikan Composer ditambahkan ke PATH sistem Anda.
4. Verifikasi instalasi dengan membuka Command Prompt atau PowerShell baru dan ketik composer -v. Jika menampilkan informasi Composer, berarti sudah berhasil.

3. Node.js dan npm

Meskipun Laravel adalah framework backend PHP, aplikasi Laravel modern seringkali memanfaatkan alat-alat frontend seperti Vite untuk kompilasi aset (CSS, JavaScript). Ini membutuhkan Node.js dan npm (Node Package Manager).

Langkah Instalasi Node.js dan npm:

1. Unduh installer Node.js (versi LTS direkomendasikan) dari situs resminya: nodejs.org/en/download.
2. Jalankan installer dan ikuti langkah-langkahnya. Installer akan secara otomatis menambahkan Node.js dan npm ke PATH sistem.
3. Verifikasi instalasi dengan membuka Command Prompt atau PowerShell baru dan ketik node -v dan npm -v. Jika menampilkan versi masing-masing, berarti berhasil.

4. Code Editor (Direkomendasikan VS Code)

Untuk menulis kode, Anda akan membutuhkan code editor yang nyaman. Visual Studio Code (VS Code) adalah pilihan yang sangat populer di kalangan developer karena ringan, gratis, dan memiliki banyak ekstensi yang mendukung pengembangan PHP dan Laravel.

Anda bisa mengunduh VS Code dari code.visualstudio.com.

Langkah-langkah Install Laravel Terbaru

Setelah semua prasyarat terinstal, kini saatnya untuk membuat proyek Laravel baru. Ada dua cara utama untuk melakukannya:

1. Membuat Proyek Laravel Baru

Opsi A: Menggunakan Laravel Installer (Direkomendasikan)

Laravel Installer adalah cara tercepat untuk membuat proyek Laravel baru. Ini memerlukan Composer.

1. Install Laravel Installer: Buka Command Prompt atau PowerShell dan jalankan perintah ini secara global:

   composer global require laravel/installer

   Pastikan direktori vendor Composer global (misalnya C:\Users\YOUR_USER\AppData\Roaming\Composer\vendor\bin) ditambahkan ke PATH sistem Anda agar perintah laravel dapat dikenali.

2. Buat Proyek Laravel: Navigasikan ke direktori kerja Anda (misalnya, di dalam folder www Laragon, atau htdocs XAMPP). Kemudian, jalankan perintah ini untuk membuat proyek baru bernama nama-proyek-anda:

   laravel new nama-proyek-anda

   Ganti nama-proyek-anda dengan nama proyek yang Anda inginkan. Perintah ini akan mengunduh Laravel versi terbaru dan semua dependensinya.

Opsi B: Menggunakan Composer create-project

Ini adalah cara alternatif yang tidak memerlukan instalasi Laravel Installer secara global. Composer akan mengunduh Laravel dan membuat proyek baru dalam satu langkah.

1. Navigasikan ke direktori kerja Anda (misalnya, di dalam folder www Laragon, atau htdocs XAMPP).
2. Jalankan perintah ini:

   composer create-project laravel/laravel nama-proyek-anda

   Sama seperti sebelumnya, ganti nama-proyek-anda dengan nama proyek Anda.

Setelah salah satu perintah di atas selesai, Anda akan melihat folder baru dengan nama proyek Anda yang berisi struktur dasar aplikasi Laravel.

2. Mengatur Konfigurasi Database

Setiap aplikasi Laravel membutuhkan database. Konfigurasi database diatur dalam file .env yang ada di root proyek Anda.

1. Buka proyek Laravel Anda di VS Code.
2. Buka file .env.
3. Cari bagian konfigurasi database dan sesuaikan dengan pengaturan Anda. Jika Anda menggunakan Laragon atau XAMPP, biasanya konfigurasi default sudah cukup, tapi pastikan nama database Anda unik.

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_database_anda
DB_USERNAME=root
DB_PASSWORD=

Penting: Buat database dengan nama yang sama (misalnya nama_database_anda) di phpMyAdmin atau melalui Antarmuka Laragon. Di Laragon, Anda bisa klik “Menu” > “Database” > “phpMyAdmin” atau “Quick App” > “Database” > “MySQL”.

3. Menjalankan Migrasi Database

Laravel memiliki sistem migrasi database yang memungkinkan Anda membuat tabel database menggunakan kode PHP. Ini memudahkan pengelolaan skema database.

1. Buka Command Prompt atau PowerShell.
2. Navigasikan ke direktori root proyek Laravel Anda (misalnya cd C:\laragon\www\nama-proyek-anda).
3. Jalankan perintah Artisan untuk migrasi:

   php artisan migrate

   Perintah ini akan membuat tabel-tabel default yang dibutuhkan Laravel (users, password reset tokens, dll.) di database Anda.

4. Menginstal Dependensi Frontend dan Kompilasi Aset

Jika aplikasi Laravel Anda menggunakan frontend modern dengan Vite (default Laravel 10+), Anda perlu menginstal dependensi Node.js dan mengkompilasi aset.

1. Masih di Command Prompt/PowerShell di direktori proyek Laravel Anda, jalankan:

   npm install

   Ini akan mengunduh semua paket JavaScript yang diperlukan.

2. Setelah itu, jalankan:

   npm run dev

   Perintah ini akan mengkompilasi aset frontend Anda dan menjalankannya dalam mode development, yang akan secara otomatis me-refresh browser saat ada perubahan.

5. Menjalankan Aplikasi Laravel

Laravel dilengkapi dengan server development built-in melalui Artisan.

1. Buka Command Prompt atau PowerShell baru (biarkan yang untuk npm run dev tetap berjalan di background).
2. Navigasikan ke direktori root proyek Laravel Anda.
3. Jalankan server Artisan:

   php artisan serve

   Anda akan melihat pesan bahwa aplikasi berjalan di http://127.0.0.1:8000.

6. Mengakses Aplikasi di Browser

Buka browser web Anda dan kunjungi alamat http://127.0.0.1:8000. Jika semua langkah berhasil, Anda akan melihat halaman selamat datang Laravel yang ikonik! Selamat, aplikasi Laravel Anda sudah berjalan di Windows.

Pengalaman dan Pertimbangan Praktis

Sebagai seorang developer yang sering bolak-balik antara Windows dan Linux, ada beberapa hal yang saya perhatikan dan ingin bagikan mengenai pengalaman menginstal Laravel di Windows.

Laragon vs. XAMPP: Sebuah Pilihan Strategis

Dalam praktik sehari-hari, saya selalu merekomendasikan Laragon untuk developer Laravel di Windows. Mengapa?
Laragon dirancang lebih modern dan modular. Anda bisa dengan mudah mengunduh dan beralih antara versi PHP yang berbeda, sesuatu yang krusial saat menangani berbagai proyek Laravel dengan persyaratan PHP yang berbeda (misalnya, proyek lama yang masih pakai PHP 7.4 dan proyek baru yang butuh PHP 8.2). Virtual host di Laragon juga jauh lebih mudah dikonfigurasi, membuat Anda bisa mengakses proyek dengan URL yang “cantik” seperti nama-proyek-anda.test, bukan localhost/nama-proyek-anda/public. Ini membuat alur kerja terasa lebih profesional dan mirip dengan lingkungan produksi.

Ketika WSL2 Menjadi Alternatif Lebih Kuat

Bagi Anda yang sudah terbiasa dengan lingkungan Linux atau ingin mendekatkan lingkungan development Windows dengan lingkungan produksi (yang umumnya Linux), Windows Subsystem for Linux 2 (WSL2) adalah game changer. Dengan WSL2, Anda bisa menjalankan distribusi Linux (seperti Ubuntu) langsung di dalam Windows, lengkap dengan performa I/O yang sangat baik. Menginstall Laravel di WSL2 seringkali terasa lebih “natural” dan minim masalah yang khas Windows (seperti izin file atau masalah PATH). Saya sering menggunakan Laragon untuk proyek cepat, tapi untuk proyek besar atau ketika ingin simulasi produksi yang lebih akurat, WSL2 adalah pilihan yang tak tergantikan.

Pentingnya Manajemen Versi PHP

Laravel sangat ketat dengan versi PHP yang didukung. Laravel 11, misalnya, membutuhkan PHP 8.2 atau lebih tinggi. Menggunakan PHP versi di bawah itu pasti akan menyebabkan error. Oleh karena itu, penting untuk selalu memeriksa dokumentasi Laravel untuk versi yang ingin Anda gunakan dan memastikan server lokal Anda (XAMPP/Laragon) menyediakan versi PHP yang sesuai. Laragon memudahkan ini, XAMPP sedikit lebih rumit tapi bisa diakali dengan update manual atau menginstal versi XAMPP yang lebih baru.

Memori dan Resource: Siapkan Diri Anda

Proses instalasi Laravel, terutama saat composer install dan npm install, bisa sangat memakan RAM dan CPU, apalagi jika koneksi internet Anda tidak stabil atau spesifikasi laptop pas-pasan. Jangan kaget jika PC Anda sedikit melambat saat proses ini berjalan. Pastikan Anda memiliki koneksi internet yang stabil untuk mengunduh semua dependensi. Untuk penggunaan sehari-hari, Laravel itu sendiri tidak terlalu berat, tetapi menjalankan server PHP, database, dan npm run dev secara bersamaan memang memerlukan resource yang cukup.

Masalah yang Sering Terjadi dan Solusinya

Tidak jarang proses instalasi ini menemui kendala. Berikut adalah beberapa masalah umum yang mungkin Anda hadapi dan cara mengatasinya:

1. “Composer not found” atau “PHP not found”

• Gejala: Saat menjalankan perintah composer -v atau php -v di Command Prompt/PowerShell, muncul pesan “command not found” atau sejenisnya.
• Penyebab: Composer atau PHP belum ditambahkan ke variabel lingkungan PATH sistem Windows, atau ditambahkan setelah Command Prompt/PowerShell dibuka.
• Solusi:
  1. Pastikan Anda sudah menginstal Composer/PHP dengan benar.
  2. Setelah instalasi, tutup semua jendela Command Prompt/PowerShell yang terbuka, lalu buka yang baru.
  3. Jika masih belum ditemukan, Anda mungkin perlu menambahkan direktori instalasi PHP dan Composer secara manual ke PATH sistem Windows. Cari “Edit the system environment variables” di Start Menu, lalu edit variabel “Path” di bagian “System variables”.

2. Versi PHP Tidak Sesuai (Misal: Laravel 11 dengan PHP < 8.2)

• Gejala: Saat membuat proyek Laravel atau menjalankan perintah Artisan, Anda mendapatkan error yang menyebutkan persyaratan versi PHP.
• Penyebab: Versi PHP yang aktif di sistem Anda lebih rendah dari yang dibutuhkan Laravel. Laravel 11 membutuhkan PHP 8.2 ke atas.
• Solusi:
  1. Pengguna Laragon: Buka Laragon, klik ikon roda gigi (Settings) > “Menu” > “PHP” > “Version”. Pilih versi PHP 8.2 atau yang lebih baru. Jika belum ada, unduh melalui “Add PHP Version”.
  2. Pengguna XAMPP: Anda mungkin perlu mengunduh dan menginstal versi XAMPP yang lebih baru yang sudah menyertakan PHP 8.2+. Atau, unduh versi PHP terbaru secara manual dan integrasikan dengan XAMPP (ini lebih kompleks).
  3. Setelah mengganti versi PHP, pastikan untuk me-restart Laragon/XAMPP dan buka Command Prompt/PowerShell yang baru.

3. Kesalahan Koneksi Database

• Gejala: Error seperti “SQLSTATE[HY000] [2002] No connection could be made because the target machine actively refused it.” atau “Unknown database ‘nama_database_anda'”.
• Penyebab: Database server (MySQL/MariaDB) belum berjalan, nama database di file .env salah atau belum dibuat, atau kredensial database salah.
• Solusi:
  1. Pastikan MySQL/MariaDB sudah berjalan di Laragon/XAMPP (cek statusnya di panel kontrol).
  2. Verifikasi bahwa Anda sudah membuat database dengan nama yang persis sama seperti yang tertera di .env.
  3. Pastikan DB_USERNAME dan DB_PASSWORD di .env sudah benar (biasanya root dan kosong untuk setup lokal).

4. npm install atau npm run dev Gagal

• Gejala: Saat menjalankan perintah npm install atau npm run dev, proses terhenti dengan error atau peringatan merah.
• Penyebab: Koneksi internet tidak stabil, Node.js/npm belum terinstal dengan benar, atau ada masalah dengan dependensi yang diunduh.
• Solusi:
  1. Pastikan koneksi internet Anda stabil.
  2. Coba bersihkan cache npm: npm cache clean --force, lalu coba npm install lagi.
  3. Periksa kembali instalasi Node.js dan npm dengan node -v dan npm -v.
  4. Jika ada masalah dengan permission, coba jalankan Command Prompt/PowerShell sebagai Administrator.

5. Port 8000 Sudah Digunakan

• Gejala: Saat menjalankan php artisan serve, muncul error yang menyatakan port 8000 sudah digunakan.
• Penyebab: Ada aplikasi lain di sistem Anda yang sudah menggunakan port 8000.
• Solusi:
  1. Anda bisa mencoba menjalankan Laravel di port lain: php artisan serve --port=8080 (ganti 8080 dengan port lain yang kosong).
  2. Identifikasi dan matikan aplikasi yang menggunakan port 8000. Anda bisa menggunakan netstat -ano | findstr :8000 di Command Prompt untuk melihat PID proses yang menggunakan port tersebut, lalu matikan melalui Task Manager.

FAQ

Apa itu Laravel?

Laravel adalah framework aplikasi web berbasis PHP yang open-source dan gratis, dirancang untuk memudahkan pengembangan aplikasi web dengan sintaksis yang ekspresif, elegan, dan fitur-fitur bawaan seperti routing, ORM (Eloquent), otentikasi, dan migrasi database. Tujuannya adalah untuk membuat proses pengembangan menjadi lebih menyenangkan dan produktif bagi developer.

Apakah bisa pakai XAMPP untuk install Laravel?

Ya, tentu saja bisa. XAMPP adalah pilihan yang valid dan banyak digunakan untuk menjalankan Laravel di Windows. Namun, Anda perlu memastikan versi PHP di XAMPP Anda sesuai dengan kebutuhan Laravel terbaru (misalnya, PHP 8.2+ untuk Laravel 11). Laragon sering direkomendasikan karena manajemen versi PHP dan virtual host-nya yang lebih fleksibel dan mudah.

Kenapa perlu Node.js dan npm untuk Laravel?

Meskipun Laravel adalah framework backend PHP, aplikasi web modern seringkali melibatkan banyak aset frontend (CSS, JavaScript, gambar) yang perlu dikompilasi atau di-bundle. Laravel terbaru menggunakan Vite sebagai bundler aset default, dan Vite berjalan di lingkungan Node.js. npm (Node Package Manager) digunakan untuk mengelola dependensi JavaScript yang diperlukan oleh Vite dan library frontend lainnya.

Bagaimana cara update Laravel ke versi terbaru?

Mengupdate framework Laravel di proyek yang sudah ada adalah proses yang melibatkan beberapa langkah, bukan hanya satu perintah. Anda perlu mengupdate dependensi Composer di file composer.json, menjalankan composer update, dan kemudian mengikuti panduan upgrade resmi dari Laravel (misalnya, di dokumentasi Laravel.com) untuk setiap versi baru yang dirilis. Ini seringkali melibatkan perubahan kode di beberapa file untuk mengakomodasi fitur baru atau perubahan API.

Apa itu php artisan serve?

php artisan serve adalah perintah Artisan (CLI Laravel) yang menjalankan server pengembangan PHP lokal untuk aplikasi Laravel Anda. Ini adalah cara cepat dan mudah untuk menguji aplikasi Anda selama pengembangan tanpa perlu mengkonfigurasi server web eksternal seperti Apache atau Nginx secara manual. Server ini tidak direkomendasikan untuk lingkungan produksi.

Kesimpulan

Menginstall Laravel terbaru di Windows memang memerlukan beberapa langkah persiapan, tetapi hasilnya sangat sepadan. Dengan lingkungan development yang stabil dan efisien seperti yang telah kita siapkan menggunakan Laragon, Composer, dan Node.js, Anda kini siap untuk menyelami dunia pengembangan web dengan Laravel.

Ingatlah bahwa praktik terbaik selalu menyertai pembelajaran. Eksplorasi fitur-fitur Laravel, pahami konsep-konsep inti seperti Eloquent ORM, Blade templating, dan Artisan CLI. Jangan takut untuk mencoba hal baru dan menghadapi error, karena di situlah proses belajar sebenarnya terjadi. Selamat coding dan semoga sukses dengan proyek-proyek Laravel Anda!

TAGS: Laravel, Windows, Install Laravel, PHP, Composer, Laragon, XAMPP, Web Development, Programming Tutorial

---

Baca Juga

• Panduan Lengkap Belajar Coding untuk Pemula hingga Profesional