Cara Instalasi Project Laravel 12 dengan Laragon
Panduan lengkap untuk cara instalasi Laravel 12 untuk membuat website yang baik dan powerful dengan menggunakan Laragon sebagai local development environment.
Cara Instalasi Project Laravel 12 dengan Laragon
Mengapa Memilih Laravel 12 dan Laragon 6?
Laravel 12 merupakan versi terbaru dari framework PHP yang paling populer dengan berbagai peningkatan performa dan fitur keamanan terbaru. Laragon 6 menyediakan environment development yang user-friendly dengan auto virtual host dan support multiple PHP versions.
Keunggulan Laravel 12
- Performance Improvement: Peningkatan performa hingga 30% dibanding versi sebelumnya
- Enhanced Security: Sistem keamanan yang lebih robust dengan encryption terbaru
- Modern PHP Support: Full support untuk PHP 8.3 dan fitur-fitur terbaru
- Advanced Caching System: Redis dan Memcached integration yang optimal
System Requirements dan Persiapan
Sebelum memulai instalasi, pastikan sistem Anda memenuhi requirements berikut:
Minimum System Requirements
- Windows 10 64-bit atau Windows 11
- RAM minimal 4GB (recommended 8GB)
- Free disk space minimal 2GB
- Internet connection stabil
Software Requirements
- PHP 8.2 atau lebih tinggi
- Composer 2.5 atau lebih tinggi
- MySQL 8.0 atau MariaDB 10.6
- Git (optional tapi recommended)
Step 1: Download dan Install Laragon 6
Download Laragon 6 Full Version
Kunjungi website resmi Laragon di laragon.org dan download Laragon 6 Full version (bukan Lite). File size sekitar 300-400MB yang sudah include PHP 8.1/8.2/8.3, Apache, Nginx, MySQL, phpMyAdmin, dan Git.
Proses Instalasi Laragon 6
- Jalankan file installer sebagai Administrator
- Pilih lokasi instalasi (default: C:\laragon)
- Centang "Add Laragon to PATH"
- Centang "Auto start Laragon when Windows starts" (optional)
- Klik Install dan tunggu proses selesai
- Launch Laragon dan tunggu initial setup
Konfigurasi Awal Laragon 6
Setelah instalasi selesai, lakukan konfigurasi berikut:
Setup PHP Version
# Right-click Laragon tray icon
# Pilih PHP → Version → PHP 8.2 atau 8.3
# Restart All Services
Enable Pretty URLs
# Menu → Preferences → General
# Centang "Auto create database"
# Centang "Auto Virtual Hosts"
# Apply changes
Step 2: Verifikasi dan Persiapan Environment
Check PHP Installation
Buka Command Prompt atau Terminal dan jalankan:
php --version
Output yang diharapkan: PHP 8.2.x atau 8.3.x (cli)
Verifikasi PHP Extensions
Laravel 12 membutuhkan extensions berikut yang harus enabled:
php -m | grep -E "(openssl|pdo|mbstring|tokenizer|xml|ctype|json|bcmath|curl|fileinfo|gd)"
Enable Required Extensions
Jika ada extension yang missing, edit file php.ini di folder Laragon → bin → php → php-8.x.x dan uncomment (hilangkan ;) pada:
extension=openssl
extension=pdo_mysql
extension=mbstring
extension=tokenizer
extension=xml
extension=ctype
extension=json
extension=bcmath
extension=curl
extension=fileinfo
extension=gd2
Step 3: Install dan Konfigurasi Composer
Verifikasi Composer
composer --version
Update Composer
composer self-update
Optimasi Composer untuk Performance
composer config --global process-timeout 2000
composer config --global cache-files-maxsize "512MiB"
Step 4: Instalasi Laravel 12
Method 1: Using Laravel Installer
Install Laravel Installer secara global:
composer global require laravel/installer
Create project baru:
cd C:\laragon\www
laravel new nama-project --version=12
Verifikasi Instalasi Laravel
cd nama-project
php artisan --version
Output: Laravel Framework 12.x.x
Step 5: Setup Database Configuration
Create Database via phpMyAdmin
- Buka browser: http://localhost/phpmyadmin
- Login dengan username: root, password: (kosong)
- Klik "New" di sidebar kiri
- Nama database:
nama_project_db
- Collation:
utf8mb4_unicode_ci
- Klik "Create"
Create Database via CMD
mysql -u root -p
CREATE DATABASE nama_project_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
SHOW DATABASES;
EXIT;
Konfigurasi Environment File
Copy file environment dan edit konfigurasi:
cp .env.example .env
Update file .env dengan konfigurasi database:
APP_NAME="Your Project Name"
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://nama-project.test
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_project_db
DB_USERNAME=root
DB_PASSWORD=
Generate Application Key
php artisan key:generate
Step 6: Database Migration dan Seeding
Run Default Migrations
php artisan migrate
Ini akan membuat tables: users, password_resets, failed_jobs, personal_access_tokens
Create Custom Migration (Optional)
php artisan make:migration create_posts_table
Setup Database Seeding
Create seeder untuk data dummy:
php artisan make:seeder UserSeeder
Run seeding:
php artisan db:seed
Atau run migration dan seeding sekaligus:
php artisan migrate:fresh --seed
Step 7: Start Development Server
Method 1: Laravel Artisan Serve
php artisan serve
Server akan berjalan di: http://127.0.0.1:8000
Method 2: Laragon Pretty URLs (Recommended)
Dengan Laragon 6, project Anda otomatis dapat diakses via:
http://nama-project.test
Jika belum berfungsi, reload Apache:
# Right-click Laragon tray → Apache → Reload
Setup HTTPS Development
Generate SSL certificate untuk development yang secure:
# Menu Laragon → SSL → nama-project.test
Access via: https://nama-project.test
Step 8: Optimasi dan Development Tools
Cache Configuration untuk Performance
php artisan config:cache
php artisan route:cache
php artisan view:cache
Clear Cache (untuk Development)
php artisan config:clear
php artisan route:clear
php artisan view:clear
php artisan cache:clear
Install Development Tools
Laravel Debugbar
composer require barryvdh/laravel-debugbar --dev
Laravel Telescope
composer require laravel/telescope --dev
php artisan telescope:install
php artisan migrate
Access: http://nama-project.test/telescope
Code Quality Tools
Laravel Pint (Code Formatting)
composer require laravel/pint --dev
./vendor/bin/pint
Troubleshooting Common Issues
Issue 1: Port Already in Use
Solution: Change port di Laragon settings atau stop service yang konflik
Issue 2: Permission Denied
Solution: Set permission untuk storage dan bootstrap/cache:
chmod -R 775 storage bootstrap/cache
Issue 3: Database Connection Failed
Solution:
- Check MySQL service status di Laragon
- Verify database credentials di .env file
- Restart MySQL service
Best Practices Development
Version Control Setup
git init
git add .
git commit -m "Initial Laravel 12 setup"
Environment Management
- Jangan commit file .env
- Buat .env.example dengan dummy values
- Gunakan environment berbeda untuk production
Security Best Practices
- Update dependencies secara regular
- Implement proper authentication
- Validate semua user input
- Gunakan CSRF protection
- Enable HTTPS untuk production
Kesimpulan
Dengan mengikuti panduan lengkap ini, Anda telah berhasil setup environment development Laravel 12 dengan Laragon 6 yang optimal. Kombinasi ini memberikan workflow development yang smooth dan efisien untuk membangun aplikasi web modern.
Checklist Final Setup
- ✅ Laragon 6 terinstall dan running
- ✅ PHP 8.2+ dengan extensions lengkap
- ✅ Laravel 12 project berhasil dibuat
- ✅ Database terkonfigurasi dengan benar
- ✅ Migration dan seeding berhasil
- ✅ Development server dapat diakses
- ✅ Pretty URLs dan SSL berfungsi
Next Steps
Setelah setup selesai, Anda dapat mulai mengembangkan fitur-fitur seperti:
- Setup Authentication dengan Laravel Breeze
- Implementasi API dengan Laravel Sanctum
- Create Controllers dan Models
- Setup Testing dengan PHPUnit
- Deploy ke production server
Selamat coding dengan Laravel 12 dan Laragon 6! Environment ini akan mendukung Anda dalam membangun aplikasi web yang robust, scalable, dan maintainable.