Laravel adalah framework PHP yang populer digunakan untuk membangun aplikasi web modern dengan cepat dan efisien. Bagi Anda yang ingin memulai mengembangkan aplikasi web dengan Laravel di Windows, artikel ini akan memandu Anda langkah demi langkah tentang cara install Laravel di Windows dengan XAMPP. XAMPP sendiri merupakan paket perangkat lunak gratis yang memudahkan kita untuk membuat server lokal di komputer, lengkap dengan Apache, MySQL, dan PHP. Yuk, simak panduan lengkapnya!

1. Persiapan Awal: Unduh dan Install XAMPP di Windows

Sebelum kita mulai proses instalasi Laravel, hal pertama yang perlu kita lakukan adalah memastikan XAMPP sudah terpasang di komputer Windows kita. Jika belum, ikuti langkah-langkah berikut:

• Unduh XAMPP: Kunjungi situs resmi Apache Friends di https://www.apachefriends.org/download.html. Pilih versi XAMPP yang sesuai dengan sistem operasi Windows Anda (biasanya versi terbaru). Pastikan Anda mengunduh versi yang memiliki PHP 8.1 atau lebih tinggi, karena Laravel merekomendasikan versi tersebut.

• Jalankan Installer XAMPP: Setelah proses unduhan selesai, jalankan file installer XAMPP yang telah Anda unduh. Ikuti petunjuk yang muncul di layar.

• Pilih Komponen XAMPP: Pada tahap pemilihan komponen, pastikan Anda mencentang minimal “Apache”, “MySQL”, “PHP”, dan “phpMyAdmin”. Komponen-komponen ini sangat penting untuk menjalankan Laravel.

• Tentukan Lokasi Instalasi: Pilih lokasi di mana Anda ingin menginstal XAMPP. Secara default, XAMPP akan diinstal di direktori C:xampp. Anda bisa mengubahnya sesuai keinginan, tapi ingat lokasi ini karena akan sering kita gunakan nanti.

• Selesaikan Instalasi: Ikuti langkah-langkah selanjutnya hingga proses instalasi selesai. Setelah selesai, pastikan Anda mencentang opsi “Start the Control Panel now” agar XAMPP Control Panel langsung terbuka.

• Jalankan Apache dan MySQL: Pada XAMPP Control Panel, klik tombol “Start” di sebelah modul “Apache” dan “MySQL”. Jika keduanya berhasil dijalankan, akan muncul tulisan “Running” dengan latar belakang hijau. Jika ada error, periksa apakah ada aplikasi lain yang menggunakan port yang sama (misalnya, Skype atau IIS). Jika ada, matikan aplikasi tersebut atau ubah port Apache dan MySQL di konfigurasi XAMPP.

2. Konfigurasi PHP untuk Laravel: Mengaktifkan Ekstensi yang Dibutuhkan

Laravel membutuhkan beberapa ekstensi PHP agar dapat berjalan dengan baik. Kita perlu memastikan ekstensi-ekstensi ini aktif di konfigurasi PHP XAMPP. Berikut cara mengecek dan mengaktifkannya:

• Buka File php.ini: Klik tombol “Config” pada baris “Apache” di XAMPP Control Panel, lalu pilih “PHP (php.ini)”. File php.ini akan terbuka dengan text editor.

• Cari Ekstensi yang Dibutuhkan: Tekan Ctrl+F (atau Cmd+F di Mac) untuk mencari baris-baris berikut di file php.ini:

  • extension=fileinfo
  • extension=openssl
  • extension=pdo_mysql
  • extension=tokenizer
  • extension=xml
  • extension=ctype
  • extension=json
  • extension=mbstring

• Aktifkan Ekstensi: Jika di depan baris-baris tersebut ada tanda semicolon (;), hapus tanda semicolon tersebut untuk mengaktifkan ekstensi. Contoh:

  ;extension=fileinfo  // Sebelum
  extension=fileinfo  // Sesudah

• Simpan Perubahan: Setelah semua ekstensi yang dibutuhkan diaktifkan, simpan perubahan pada file php.ini dan tutup text editor.

• Restart Apache: Kembali ke XAMPP Control Panel dan klik tombol “Stop” pada baris “Apache”, lalu klik “Start” lagi. Ini dilakukan agar perubahan konfigurasi PHP diterapkan.

3. Install Composer: Dependency Manager untuk Proyek Laravel

Composer adalah dependency manager untuk PHP. Singkatnya, Composer membantu kita mengelola library dan package yang dibutuhkan oleh proyek Laravel kita. Berikut cara menginstall Composer di Windows:

• Unduh Composer: Kunjungi situs resmi Composer di https://getcomposer.org/download/ dan unduh file Composer-Setup.exe.

• Jalankan Installer Composer: Jalankan file installer yang telah Anda unduh. Ikuti petunjuk yang muncul di layar.

• Pilih Lokasi PHP: Pada tahap pemilihan lokasi PHP, pastikan installer mendeteksi lokasi PHP yang ada di XAMPP. Biasanya, lokasinya adalah C:xamppphpphp.exe. Jika tidak terdeteksi secara otomatis, klik “Browse” dan cari file php.exe tersebut.

• Konfigurasi Proxy (Jika Diperlukan): Jika Anda menggunakan proxy untuk terhubung ke internet, masukkan konfigurasi proxy Anda pada tahap ini. Jika tidak, lewati saja.

• Selesaikan Instalasi: Ikuti langkah-langkah selanjutnya hingga proses instalasi selesai.

• Verifikasi Instalasi Composer: Buka Command Prompt (CMD) atau PowerShell dan ketik perintah composer --version. Jika Composer berhasil terinstal, akan muncul informasi versi Composer yang terpasang.

4. Membuat Proyek Laravel Baru: Menggunakan Composer Create-Project

Setelah XAMPP dan Composer terinstal dan terkonfigurasi dengan benar, sekarang kita bisa membuat proyek Laravel baru.

• Buka Command Prompt atau PowerShell: Buka Command Prompt (CMD) atau PowerShell sebagai administrator. Ini penting agar kita memiliki hak akses yang cukup untuk membuat direktori dan file.

• Pindah ke Direktori htdocs: Direktori htdocs adalah direktori utama untuk menyimpan file web di XAMPP. Ketik perintah berikut di Command Prompt atau PowerShell:

  cd C:xampphtdocs

  Ganti C:xampp dengan lokasi instalasi XAMPP Anda jika berbeda.

• Jalankan Perintah composer create-project: Ketik perintah berikut untuk membuat proyek Laravel baru:

  composer create-project --prefer-dist laravel/laravel nama-proyek

  Ganti nama-proyek dengan nama proyek Laravel yang Anda inginkan (misalnya, blog). Perintah ini akan mengunduh semua dependency Laravel dan membuat struktur direktori proyek yang lengkap. Proses ini bisa memakan waktu beberapa menit, tergantung kecepatan internet Anda.

• Masuk ke Direktori Proyek: Setelah proses pembuatan proyek selesai, masuk ke direktori proyek yang baru dibuat dengan perintah:

  cd nama-proyek

  Ganti nama-proyek dengan nama proyek yang Anda buat sebelumnya.

5. Konfigurasi Database: Membuat Database MySQL untuk Laravel

Sebagian besar aplikasi web membutuhkan database untuk menyimpan data. Laravel biasanya menggunakan MySQL sebagai database. Berikut cara membuat database MySQL untuk proyek Laravel:

• Buka phpMyAdmin: Buka browser web Anda dan ketik alamat http://localhost/phpmyadmin. phpMyAdmin adalah tools web untuk mengelola database MySQL.

• Buat Database Baru: Klik tombol “New” di sidebar kiri.

• Masukkan Nama Database: Pada kolom “Database name”, masukkan nama database yang Anda inginkan (misalnya, laravel_blog).

• Pilih Collation (Opsional): Pilih collation yang sesuai dengan kebutuhan Anda (biasanya utf8mb4_unicode_ci atau utf8mb4_general_ci).

• Klik “Create”: Klik tombol “Create” untuk membuat database baru.

6. Konfigurasi .env: Menghubungkan Laravel dengan Database

File .env berisi konfigurasi lingkungan (environment) untuk aplikasi Laravel Anda, termasuk informasi tentang koneksi database. Berikut cara mengkonfigurasi file .env:

• Buka File .env: Buka direktori proyek Laravel Anda (misalnya, C:xampphtdocsblog) dengan text editor (seperti VS Code, Sublime Text, atau Notepad++). Cari file bernama .env.

• Ubah Konfigurasi Database: Cari baris-baris yang berhubungan dengan database:

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

  • Ganti nama_database dengan nama database yang Anda buat di phpMyAdmin (misalnya, laravel_blog).
  • DB_USERNAME biasanya adalah root.
  • DB_PASSWORD biasanya kosong (tidak ada password) untuk instalasi XAMPP default. Jika Anda mengatur password untuk user root di MySQL, masukkan password tersebut di sini.

• Simpan Perubahan: Simpan perubahan pada file .env.

7. Generate Application Key: Keamanan Aplikasi Laravel

Application Key digunakan oleh Laravel untuk mengenkripsi data sensitif. Anda perlu meng-generate Application Key agar aplikasi Anda aman.

• Buka Command Prompt atau PowerShell: Buka Command Prompt (CMD) atau PowerShell dan pastikan Anda berada di direktori proyek Laravel Anda.

• Jalankan Perintah php artisan key:generate: Ketik perintah berikut:

  php artisan key:generate

  Perintah ini akan menghasilkan Application Key baru dan menyimpannya di file .env.

8. Menjalankan Aplikasi Laravel: Memulai Server Lokal

Setelah semua konfigurasi selesai, sekarang kita bisa menjalankan aplikasi Laravel kita.

• Buka Command Prompt atau PowerShell: Buka Command Prompt (CMD) atau PowerShell dan pastikan Anda berada di direktori proyek Laravel Anda.

• Jalankan Perintah php artisan serve: Ketik perintah berikut:

  php artisan serve

  Perintah ini akan memulai server development Laravel di alamat http://127.0.0.1:8000.

• Buka Browser Web: Buka browser web Anda dan ketik alamat http://127.0.0.1:8000. Jika semuanya berjalan dengan benar, Anda akan melihat halaman default Laravel.

9. Troubleshooting Umum: Mengatasi Masalah yang Mungkin Muncul

Berikut beberapa masalah umum yang mungkin muncul saat menginstall Laravel di Windows dengan XAMPP dan cara mengatasinya:

• Error: Composer command not found: Pastikan Composer sudah terinstal dengan benar dan path ke Composer sudah ditambahkan ke environment variable PATH di Windows. Coba restart Command Prompt atau PowerShell setelah menginstall Composer.

• Error: The stream or file "..." could not be opened: Ini biasanya masalah izin (permission). Pastikan Anda menjalankan Command Prompt atau PowerShell sebagai administrator.

• Error: SQLSTATE[HY000] [2002] Connection refused: Pastikan MySQL sudah berjalan di XAMPP Control Panel dan konfigurasi database di file .env sudah benar. Coba restart MySQL jika perlu.

• Error: Class '...' not found: Ini biasanya masalah autoloader. Coba jalankan perintah composer dump-autoload di direktori proyek Laravel Anda.

• White Screen: Pastikan semua ekstensi PHP yang dibutuhkan sudah diaktifkan di file php.ini dan Apache sudah di-restart. Periksa juga file storage/logs/laravel.log di direktori proyek Laravel Anda untuk melihat error yang lebih detail.

10. Langkah Selanjutnya: Belajar Laravel Lebih Lanjut

Selamat! Anda berhasil menginstall Laravel di Windows dengan XAMPP. Sekarang, saatnya untuk belajar lebih lanjut tentang Laravel dan mengembangkan aplikasi web yang keren.

Berikut beberapa sumber belajar yang bisa Anda gunakan:

• Dokumentasi Resmi Laravel: https://laravel.com/docs/
• Laravel Bootcamp: https://bootcamp.laravel.com/
• Laravel News: https://laravel-news.com/
• Laracasts: https://laracasts.com/ (Berbayar)
• YouTube: Cari tutorial Laravel di YouTube. Ada banyak sekali channel yang menyediakan tutorial gratis.

11. Tips Tambahan: Memudahkan Pengembangan Laravel di Windows

Berikut beberapa tips tambahan untuk memudahkan pengembangan Laravel di Windows:

• Gunakan Text Editor/IDE yang Mendukung Laravel: Gunakan text editor atau IDE (Integrated Development Environment) seperti VS Code, Sublime Text, atau PHPStorm yang memiliki fitur syntax highlighting, code completion, dan debugging untuk Laravel.
• Install Extension Laravel di VS Code: Untuk pengguna VS Code, install extension “Laravel” dari Felix Becker untuk mendapatkan fitur tambahan seperti code snippets, intellisense, dan formatters khusus untuk Laravel.
• Gunakan Git untuk Version Control: Gunakan Git untuk mengelola kode Anda. Ini sangat penting untuk melacak perubahan, berkolaborasi dengan orang lain, dan memulihkan kode jika terjadi kesalahan.
• Pelajari Artisan Console: Artisan Console adalah command-line interface yang sangat berguna untuk menjalankan berbagai tugas di Laravel, seperti membuat migration, controller, model, dan lain-lain.
• Bergabung dengan Komunitas Laravel: Bergabunglah dengan komunitas Laravel di forum, grup Facebook, atau Slack. Di sana, Anda bisa bertanya, berbagi pengalaman, dan belajar dari orang lain.

Dengan mengikuti panduan ini dan terus belajar, Anda akan segera menjadi pengembang Laravel yang handal. Selamat mencoba!