Panduan konfigurasi lengkap untuk Website Desa Karangrejo.

File .env adalah tempat konfigurasi utama aplikasi. Copy dari .env.example:

cp .env.example .env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=desa_karangrejo
DB_USERNAME=your_username
DB_PASSWORD=your_password

APP_NAME="Website Desa Karangrejo"
APP_ENV=local
APP_KEY=base64:your_app_key_here
APP_DEBUG=true
APP_TIMEZONE=Asia/Jakarta
APP_URL=http://localhost

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=[email protected]
MAIL_PASSWORD=your_app_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=[email protected]
MAIL_FROM_NAME="${APP_NAME}"

FILESYSTEM_DISK=local
# Untuk production gunakan 's3' atau 'public'

Konfigurasi aplikasi utama:

'name' => env('APP_NAME', 'Laravel'),
'env' => env('APP_ENV', 'production'),
'debug' => env('APP_DEBUG', false),
'url' => env('APP_URL', 'http://localhost'),
'timezone' => 'Asia/Jakarta',
'locale' => 'id',
'fallback_locale' => 'en',

Konfigurasi database sudah optimal, tidak perlu diubah kecuali kebutuhan khusus.

Konfigurasi email sudah sesuai untuk SMTP Gmail.

Pastikan mod_rewrite aktif:

<VirtualHost *:80>
    ServerName desa-karangrejo.local
    DocumentRoot /path/to/desa-karangrejo/public
    
    <Directory /path/to/desa-karangrejo/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

server {
    listen 80;
    server_name desa-karangrejo.local;
    root /path/to/desa-karangrejo/public;
    
    index index.php index.html;
    
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Untuk production, gunakan Redis:

CACHE_DRIVER=redis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

SESSION_DRIVER=redis
SESSION_LIFETIME=120

Untuk background jobs:

QUEUE_CONNECTION=redis

Sudah aktif secara default di Laravel.

Install package cors:

composer require fruitcake/laravel-cors

Konfigurasi di app/Http/Kernel.php sudah optimal.

Jika ingin integrasi social media:

# Facebook
FACEBOOK_CLIENT_ID=your_facebook_app_id
FACEBOOK_CLIENT_SECRET=your_facebook_app_secret

# Google
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

Konfigurasi untuk Intervention Image sudah optimal.

File config/backup.php sudah dikonfigurasi untuk backup database dan files.

TELESCOPE_ENABLED=true
# Set false di production

• Database connection tested
• Mail configuration tested
• File upload working
• Cache working
• Queue working (jika digunakan)
• Backup tested
• All environment variables set
• Web server configured
• SSL certificate installed (production)
• Security headers configured

Untuk production environment:

APP_ENV=production
APP_DEBUG=false
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

• Permission Error: Set proper folder permissions
• Cache Issues: Run php artisan cache:clear
• Config Issues: Run php artisan config:clear
• Database Issues: Check credentials and connection

# Clear all cache
php artisan optimize:clear

# Rebuild config cache
php artisan config:cache

# Rebuild route cache
php artisan route:cache

# Rebuild view cache
php artisan view:cache