Laravel Konfigürasyon ve Deploy Rehberi

Laravel .env Tuyoları

Laravel Konfigürasyon Tuyoları

Sık kullanılan Laravel .env blokları, Artisan komutları ve Plesk ortamı için önerilen yapılandırmalar.

Mail / SMTP Plesk Sunucu üzerinden SMTP Mail Ayarları

# ───────────────────────────────────────────
# Mail / SMTP Yapılandırması (Plesk SMTP)
# ───────────────────────────────────────────
MAIL_MAILER=smtp
MAIL_SCHEME=null
MAIL_HOST=host.cekirdekod.com
MAIL_PORT=465
MAIL_ENCRYPTION=ssl
MAIL_USERNAME="noreply@example.com"
MAIL_PASSWORD="buraya-plesk-mail-sifresi"
MAIL_FROM_ADDRESS="${MAIL_USERNAME}"
MAIL_FROM_NAME="${APP_NAME}"

Plesk panelinde Mail Hesapları → Dış İstemci sekmesinden sunucu ve port bilgilerini alabilirsiniz. Port 465 + ssl → MAIL_SCHEME=null ile çalışır.

Mail / SMTP Postmark API Üzerinden Mail Gönderimi

# ───────────────────────────────────────────
# Mail / Postmark (Transactional E-posta)
# ───────────────────────────────────────────
MAIL_MAILER=postmark
POSTMARK_TOKEN="postmark-api-token-buraya"
MAIL_FROM_ADDRESS="noreply@yourdomain.com"
MAIL_FROM_NAME="${APP_NAME}"

Gönderim yapılabilmesi için Postmark panosunda Sender Signatures altında alan adını doğrulamanız gerekir.

Queue Database Queue & Supervisor Yapılandırması

# ───────────────────────────────────────────
# Queue Konfigürasyonu (Database Driver)
# ───────────────────────────────────────────
QUEUE_CONNECTION=database

# /etc/supervisor/conf.d/laravel-worker.conf
# [program:laravel-worker]
# process_name=%(program_name)s_%(process_num)02d
# command=php /var/www/html/artisan queue:work --sleep=3 --tries=3 --max-time=3600
# autostart=true
# autorestart=true
# stopasgroup=true
# killasgroup=true
# numprocs=2
# redirect_stderr=true
# stdout_logfile=/var/www/html/storage/logs/worker.log

Supervisor kurmak için: sudo apt install supervisor -y → sudo supervisorctl reread && sudo supervisorctl update

Cache Redis ile Cache, Session ve Queue

# ───────────────────────────────────────────
# Redis ile Cache + Session + Queue (Önerilen)
# ───────────────────────────────────────────
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

Plesk sunucusunda Redis yüklemek için: sudo apt install redis-server -y && sudo systemctl enable redis

Veritabanı MySQL / MariaDB Bağlantısı

# ───────────────────────────────────────────
# Veritabanı Bağlantısı (MySQL / MariaDB)
# ───────────────────────────────────────────
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=veritabani_adi
DB_USERNAME=kullanici_adi
DB_PASSWORD="guclu-sifre-buraya"
DB_CHARSET=utf8mb4
DB_COLLATION=utf8mb4_unicode_ci

Plesk panelinde Veritabanları bölümünden yeni bir MySQL kullanıcısı ve veritabanı oluşturup bilgileri buraya girin. Charset utf8mb4 emoji desteği için zorunludur.

Artisan Üretim Sunucusu Deploy Komut Dizisi

# ───────────────────────────────────────────
# Üretim Sunucusu Deploy Adımları
# ───────────────────────────────────────────
git pull origin main
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan optimize:clear
php artisan optimize
php artisan view:cache
php artisan event:cache
php artisan queue:restart
npm run build # varsa Vite asset derleme

optimize config, route ve event cache'ini tek seferde oluşturur. queue:restart ise çalışan worker'ların yeni kodu almasını sağlar.

Artisan Debug & Önbellek Temizleme Komutları

# ───────────────────────────────────────────
# Sorun Giderme & Cache Temizleme
# ───────────────────────────────────────────
php artisan cache:clear       # Uygulama cache (Redis / File)
php artisan config:clear      # config cache'i temizle
php artisan route:clear       # route cache'i temizle
php artisan view:clear        # Blade compiled view'ları sil
php artisan event:clear       # event cache temizle
php artisan queue:failed      # başarısız işleri listele
php artisan queue:flush       # başarısız tüm işleri sil
php artisan tinker            # interaktif PHP/Laravel REPL
php artisan about             # uygulama özeti (versiyon, env)

Uygulama Temel .env Uygulama Ayarları

# ───────────────────────────────────────────
# Temel Laravel Uygulama Ayarları
# ───────────────────────────────────────────
APP_NAME="Uygulamanın Adı"
APP_ENV=production           # local | production | staging
APP_KEY=base64:...            # php artisan key:generate
APP_DEBUG=false              # ÜRETİMDE mutlaka false olmalı!
APP_URL=https://yourdomain.com
APP_TIMEZONE=Europe/Istanbul
APP_LOCALE=tr
APP_FALLBACK_LOCALE=en
APP_MAINTENANCE_DRIVER=file

# Uygulama anahtarı oluşturmak için:
# php artisan key:generate

Kritik: Üretim ortamında APP_DEBUG=false zorunludur. Aksi hâlde hassas ortam değişkenleriniz hata sayfasında görünür hale gelebilir.

Aradığınız kriterde tuyol bulunamadı

Arama kelimesini değiştirmeyi deneyin.