Arama Yap Mesaj Gönder
Biz Sizi Arayalım
+90
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro

Bize Ulaşın

Konum Halkalı merkez mahallesi fatih cd ozgur apt no 46 , Küçükçekmece , İstanbul , 34303 , TR
Laravel ve PHP yapılandırması

APP_NAME yüzünden oluşan Laravel beyaz sayfa hatasını kaynağından çözün

Boşluk içeren bir .env değeri tırnaksız yazıldığında Dotenv ayrıştırması başarısız olabilir. Üretimde PHP hata gösterimi kapalıysa kullanıcı yalnızca beyaz sayfa veya HTTP 500 görür.

root@eka:~/application
APP_NAME=Axu Tours
PHP Fatal error: Uncaught Dotenv\Exception\InvalidFileException
HTTP/1.1 500 Internal Server Error
01Boşluklu değerleri tırnak içine alın
02Beyaz sayfada önce logları okuyun
03Üretimde APP_DEBUG açık bırakmayın
04Düzeltmeden sonra yapılandırma önbelleğini temizleyin
01
Teknik teşhis

Gerçek neden yalnızca “beyaz sayfa” değildir

Laravel resmi dokümantasyonu, boşluk içeren çevre değişkenlerinin çift tırnakla yazılmasını ister. Dotenv yükleme sırasında istisna oluşur; PHP display_errors kapalıysa istisna ekrana basılmaz ve sorun beyaz sayfa gibi görünür.

01

Hatalı APP_NAME

Boşluklu değer tırnaksız bırakılmıştır.

Hatalı
APP_NAME=Axu Tours
Doğru
APP_NAME="Axu Tours"
02

Hatalı URL değeri

Satır sonu açıklaması değerle karışabilir; yorumları ayrı satırda tutmak daha güvenlidir.

Hatalı
APP_URL=https://ornek.com # canlı
Doğru
APP_URL="https://ornek.com"
03

Gizlenen başlangıç hatası

Üretimde hatayı göstermeyin fakat mutlaka kaydedin.

Hatalı
display_errors=Off
log_errors=Off
Doğru
display_errors=Off
log_errors=On
error_log=/var/log/php/error.log
02
SSH ve terminal

Tahmin etmeden önce ölçün ve logları doğrulayın

01

Laravel logunu izleyin

Uygulama açılabiliyorsa son istisnaları gösterir.

tail -n 150 storage/logs/laravel.log
tail -f storage/logs/laravel.log
02

PHP ve web sunucusu loglarını kontrol edin

Dotenv daha Laravel log sistemi başlamadan çökerse hata burada görünür.

journalctl -u php8.3-fpm -n 100 --no-pager
tail -n 100 /var/log/nginx/error.log
tail -n 100 /usr/local/apache/logs/error_log
03

.env ayrıştırmasını doğrudan test edin

Dosya biçimi bozuksa CLI doğrudan istisna üretir.

php -r 'require "vendor/autoload.php"; Dotenv\Dotenv::createImmutable(getcwd())->load(); echo "ENV OK\n";'
04

Önbellekleri temizleyin

Eski önbelleğin düzeltilmiş değeri engellemesini önler.

php artisan optimize:clear
php artisan config:clear
php artisan about --only=environment
03
Kontrollü uygulama

Adım adım güvenli çözüm sırası

01

Adım 1

FTP veya SSH üzerinden .env dosyasının yedeğini alın.

02

Adım 2

Boşluk, #, tırnak, eşittir işareti veya satır sonu içeren değerleri belirleyin.

03

Adım 3

APP_NAME gibi boşluklu değerleri çift tırnak içine alın.

04

Adım 4

Artisan çalışıyorsa optimize:clear komutunu uygulayın.

05

Adım 5

HTTP 500 devam ederse PHP-FPM, Apache veya Nginx error logunu okuyun.

06

Adım 6

Sorun çözüldükten sonra APP_DEBUG=false ve log_errors=On kullanın.

04
Hata sözlüğü

Benzer görünen hataları doğru nedene bağlayın

4 kayıt
Hata

Invalid file format

Tırnaksız boşluk, kapanmamış tırnak veya bozuk satır.

Hata

HTTP 500 / blank page

Başlangıç istisnası ekranda gizleniyor.

Hata

php artisan çalışmıyor

.env daha framework açılmadan çökmektedir.

Hata

Değişiklik görünmüyor

Yapılandırma önbelleği eski değeri kullanıyor.

Aramanızla eşleşen hata bulunamadı.

Kaçınılması gerekenler

Sorunu büyüten müdahaleler

  • Üretimde APP_DEBUG=true kullanmak gizli değerleri açığa çıkarabilir.
  • .env dosyasını web kökünden yayınlamayın.
  • Hatayı bastırmak için error_reporting(0) kullanıp logları da kapatmayın.
  • FTP editörünün dosyaya BOM veya bozuk satır sonu eklemediğini doğrulayın.
Başarı doğrulaması

İşlemin bittiğini nasıl anlarsınız?

  • php artisan about komutu hatasız tamamlanır.
  • APP_NAME doğru görüntülenir.
  • HTTP yanıtı 200 döner ve yeni 500 kaydı oluşmaz.
  • Üretimde hata ekranı kapalı, hata logu açıktır.
05
FAQ

Sık sorulan teknik sorular

APP_NAME neden mutlaka tırnaklı olmalı?

Değer boşluk içeriyorsa Laravel belgeleri çift tırnak kullanılmasını belirtir. Tek kelimelik değerlerde tırnak zorunlu değildir.

APP_DEBUG=true yapmalı mıyım?

Yalnız güvenli geliştirme ortamında geçici olarak kullanılmalıdır. Üretimde loglar okunmalı ve APP_DEBUG=false kalmalıdır.

Artisan da beyaz kalıyorsa ne yapmalıyım?

.env dosyasını doğrudan düzeltin ve PHP CLI ile Dotenv ayrıştırma testini çalıştırın.

06
Konu kümesi

İlgili Laravel ve sunucu hata rehberleri

Resmî teknik kaynaklar

Çözüm adımları birincil dokümanlarla doğrulandı

Laravel ConfigurationPHPDotenvPHP Error ConfigurationLaravel Deployment
EKA YAZILIM VE BİLİŞİM SİSTEMLERİ

Laravel beyaz sayfa hatasını tahminle değil log ve yapılandırma doğrulamasıyla çözelim

Laravel, PHP-FPM, Nginx, Apache, MySQL, cPanel ve Plesk katmanlarını loglarla birlikte inceleyerek kalıcı çözüm uyguluyoruz.

Teknik Destek AlWhatsApp ile Yaz
Top