Laravel adalah framework PHP yang sangat populer di kalangan developer web karena kemudahan dan kelengkapan fiturnya. Dengan Laravel, membuat aplikasi web modern menjadi lebih cepat dan efisien. Nah, bagi kamu yang baru memulai dan ingin mencoba Laravel di lingkungan Windows, artikel ini akan memandu kamu langkah demi langkah cara install Laravel di Windows dengan XAMPP! Yuk, simak panduan lengkapnya!
1. Persiapan Awal: Mengunduh dan Menginstall XAMPP
Sebelum kita mulai menginstall Laravel, pastikan kamu sudah memiliki XAMPP terinstall di komputermu. XAMPP adalah paket aplikasi yang berisi Apache, MySQL, PHP, dan Perl, yang kita butuhkan untuk menjalankan aplikasi berbasis PHP, termasuk Laravel.
-
Mengunduh XAMPP: Kunjungi website resmi Apache Friends di https://www.apachefriends.org/download.html. Pilih versi XAMPP yang sesuai dengan sistem operasi Windows kamu. Pastikan kamu memilih versi PHP yang didukung oleh Laravel (disarankan versi terbaru atau LTS).
-
Menginstall XAMPP: Setelah diunduh, jalankan file installer XAMPP. Ikuti langkah-langkah berikut:
- Konfirmasi Keamanan (UAC): Jika muncul peringatan User Account Control (UAC), klik “Yes” atau “Izinkan”.
- Peringatan Antivirus: Terkadang antivirus bisa mengganggu proses instalasi. Untuk sementara, nonaktifkan antivirus atau tambahkan pengecualian untuk folder XAMPP.
- Pilih Komponen: Pada halaman pemilihan komponen, biarkan semua komponen tercentang (Apache, MySQL, PHP, phpMyAdmin, dll.).
- Pilih Folder Instalasi: Pilih lokasi folder untuk menginstall XAMPP. Sebaiknya gunakan lokasi default (C:xampp).
- Pilih Bahasa: Pilih bahasa yang kamu inginkan.
- Proses Instalasi: Tunggu hingga proses instalasi selesai.
- Selesai: Setelah selesai, centang opsi untuk langsung menjalankan Control Panel XAMPP.
-
Memastikan XAMPP Berjalan dengan Baik: Setelah XAMPP terinstall, buka Control Panel XAMPP. Klik tombol “Start” pada modul Apache dan MySQL. Jika keduanya berjalan dengan sukses, berarti XAMPP sudah terinstall dengan benar. Kamu bisa mengeceknya dengan membuka browser dan mengetikkan
localhostatau127.0.0.1pada address bar. Jika muncul halaman default XAMPP, selamat! XAMPP kamu sudah siap.
2. Update Composer: Dependency Manager untuk PHP
Composer adalah dependency manager untuk PHP. Dengan Composer, kita bisa dengan mudah menginstall dan mengelola library-library yang dibutuhkan dalam proyek Laravel. Laravel sendiri sangat bergantung pada Composer untuk mengelola dependencies.
-
Memeriksa Keberadaan Composer: Buka Command Prompt (CMD) atau PowerShell sebagai administrator. Ketikkan perintah
composer --version. Jika Composer sudah terinstall, akan muncul informasi versi Composer. Jika belum, lanjutkan ke langkah berikutnya. -
Menginstall Composer: Kunjungi website resmi Composer di https://getcomposer.org/download/. Unduh file
Composer-Setup.exe. -
Proses Instalasi Composer: Jalankan file
Composer-Setup.exedan ikuti langkah-langkah berikut:- Install for all users (recommended): Pilih opsi ini agar Composer bisa digunakan oleh semua pengguna di komputer kamu.
- Check the PHP Command Line: Installer akan otomatis mendeteksi lokasi PHP dari XAMPP. Pastikan lokasi PHP yang terdeteksi sudah benar. Jika belum, arahkan ke folder PHP di XAMPP (contoh:
C:xamppphpphp.exe). - Choose the proxy: Lewati langkah ini jika kamu tidak menggunakan proxy.
- Install: Tunggu hingga proses instalasi selesai.
-
Verifikasi Instalasi Composer: Setelah Composer terinstall, buka Command Prompt (CMD) atau PowerShell sebagai administrator. Ketikkan perintah
composer --version. Kali ini, seharusnya informasi versi Composer sudah muncul. Ini menandakan Composer sudah terinstall dengan sukses dan siap digunakan.
3. Membuat Proyek Laravel Baru: Menggunakan Composer
Setelah XAMPP dan Composer siap, sekarang saatnya membuat proyek Laravel baru. Kita akan menggunakan Composer untuk mengunduh dan menginstall semua dependencies yang dibutuhkan oleh Laravel.
-
Buka Command Prompt/PowerShell: Buka Command Prompt (CMD) atau PowerShell.
-
Navigasi ke Folder htdocs: Pindah ke folder
htdocsdi dalam folder XAMPP. Folderhtdocsadalah tempat kita meletakkan semua file proyek web yang akan dijalankan oleh Apache. Gunakan perintahcd C:xampphtdocs(sesuaikan dengan lokasi instalasi XAMPP kamu). -
Buat Proyek Laravel: Gunakan perintah berikut untuk membuat proyek Laravel baru:
composer create-project --prefer-dist laravel/laravel nama-proyekGanti
nama-proyekdengan nama yang kamu inginkan untuk proyek Laravel kamu (misalnya,blog-laravel). Proses ini akan mengunduh dan menginstall semua dependencies Laravel. Proses ini mungkin memakan waktu beberapa menit tergantung koneksi internet kamu. -
Penting: Memecahkan Masalah create-project yang Gagal: Terkadang proses
composer create-projectbisa gagal karena berbagai alasan, seperti masalah koneksi internet, versi PHP yang tidak kompatibel, atau masalah dengan dependencies. Jika kamu mengalami masalah ini, coba beberapa solusi berikut:- Periksa Koneksi Internet: Pastikan kamu memiliki koneksi internet yang stabil.
- Update Composer: Jalankan perintah
composer self-updateuntuk memastikan Composer kamu adalah versi terbaru. - Versi PHP: Pastikan versi PHP yang digunakan oleh Composer kompatibel dengan Laravel. Kamu bisa mengubah versi PHP yang digunakan oleh Composer dengan mengatur environment variable
PHP_BINARY. - Hapus Folder Vendor: Jika proyek sudah terbuat sebagian, hapus folder
vendordi dalam folder proyek kamu, kemudian coba jalankan perintahcomposer installuntuk menginstall dependencies secara manual. - Coba Instalasi Lokal: Jika semua cara di atas gagal, coba menginstall Laravel secara lokal menggunakan Laravel Installer (jika kamu sudah menginstallnya).
4. Konfigurasi Database: Membuat Database untuk Proyek Laravel
Setelah proyek Laravel berhasil dibuat, kita perlu mengkonfigurasi database agar aplikasi bisa menyimpan dan mengambil data. Laravel secara default menggunakan MySQL, jadi kita akan membuat database di MySQL yang disediakan oleh XAMPP.
-
Buka phpMyAdmin: Buka browser dan ketikkan
localhost/phpmyadminpada address bar. Ini akan membuka halaman phpMyAdmin, sebuah web interface untuk mengelola database MySQL. -
Buat Database Baru:
- Klik tombol “New” pada sidebar kiri.
- Pada kolom “Database name”, masukkan nama database yang kamu inginkan (misalnya,
blog). - Pilih collation yang sesuai (disarankan
utf8mb4_unicode_ciuntuk mendukung karakter Unicode). - Klik tombol “Create”.
-
Konfigurasi File .env: Buka file
.envyang terletak di root folder proyek Laravel kamu. File.envberisi konfigurasi untuk aplikasi Laravel, termasuk konfigurasi database. Cari bagian yang berkaitan dengan database dan ubah nilainya sesuai dengan konfigurasi database yang baru kamu buat.DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=blog # Ganti dengan nama database kamu DB_USERNAME=root DB_PASSWORD= # Biarkan kosong jika kamu tidak mengatur password untuk user root di MySQLPastikan nilai
DB_DATABASEsesuai dengan nama database yang kamu buat di phpMyAdmin.DB_USERNAMEbiasanyarootdanDB_PASSWORDbiasanya kosong (jika kamu belum mengatur password).
5. Menjalankan Proyek Laravel: Menggunakan Artisan Serve
Setelah database dikonfigurasi, sekarang saatnya menjalankan proyek Laravel kita. Laravel menyediakan command-line tool bernama Artisan yang memudahkan kita untuk melakukan berbagai tugas, termasuk menjalankan development server.
-
Buka Command Prompt/PowerShell: Buka Command Prompt (CMD) atau PowerShell.
-
Navigasi ke Folder Proyek Laravel: Pindah ke folder proyek Laravel kamu (misalnya,
C:xampphtdocsblog-laravel). -
Jalankan Artisan Serve: Gunakan perintah berikut untuk menjalankan development server:
php artisan servePerintah ini akan menjalankan development server pada alamat
http://127.0.0.1:8000. -
Akses Aplikasi Laravel: Buka browser dan ketikkan
http://127.0.0.1:8000pada address bar. Jika semuanya berjalan lancar, kamu akan melihat halaman welcome Laravel. Selamat! Proyek Laravel kamu sudah berhasil diinstall dan dijalankan.
6. Mengatasi Masalah Umum Saat Install Laravel di Windows
Meskipun proses instalasi Laravel cukup mudah, terkadang kita bisa menghadapi beberapa masalah. Berikut adalah beberapa masalah umum dan solusinya:
-
Error “Extension=fileinfo not found”: Laravel membutuhkan extension
fileinfodi PHP. Buka filephp.ini(terletak di folder PHP di XAMPP) dan cari baris;extension=fileinfo. Hapus tanda;di depannya agar extensionfileinfoaktif. Restart Apache setelah mengubahphp.ini. -
Error “openssl extension required”: Laravel juga membutuhkan extension
openssl. Sama seperti fileinfo, buka filephp.inidan aktifkan extensionopenssldengan menghapus tanda;di depannya. Restart Apache setelah mengubahphp.ini. -
Error saat menjalankan
php artisan serve: Pastikan kamu sudah berada di dalam folder proyek Laravel saat menjalankan perintahphp artisan serve. Pastikan juga bahwa PHP sudah terkonfigurasi dengan benar di sistem environment variables. -
Masalah Izin Akses: Terkadang, masalah izin akses bisa menyebabkan proses instalasi atau menjalankan aplikasi Laravel gagal. Coba jalankan Command Prompt/PowerShell sebagai administrator.
-
Routing Tidak Berfungsi: Jika routing tidak berfungsi dengan baik (misalnya, halaman tidak ditemukan), pastikan kamu sudah mengaktifkan
mod_rewritedi Apache. Buka filehttpd.conf(terletak di folder Apache di XAMPP) dan cari baris#LoadModule rewrite_module modules/mod_rewrite.so. Hapus tanda#di depannya agarmod_rewriteaktif. Kemudian cari<Directory />dan ubahAllowOverride NonemenjadiAllowOverride All. Restart Apache setelah mengubahhttpd.conf.
7. Konfigurasi Virtual Host (Opsional): Menggunakan Nama Domain Lokal
Secara default, aplikasi Laravel kita diakses melalui http://127.0.0.1:8000. Jika kamu ingin menggunakan nama domain lokal (misalnya, blog.test), kamu bisa mengkonfigurasi virtual host di Apache.
-
Edit File hosts: Buka file
hostsyang terletak diC:WindowsSystem32driversetc. Buka file ini dengan text editor sebagai administrator. Tambahkan baris berikut di bagian paling bawah file:127.0.0.1 blog.testIni akan mengarahkan domain
blog.testke alamat127.0.0.1(localhost). -
Buat Virtual Host di Apache: Buka file
httpd-vhosts.confyang terletak diC:xamppapacheconfextra. Tambahkan konfigurasi virtual host berikut di bagian paling bawah file:<VirtualHost *:80> DocumentRoot "C:/xampp/htdocs/blog-laravel/public" # Ganti dengan path ke folder public proyek Laravel kamu ServerName blog.test <Directory "C:/xampp/htdocs/blog-laravel/public"> # Ganti dengan path ke folder public proyek Laravel kamu AllowOverride All Require all granted </Directory> </VirtualHost>Ganti
C:/xampp/htdocs/blog-laravel/publicdengan path yang benar ke folderpublicproyek Laravel kamu. -
Restart Apache: Restart Apache agar perubahan konfigurasi virtual host diterapkan.
-
Akses Aplikasi Laravel: Sekarang, kamu bisa mengakses aplikasi Laravel kamu melalui
http://blog.test.
8. Keamanan Awal Proyek Laravel: Konfigurasi .env dan Debug Mode
Setelah berhasil menginstall dan menjalankan proyek Laravel, langkah selanjutnya adalah memastikan keamanan dasar aplikasi. Salah satu langkah penting adalah mengkonfigurasi file .env dengan benar dan menonaktifkan debug mode di lingkungan produksi.
-
Konfigurasi App Key:
APP_KEYadalah kunci enkripsi yang digunakan oleh Laravel. PastikanAPP_KEYsudah diatur dengan benar. Jika belum, jalankan perintah berikut di terminal:php artisan key:generatePerintah ini akan menghasilkan kunci enkripsi acak dan menyimpannya di file
.env. -
Menyembunyikan Informasi Debug: Jangan tampilkan informasi debug secara rinci di lingkungan produksi. Ubah nilai
APP_DEBUGdi file.envmenjadifalse.APP_DEBUG=falseIni akan menonaktifkan debug mode dan hanya menampilkan pesan error yang umum.
-
Mengamankan Database: Jangan gunakan username dan password
rootuntuk koneksi database di lingkungan produksi. Buat user baru dengan hak akses yang terbatas untuk database proyek Laravel kamu.
9. Mengenal Struktur Folder Laravel: Memahami Organisasi Proyek
Setelah berhasil menginstall, penting untuk memahami struktur folder Laravel. Struktur ini dirancang untuk mempermudah pengembangan dan pemeliharaan aplikasi.
app/: Folder ini berisi kode inti aplikasi kamu, seperti controllers, models, middlewares, dan providers.bootstrap/: Folder ini berisi framework bootstrapping files, termasuk cache configuration dan autoloader.config/: Folder ini berisi semua file konfigurasi aplikasi, seperti konfigurasi database, email, session, dan lain-lain.database/: Folder ini berisi migrations, seeders, dan factories yang digunakan untuk mengelola database.public/: Folder ini berisi file-file publik seperti CSS, JavaScript, dan images. Folder ini adalah document root aplikasi, yang diakses oleh web server.resources/: Folder ini berisi views (template HTML), assets (uncompiled CSS dan JavaScript), dan language files.routes/: Folder ini berisi file-file route yang mendefinisikan endpoints aplikasi.storage/: Folder ini berisi file-file yang dihasilkan oleh aplikasi, seperti cache, logs, dan uploaded files.tests/: Folder ini berisi test files untuk aplikasi kamu.vendor/: Folder ini berisi semua dependencies yang diinstall oleh Composer. Jangan mengubah isi folder ini secara manual.
10. Langkah Selanjutnya: Belajar Laravel Lebih Dalam
Setelah berhasil menginstall Laravel di Windows dengan XAMPP, petualanganmu baru saja dimulai! Laravel adalah framework yang sangat kaya fitur dan memiliki banyak hal untuk dipelajari.
- Dokumentasi Laravel: Sumber belajar terbaik adalah dokumentasi resmi Laravel di https://laravel.com/docs/. Dokumentasi ini lengkap, terstruktur dengan baik, dan selalu up-to-date.
- Laravel Bootcamp: Laravel menyediakan bootcamp gratis yang akan memandu kamu membuat aplikasi Laravel pertama kamu langkah demi langkah: https://bootcamp.laravel.com/
- Laravel Official Packages: Laravel memiliki banyak official packages yang bisa kamu gunakan untuk menambahkan fungsionalitas ke aplikasi kamu, seperti Laravel Passport untuk otentikasi API dan Laravel Sanctum untuk otentikasi single-page applications.
- Komunitas Laravel: Bergabunglah dengan komunitas Laravel di forum, grup Facebook, atau Slack. Komunitas Laravel sangat aktif dan ramah, dan kamu bisa mendapatkan bantuan dan dukungan dari developer lain.
- Tutorial dan Kursus Online: Ada banyak tutorial dan kursus online yang tersedia untuk belajar Laravel, baik gratis maupun berbayar. Cari tutorial dan kursus yang sesuai dengan gaya belajar kamu.
Dengan mengikuti panduan ini, kamu seharusnya sudah berhasil menginstall Laravel di Windows dengan XAMPP dan siap untuk memulai proyek web impianmu! Selamat mencoba dan semoga sukses!