Laravel, framework PHP yang elegan dan populer, seringkali menjadi pilihan utama para pengembang web modern. Kemampuannya menyederhanakan proses pengembangan, struktur kode yang rapi, dan fitur-fitur canggih menjadikannya unggul. Jika Anda pengguna Windows dan ingin mulai belajar atau menggunakan Laravel, panduan ini akan memandu Anda langkah demi langkah tentang cara install Laravel di Windows dengan menggunakan XAMPP versi terbaru. Mari kita mulai!

1. Persiapan Awal: Mengunduh dan Menginstall XAMPP Terbaru

Sebelum memulai proses instalasi Laravel, kita perlu memastikan bahwa lingkungan pengembangan (development environment) sudah siap. XAMPP adalah solusi all-in-one yang menyediakan Apache, MySQL (atau MariaDB), dan PHP yang kita butuhkan. Berikut adalah langkah-langkahnya:

• Download XAMPP: Kunjungi situs web resmi Apache Friends (apachefriends.org) dan unduh versi XAMPP yang sesuai dengan sistem operasi Windows Anda. Pastikan Anda memilih versi PHP yang kompatibel dengan Laravel (Laravel 9 dan versi yang lebih baru membutuhkan PHP 8.0 ke atas).
• Instalasi XAMPP: Setelah selesai mengunduh, jalankan file installer XAMPP. Ikuti petunjuk yang muncul di layar. Beberapa hal penting yang perlu diperhatikan:
  • Pilih Komponen: Saat proses instalasi, Anda akan diminta untuk memilih komponen yang ingin diinstall. Pastikan Anda mencentang Apache, MySQL/MariaDB, PHP, dan phpMyAdmin.
  • Pilih Folder Instalasi: Disarankan untuk menginstall XAMPP di direktori yang mudah diakses, misalnya C:xampp. Hindari menginstall di direktori Program Files karena bisa menimbulkan masalah perizinan.
  • Firewall: Mungkin akan muncul peringatan firewall selama proses instalasi. Izinkan XAMPP untuk mengakses jaringan Anda.
• Verifikasi Instalasi XAMPP: Setelah instalasi selesai, buka XAMPP Control Panel. Pastikan Apache dan MySQL/MariaDB berhasil dijalankan. Jika ada error, coba periksa log atau restart komputer Anda. Buka browser Anda dan ketikkan localhost di address bar. Jika Anda melihat halaman dashboard XAMPP, berarti instalasi berhasil.

2. Konfigurasi PHP untuk Laravel: Mengaktifkan Ekstensi yang Dibutuhkan

Laravel membutuhkan beberapa ekstensi PHP agar dapat berfungsi dengan baik. Kita perlu memastikan bahwa ekstensi-ekstensi ini aktif di konfigurasi PHP XAMPP. Berikut caranya:

• Buka File php.ini: Cari file php.ini di direktori instalasi PHP XAMPP. Biasanya terletak di C:xamppphp. Buka file tersebut menggunakan text editor seperti Notepad++.
• Aktifkan Ekstensi yang Dibutuhkan: Cari baris-baris yang diawali dengan extension= yang mengomentari ekstensi yang dibutuhkan Laravel. Hilangkan tanda titik koma (;) di awal baris untuk mengaktifkan ekstensi tersebut. Ekstensi yang umumnya dibutuhkan adalah:
  • extension=openssl (untuk enkripsi dan dekripsi)
  • extension=pdo_mysql (untuk koneksi ke database MySQL)
  • extension=mbstring (untuk menangani string multi-byte)
  • extension=tokenizer (dibutuhkan oleh Laravel)
  • extension=xml (untuk menangani XML)
  • extension=ctype (untuk karakter dan string)
  • extension=json (untuk menangani data JSON)
  • extension=fileinfo (untuk mendapatkan informasi tentang file)
• Simpan Perubahan dan Restart Apache: Setelah mengaktifkan ekstensi yang dibutuhkan, simpan file php.ini. Kemudian, restart Apache melalui XAMPP Control Panel. Ini penting agar perubahan konfigurasi PHP diterapkan.
• Verifikasi Ekstensi: Anda bisa membuat file info.php di direktori htdocs XAMPP (biasanya C:xampphtdocs). Isi file tersebut dengan kode berikut:

<?php
phpinfo();
?>

Buka localhost/info.php di browser Anda. Halaman ini akan menampilkan informasi tentang konfigurasi PHP Anda. Cari ekstensi yang Anda aktifkan sebelumnya untuk memastikan semuanya sudah terpasang dengan benar.

3. Menginstall Composer: Manajer Paket PHP untuk Laravel

Composer adalah dependency manager untuk PHP. Dengan Composer, kita bisa dengan mudah menginstall dan mengelola library dan package yang dibutuhkan oleh proyek Laravel kita. Berikut langkah-langkahnya:

• Download Composer: Kunjungi situs web resmi Composer (getcomposer.org) dan unduh Composer-Setup.exe.
• Instalasi Composer: Jalankan file installer Composer. Ikuti petunjuk yang muncul di layar.
  • Integrasi dengan PHP: Pastikan installer mendeteksi instalasi PHP XAMPP Anda dengan benar. Jika tidak, Anda perlu menunjuk secara manual ke direktori php.exe di direktori PHP XAMPP (misalnya, C:xamppphpphp.exe).
  • Tambahkan ke PATH: Disarankan untuk mencentang opsi “Add PHP to your PATH”. Ini akan memudahkan Anda menjalankan perintah Composer dari command prompt mana pun.
• Verifikasi Instalasi Composer: Buka command prompt (cmd) atau PowerShell. Ketikkan perintah composer dan tekan Enter. Jika Composer berhasil diinstall, Anda akan melihat daftar perintah yang tersedia.

4. Membuat Proyek Laravel Baru: Menggunakan Perintah composer create-project

Sekarang kita sudah memiliki semua yang kita butuhkan untuk membuat proyek Laravel baru. Berikut adalah langkah-langkahnya:

• Buka Command Prompt: Buka command prompt (cmd) atau PowerShell.
• Navigasi ke Direktori htdocs: Pindah ke direktori htdocs di instalasi XAMPP Anda menggunakan perintah cd. Misalnya: cd C:xampphtdocs
• Jalankan Perintah composer create-project: Gunakan perintah berikut untuk membuat proyek Laravel baru:

composer create-project --prefer-dist laravel/laravel nama_proyek

Ganti nama_proyek dengan nama yang Anda inginkan untuk proyek Laravel Anda (misalnya, blog). Perintah ini akan mengunduh dan menginstall semua dependency yang dibutuhkan oleh Laravel. Proses ini mungkin memakan waktu beberapa menit tergantung pada kecepatan internet Anda.

• Masuk ke Direktori Proyek: Setelah proses instalasi selesai, masuk ke direktori proyek Anda menggunakan perintah cd nama_proyek (misalnya, cd blog).

5. Konfigurasi Awal Laravel: File .env dan Key Aplikasi

Setelah proyek Laravel berhasil dibuat, kita perlu melakukan beberapa konfigurasi awal, terutama konfigurasi database dan key aplikasi.

• Salin File .env.example: Di direktori proyek Anda, Anda akan menemukan file bernama .env.example. Buat salinan file ini dan ubah namanya menjadi .env. File .env berisi konfigurasi environment spesifik untuk aplikasi Anda, seperti koneksi database, key aplikasi, dan setting lainnya.
• Generate Key Aplikasi: Jalankan perintah berikut di command prompt (pastikan Anda berada di direktori proyek):

php artisan key:generate

Perintah ini akan menghasilkan key aplikasi unik dan menyimpannya di file .env. Key aplikasi digunakan untuk enkripsi dan keamanan aplikasi.

• Konfigurasi Database: Buka file .env menggunakan text editor. Cari bagian yang berkaitan dengan konfigurasi database (biasanya dimulai dengan DB_). Ubah nilai-nilai tersebut sesuai dengan konfigurasi database MySQL Anda. Contoh:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_database
DB_USERNAME=nama_pengguna
DB_PASSWORD=kata_sandi

Ganti nama_database, nama_pengguna, dan kata_sandi dengan kredensial database MySQL Anda. Pastikan database yang Anda tentukan sudah dibuat di MySQL. Anda bisa menggunakan phpMyAdmin untuk membuat database baru. Jika Anda menggunakan MariaDB, konfigurasinya akan serupa.

6. Menjalankan Proyek Laravel: Menggunakan php artisan serve

Setelah semua konfigurasi selesai, kita bisa menjalankan proyek Laravel kita. Laravel menyediakan development server bawaan yang memudahkan kita untuk menguji aplikasi kita.

• Jalankan Perintah php artisan serve: Di command prompt (pastikan Anda berada di direktori proyek), jalankan perintah berikut:

php artisan serve

Perintah ini akan menjalankan development server Laravel di alamat http://127.0.0.1:8000 (atau alamat lain jika port 8000 sudah digunakan).

• Buka di Browser: Buka browser Anda dan ketikkan alamat yang ditampilkan oleh perintah php artisan serve (misalnya, http://127.0.0.1:8000). Jika instalasi berhasil, Anda akan melihat halaman welcome Laravel.

7. Mengatasi Masalah Umum Saat Install Laravel di Windows

Meskipun proses instalasi Laravel terbilang mudah, ada beberapa masalah umum yang mungkin Anda temui. Berikut adalah beberapa tips untuk mengatasi masalah tersebut:

• Masalah Perizinan: Jika Anda mengalami masalah perizinan (misalnya, saat membuat file atau direktori), coba jalankan command prompt sebagai administrator. Klik kanan pada ikon command prompt dan pilih “Run as administrator”.
• Ekstensi PHP Tidak Aktif: Pastikan semua ekstensi PHP yang dibutuhkan Laravel sudah diaktifkan di file php.ini. Restart Apache setelah mengubah file php.ini.
• Composer Tidak Ditemukan: Pastikan Composer sudah diinstall dengan benar dan ditambahkan ke PATH. Coba restart command prompt setelah menginstall Composer.
• Error Saat Menjalankan php artisan serve: Pastikan Anda berada di direktori proyek Laravel saat menjalankan perintah php artisan serve. Periksa juga apakah ada proses lain yang menggunakan port 8000. Anda bisa mengubah port yang digunakan oleh php artisan serve dengan menambahkan opsi --port (misalnya, php artisan serve --port=8080).
• Database Connection Error: Pastikan konfigurasi database di file .env sudah benar. Periksa juga apakah server MySQL/MariaDB sudah berjalan.
• Error 500: Error 500 adalah generic error yang bisa disebabkan oleh berbagai macam masalah. Periksa log Laravel (biasanya terletak di storage/logs/laravel.log) untuk mendapatkan informasi lebih detail tentang penyebab error tersebut.

8. Integrasi dengan Git: Mengelola Kode dengan Lebih Efisien

Meskipun ini bukan bagian integral dari instalasi Laravel, sangat disarankan untuk menggunakan Git untuk mengelola kode proyek Anda. Git memungkinkan Anda untuk melacak perubahan kode, berkolaborasi dengan pengembang lain, dan mengembalikan kode ke versi sebelumnya jika terjadi kesalahan.

• Install Git: Jika Anda belum memiliki Git, unduh dan install dari situs web resminya (git-scm.com).
• Inisialisasi Repositori Git: Di direktori proyek Anda, jalankan perintah berikut:

git init

Perintah ini akan membuat repositori Git baru di direktori proyek Anda.

• Tambahkan File ke Repositori: Tambahkan semua file di direktori proyek Anda ke repositori dengan perintah:

git add .

• Commit Perubahan: Commit perubahan dengan pesan yang deskriptif:

git commit -m "Initial commit"

• Buat Repositori Jauh (Remote Repository): Buat repositori di platform seperti GitHub, GitLab, atau Bitbucket.
• Hubungkan ke Repositori Jauh: Hubungkan repositori lokal Anda ke repositori jauh dengan perintah:

git remote add origin URL_REPOSITORI_JAUH

Ganti URL_REPOSITORI_JAUH dengan URL repositori jauh Anda.

• Push Perubahan: Push perubahan ke repositori jauh:

git push -u origin main

9. Opsi Pengembangan Lebih Lanjut: Menggunakan Docker untuk Lingkungan Konsisten

Selain menggunakan XAMPP, Anda juga bisa menggunakan Docker untuk membuat lingkungan pengembangan yang lebih konsisten dan terisolasi. Docker memungkinkan Anda untuk membuat container yang berisi semua dependency yang dibutuhkan oleh aplikasi Anda. Ini memastikan bahwa aplikasi Anda akan berjalan dengan konsisten di berbagai lingkungan (development, staging, production).

• Install Docker Desktop: Unduh dan install Docker Desktop dari situs web resminya (docker.com).
• Buat Dockerfile: Buat file bernama Dockerfile di direktori proyek Anda. File ini berisi instruksi untuk membangun image Docker untuk aplikasi Anda.
• Buat docker-compose.yml: Buat file bernama docker-compose.yml di direktori proyek Anda. File ini mendefinisikan layanan-layanan yang dibutuhkan oleh aplikasi Anda (misalnya, web server, database).
• Bangun dan Jalankan Container: Gunakan perintah docker-compose up untuk membangun dan menjalankan container untuk aplikasi Anda.

Menggunakan Docker memang membutuhkan sedikit lebih banyak konfigurasi di awal, tetapi akan sangat bermanfaat dalam jangka panjang, terutama jika Anda bekerja dalam tim atau menyebarkan aplikasi Anda ke berbagai lingkungan.

10. Update Laravel ke Versi Terbaru: Menggunakan Composer

Setelah proyek Laravel Anda berjalan, penting untuk selalu memperbarui Laravel ke versi terbaru untuk mendapatkan fitur-fitur terbaru, perbaikan bug, dan peningkatan keamanan.

• Update Composer Dependencies: Di command prompt (pastikan Anda berada di direktori proyek), jalankan perintah berikut:

composer update

Perintah ini akan mengupdate semua dependency yang dibutuhkan oleh proyek Anda ke versi terbaru yang kompatibel.

• Periksa Changelog: Setelah mengupdate dependency, periksa changelog Laravel (tersedia di situs web resmi Laravel) untuk mengetahui perubahan-perubahan penting yang perlu Anda perhatikan.
• Jalankan Artisan Commands (Jika Diperlukan): Terkadang, setelah mengupdate Laravel, Anda perlu menjalankan beberapa perintah Artisan untuk melakukan migrasi database atau membersihkan cache. Baca dokumentasi Laravel untuk mengetahui perintah-perintah yang perlu Anda jalankan.

11. Sumber Belajar Laravel: Dokumentasi Resmi dan Komunitas Online

Salah satu keuntungan menggunakan Laravel adalah tersedianya dokumentasi resmi yang lengkap dan komunitas online yang aktif.

• Dokumentasi Resmi Laravel: Dokumentasi resmi Laravel (laravel.com/docs) adalah sumber belajar terbaik untuk mempelajari Laravel. Dokumentasi ini berisi penjelasan lengkap tentang semua fitur Laravel, contoh kode, dan panduan langkah demi langkah.
• Laravel News: Laravel News (laravel-news.com) adalah situs web yang menyediakan berita, tutorial, dan tips tentang Laravel.
• Laracasts: Laracasts (laracasts.com) adalah platform online learning yang menyediakan video tutorial berkualitas tinggi tentang Laravel dan teknologi web lainnya.
• Stack Overflow: Stack Overflow (stackoverflow.com) adalah situs web tanya jawab yang sangat berguna untuk mencari solusi untuk masalah-masalah yang Anda temui saat mengembangkan aplikasi Laravel. Gunakan tag laravel saat mengajukan pertanyaan.
• Komunitas Laravel Indonesia: Bergabunglah dengan komunitas Laravel Indonesia di media sosial atau forum online untuk berinteraksi dengan pengembang Laravel lainnya, berbagi pengalaman, dan mendapatkan bantuan.

12. Kesimpulan: Selamat, Anda Sudah Menginstall Laravel di Windows!

Selamat! Anda telah berhasil mengikuti panduan lengkap tentang cara install Laravel di Windows dengan menggunakan XAMPP terbaru. Sekarang Anda siap untuk mulai mengembangkan aplikasi web yang hebat dengan Laravel. Ingatlah untuk selalu merujuk pada dokumentasi resmi, memanfaatkan sumber belajar online, dan berpartisipasi dalam komunitas Laravel untuk meningkatkan keterampilan Anda. Selamat berkarya!