Laravel adalah framework PHP yang populer untuk membangun aplikasi web modern. Dengan sintaks yang elegan dan fitur-fitur canggih, Laravel memudahkan developer untuk membuat aplikasi yang kuat dan mudah dipelihara. Salah satu cara termudah untuk memulai pengembangan Laravel di Windows adalah dengan menggunakan XAMPP. Panduan ini akan memandu Anda langkah demi langkah tentang cara install Laravel di Windows dengan XAMPP secara cepat dan tepat. Mari kita mulai!

1. Persiapan Awal: Unduh dan Install XAMPP

Sebelum kita mulai proses instalasi Laravel, kita perlu memastikan bahwa XAMPP sudah terpasang di komputer Anda. XAMPP menyediakan semua komponen yang dibutuhkan, seperti Apache, MySQL, dan PHP, dalam satu paket yang mudah diinstall.

• Unduh XAMPP: Kunjungi situs web Apache Friends (https://www.apachefriends.org/download.html) dan unduh versi XAMPP yang sesuai dengan sistem operasi Windows Anda. Pastikan Anda memilih versi PHP yang didukung oleh versi Laravel yang ingin Anda install (saat ini Laravel 10 membutuhkan PHP 8.1 atau lebih tinggi).
• Install XAMPP: Setelah selesai mengunduh, jalankan file installer XAMPP. Ikuti petunjuk instalasi yang muncul di layar. Penting untuk diingat lokasi instalasi XAMPP, karena ini akan menjadi direktori root web server Anda. Lokasi default biasanya C:xampp.
• Jalankan XAMPP Control Panel: Setelah instalasi selesai, buka XAMPP Control Panel. Pastikan modul Apache dan MySQL berjalan (ditandai dengan tombol “Start” yang diklik dan berubah menjadi “Stop”). Jika ada masalah, periksa port yang digunakan oleh modul tersebut dan pastikan tidak ada aplikasi lain yang menggunakannya.

2. Konfigurasi PHP: Pastikan PHP Composer Terinstall

PHP Composer adalah dependency manager untuk PHP. Ini adalah alat yang sangat penting untuk mengelola library dan package dalam proyek Laravel Anda. Laravel menggunakan Composer untuk menginstall dan mengelola dependencies proyek.

• Cek Instalasi Composer: Buka Command Prompt (CMD) atau PowerShell sebagai administrator. Ketik perintah composer --version. Jika Composer sudah terinstall, Anda akan melihat versi Composer yang terpasang.
• Install Composer: Jika Composer belum terinstall, kunjungi situs web resmi Composer (https://getcomposer.org/) dan ikuti petunjuk instalasi untuk Windows. Pastikan Anda memilih untuk menambahkan Composer ke PATH sistem Anda selama proses instalasi.
• Verifikasi Instalasi Composer: Setelah instalasi Composer selesai, buka kembali Command Prompt atau PowerShell dan jalankan perintah composer --version. Jika berhasil, Anda akan melihat informasi versi Composer. Ini menandakan Composer sudah siap digunakan.

3. Membuat Proyek Laravel Baru: Menggunakan Composer

Sekarang, setelah XAMPP dan Composer sudah terinstall dan dikonfigurasi, kita bisa mulai membuat proyek Laravel baru. Proses ini akan menggunakan Composer untuk mengunduh semua dependencies Laravel yang dibutuhkan.

• Buka Command Prompt atau PowerShell: Buka Command Prompt (CMD) atau PowerShell.

• Navigasi ke Direktori htdocs: Navigasi ke direktori htdocs di dalam direktori instalasi XAMPP Anda. Direktori ini adalah direktori root web server Anda. Gunakan perintah cd C:xampphtdocs (atau lokasi yang sesuai jika Anda menginstall XAMPP di lokasi lain).

• Buat Proyek Laravel Baru: Gunakan perintah Composer berikut untuk membuat proyek Laravel baru:

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

  Ganti nama-proyek dengan nama proyek yang Anda inginkan. Contoh: composer create-project --prefer-dist laravel/laravel belajar-laravel

  Proses ini akan mengunduh dan menginstall semua dependencies Laravel ke dalam direktori belajar-laravel. Tunggu hingga proses selesai. Ini mungkin memakan waktu beberapa menit tergantung pada kecepatan internet Anda.

4. Konfigurasi Web Server: Menyiapkan Virtual Host untuk Proyek Laravel

Setelah proyek Laravel berhasil dibuat, kita perlu mengkonfigurasi web server (Apache) untuk mengarahkan domain atau subdomain ke direktori publik proyek Laravel. Ini dilakukan dengan membuat virtual host.

• Buka File httpd-vhosts.conf: Buka file httpd-vhosts.conf yang terletak di direktori C:xamppapacheconfextra. Anda memerlukan hak administrator untuk mengedit file ini.

• Tambahkan Konfigurasi Virtual Host: Tambahkan konfigurasi virtual host berikut ke bagian bawah file httpd-vhosts.conf. Ganti nama-proyek dengan nama proyek Anda dan belajar-laravel.local dengan domain yang Anda inginkan (misalnya, belajar-laravel.local):

  <VirtualHost *:80>
      DocumentRoot "C:/xampp/htdocs/belajar-laravel/public"
      ServerName belajar-laravel.local
      <Directory "C:/xampp/htdocs/belajar-laravel/public">
          AllowOverride All
          Require all granted
      </Directory>
  </VirtualHost>

• Edit File Hosts: Buka file hosts yang terletak di direktori C:WindowsSystem32driversetc. Anda juga memerlukan hak administrator untuk mengedit file ini.

• Tambahkan Entry ke File Hosts: Tambahkan baris berikut ke bagian bawah file hosts. Sesuaikan belajar-laravel.local dengan domain yang Anda gunakan pada konfigurasi virtual host sebelumnya:

  127.0.0.1   belajar-laravel.local

• Restart Apache: Restart modul Apache melalui XAMPP Control Panel agar perubahan konfigurasi diterapkan.

5. Konfigurasi Database: Membuat Database dan Menghubungkannya ke Laravel

Sebagian besar aplikasi Laravel memerlukan database untuk menyimpan data. Kita akan menggunakan MySQL yang disediakan oleh XAMPP.

• Buka phpMyAdmin: Buka browser web Anda dan kunjungi http://localhost/phpmyadmin/. Ini akan membuka antarmuka phpMyAdmin.

• Buat Database Baru: Klik tombol “New” di sidebar kiri. Masukkan nama database yang Anda inginkan (misalnya, belajar_laravel) dan klik tombol “Create”.

• Konfigurasi File .env: Buka file .env yang terletak di direktori proyek Laravel Anda (C:xampphtdocsbelajar-laravel). Cari bagian konfigurasi database dan sesuaikan dengan pengaturan database Anda:

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

  • DB_CONNECTION: Set ke mysql karena kita menggunakan MySQL.
  • DB_HOST: Set ke 127.0.0.1 karena database berada di localhost.
  • DB_PORT: Set ke 3306 (port default MySQL).
  • DB_DATABASE: Set ke nama database yang Anda buat (belajar_laravel).
  • DB_USERNAME: Set ke root (username default MySQL di XAMPP).
  • DB_PASSWORD: Kosongkan jika Anda tidak mengatur password untuk user root di MySQL.

6. Menjalankan Migrasi: Membuat Tabel Database

Setelah database terkonfigurasi, kita perlu menjalankan migrasi untuk membuat tabel-tabel yang dibutuhkan oleh aplikasi Laravel.

• Buka Command Prompt atau PowerShell: Buka Command Prompt (CMD) atau PowerShell.

• Navigasi ke Direktori Proyek Laravel: Navigasi ke direktori proyek Laravel Anda (C:xampphtdocsbelajar-laravel).

• Jalankan Migrasi: Jalankan perintah berikut untuk menjalankan migrasi:

  php artisan migrate

  Perintah ini akan menjalankan semua migrasi yang belum dijalankan dan membuat tabel-tabel yang sesuai di database Anda.

7. Menjalankan Server Pengembangan Laravel: Menguji Aplikasi Anda

Laravel menyediakan server pengembangan built-in yang memudahkan kita untuk menguji aplikasi kita.

• Buka Command Prompt atau PowerShell: Buka Command Prompt (CMD) atau PowerShell.

• Navigasi ke Direktori Proyek Laravel: Navigasi ke direktori proyek Laravel Anda (C:xampphtdocsbelajar-laravel).

• Jalankan Server Pengembangan: Jalankan perintah berikut untuk menjalankan server pengembangan:

  php artisan serve

  Perintah ini akan memulai server pengembangan dan menampilkan alamat server (biasanya http://127.0.0.1:8000).

• Buka Aplikasi di Browser: Buka browser web Anda dan kunjungi alamat yang ditampilkan oleh perintah php artisan serve (biasanya http://127.0.0.1:8000). Jika semuanya berjalan lancar, Anda akan melihat halaman welcome Laravel.

8. Mengatasi Masalah Umum: Troubleshooting Instalasi Laravel

Selama proses instalasi Laravel, Anda mungkin menghadapi beberapa masalah. Berikut adalah beberapa masalah umum dan cara mengatasinya:

• Composer Tidak Dikenal: Pastikan Composer sudah terinstall dengan benar dan sudah ditambahkan ke PATH sistem Anda. Periksa kembali petunjuk instalasi Composer.
• Error Koneksi Database: Pastikan pengaturan database di file .env sudah benar. Periksa nama database, username, password, dan host. Pastikan juga modul MySQL di XAMPP sudah berjalan.
• Permission Issues: Beberapa direktori Laravel memerlukan izin tulis. Jika Anda mengalami masalah terkait izin, coba ubah izin direktori storage dan bootstrap/cache menjadi writable (misalnya, dengan memberikan izin 777).
• Mod Rewrite Tidak Aktif: Jika Anda mengalami masalah dengan URL, pastikan modul mod_rewrite di Apache sudah aktif. Anda bisa mengaktifkannya dengan menghapus tanda pagar (#) di depan baris LoadModule rewrite_module modules/mod_rewrite.so di file httpd.conf (terletak di C:xamppapacheconf). Setelah itu, restart Apache.
• PHP Version Error: Pastikan versi PHP yang digunakan XAMPP sesuai dengan persyaratan Laravel. Laravel 10 membutuhkan PHP 8.1 atau lebih tinggi. Anda bisa memeriksa versi PHP yang digunakan XAMPP melalui XAMPP Control Panel.

9. Menggunakan Laravel Sail untuk Development

Selain menggunakan XAMPP, Anda juga bisa menggunakan Laravel Sail, lingkungan pengembangan Docker resmi dari Laravel. Laravel Sail menyediakan cara yang lebih mudah dan konsisten untuk memulai pengembangan Laravel dengan Docker. Ini sangat berguna jika Anda bekerja dalam tim dan ingin memastikan semua anggota tim memiliki lingkungan pengembangan yang sama.

Meskipun di luar cakupan panduan ini, Anda dapat dengan mudah melakukan instalasi dengan mengikuti panduan resmi Laravel Sail yang tertera di website Laravel (laravel.com). Instalasi menggunakan sail sangat disarankan untuk kemudahan dan menghindari masalah-masalah konfigurasi yang umum terjadi saat menggunakan XAMPP.

10. Tips Tambahan: Optimasi Pengembangan Laravel di Windows

Berikut adalah beberapa tips tambahan untuk mengoptimalkan pengembangan Laravel di Windows:

• Gunakan Editor Kode yang Baik: Pilih editor kode yang nyaman dan mendukung fitur-fitur yang berguna untuk pengembangan PHP dan Laravel, seperti syntax highlighting, code completion, dan debugging. Beberapa pilihan populer adalah Visual Studio Code, Sublime Text, dan PHPStorm.
• Pelajari Artisan Console: Artisan Console adalah command-line interface (CLI) yang disediakan oleh Laravel. Ini adalah alat yang sangat berguna untuk melakukan berbagai tugas pengembangan, seperti membuat controller, model, migrasi, dan lain-lain. Pelajari perintah-perintah Artisan Console yang sering Anda gunakan.
• Manfaatkan Dokumentasi Laravel: Dokumentasi Laravel sangat lengkap dan informatif. Manfaatkan dokumentasi ini untuk mempelajari lebih lanjut tentang fitur-fitur Laravel dan cara menggunakannya.
• Bergabung dengan Komunitas Laravel: Bergabunglah dengan komunitas Laravel online (forum, grup Facebook, Slack) untuk mendapatkan bantuan, berbagi pengetahuan, dan tetap up-to-date dengan perkembangan terbaru di dunia Laravel.
• Versioning dengan Git: Gunakan Git untuk mengelola kode proyek Anda. Ini sangat penting untuk kolaborasi dan tracking perubahan. Gunakan platform seperti GitHub, GitLab, atau Bitbucket untuk menyimpan repository kode Anda secara online.

11. Memahami Struktur Direktori Laravel: Penting untuk Pengembangan

Memahami struktur direktori Laravel sangat penting untuk pengembangan yang efisien. Berikut adalah penjelasan singkat tentang beberapa direktori penting:

• app/: Direktori ini berisi kode inti aplikasi Anda, seperti controller, model, middleware, dan providers.
• bootstrap/: Direktori ini berisi file-file yang digunakan untuk bootstrapping framework Laravel.
• config/: Direktori ini berisi file-file konfigurasi untuk berbagai aspek aplikasi Anda, seperti database, email, dan session.
• database/: Direktori ini berisi file-file migrasi, seed, dan factories untuk database Anda.
• public/: Direktori ini adalah direktori root web server Anda. Ini berisi file index.php yang merupakan entry point aplikasi Anda, serta assets seperti CSS, JavaScript, dan gambar.
• resources/: Direktori ini berisi view (template), bahasa, dan assets yang belum dikompilasi (seperti SCSS dan JavaScript).
• routes/: Direktori ini berisi file-file yang mendefinisikan rute aplikasi Anda.
• storage/: Direktori ini digunakan untuk menyimpan file-file yang dihasilkan oleh aplikasi Anda, seperti cache, logs, dan uploads.
• tests/: Direktori ini berisi file-file pengujian aplikasi Anda.
• vendor/: Direktori ini berisi dependencies yang diinstall oleh Composer.

12. Langkah Selanjutnya: Membangun Aplikasi Laravel Sederhana

Setelah berhasil menginstall Laravel di Windows dengan XAMPP, langkah selanjutnya adalah mulai membangun aplikasi Laravel sederhana. Anda bisa memulai dengan membuat controller, model, dan view sederhana. Pelajari tentang routing, database interaction, dan templating. Ada banyak tutorial dan sumber daya online yang tersedia untuk membantu Anda mempelajari dasar-dasar pengembangan Laravel. Selamat mencoba dan semoga sukses!

Dengan mengikuti panduan cara install Laravel di Windows dengan XAMPP ini, Anda seharusnya dapat dengan mudah menyiapkan lingkungan pengembangan Laravel di komputer Anda. Ingatlah untuk selalu merujuk ke dokumentasi resmi Laravel jika Anda menghadapi masalah atau ingin mempelajari lebih lanjut tentang fitur-fitur Laravel. Selamat berkarya!