PrestaShop mağazası 500 hatası veya boş sayfa veriyor

PrestaShop’ta boş sayfa: nerede göründüğü, nereden geldiğini söyler

Günlükleri okumadan önce bile boş sayfanın ya da 500 hatasının nerede oluştuğunu not edin. Bu, arama alanını yarıya indirir.

• Hem mağaza hem yönetim paneli boş: arıza, PrestaShop ikisini ayırt etmeden önce oluşuyor. Yapılandırmaya bakın: barındırma firmasının değiştirdiği PHP sürümü, eksik bir app/config/parameters.php (1.7, 8, 9) ya da config/settings.inc.php (1.6), geçersiz bir .htaccess, eksik yazma izinleri.
• Yalnızca yönetim paneli: çoğu zaman var/cache/ içinde önceki bir sürümden kalan önbellek ya da yönetim paneline bağlanan bir modül.
• Yalnızca mağaza tarafı ya da tek bir sayfa: bir görüntüleme hook’una bağlı modül, bir tema dosyası ya da o sayfaya özgü bir veri.
• Yalnızca sipariş adımında: yalnızca bu aşamada çağrılan ödeme ya da kargo modülü.

_PS_MODE_DEV_ açıkken sayfa hâlâ boşsa, hata PrestaShop yüklenmeden önce oluşuyor demektir: okunması gereken var/logs değil, sunucunun PHP hata günlüğüdür.

En sık görülen hata mesajları ve işaret ettikleri

• Cannot declare class … ya da Cannot redeclare class …: iki kez tanımlanmış ya da bir modül kaldırıldıktan sonra yerinde kalmış bir override. Sınıf dizinini silmek — 1.7 ve sonrasında var/cache/prod/class_index.php, 1.6’da cache/class_index.php — PrestaShop’u onu yeniden oluşturmaya zorlar.
• Allowed memory size of … bytes exhausted: PHP bellek sınırına ulaşıldı; genellikle bir içe aktarma, küçük resimlerin yeniden oluşturulması ya da bir dizinleme sırasında.
• Call to undefined function each() ya da create_function(): eski bir PHP sürümü için yazılmış bir modül. Bu fonksiyonlar PHP 8’de kaldırıldı; bkz. PrestaShop’u PHP 8’e geçirmek.
• SQLSTATE[42S02]: Base table or view not found: bir geçişten, yarıda kalan bir SQL içe aktarmasından ya da düzgün kaldırılmamış bir modülden sonra eksik bir tablo.
• Link to database cannot be established: yapılandırma dosyasında hatalı veritabanı bilgileri ya da erişilemeyen bir MySQL sunucusu. Bkz. veritabanı bağlantı hatası.
• var/cache ya da var/logs üzerinde Permission denied: kaybolan yazma izinleri; FTP aktarımından ya da barındırma değişikliğinden sonra sık görülür.

En sık görülen nedenler

PrestaShop'ta 500 hatası nadiren rastlantısaldır. En sık karşılaştığım durumlar:

• Sınıfın yeniden tanımlanmasına yol açan, hatalı yazılmış veya override/ ile bir eklenti arasında yinelenmiş bir override dosyası.
• Barındırma sağlayıcısında yapılan bir PHP sürüm yükseltmesi sonrası ortaya çıkan uyumsuzluk (örneğin PHP 8'de kaldırılmış bir fonksiyonu kullanan bir eklenti).
• FTP ile dosya aktarımından sonra var/cache, var/logs veya config üzerinde eksik yazma izinleri.
• PrestaShop çalışmaya başlamadan önce yönlendirmeyi bozan, bozulmuş bir .htaccess dosyası veya geçersiz bir yeniden yazma kuralı.
• Bir geçiş veya yarıda kalan SQL içe aktarma sonrası veritabanında eksik veya bozulmuş bir tablo.

1.6 sürümünde, boş sayfa genellikle bir tema güncellemesinden sonra temizlenmemiş derleme önbelleğindeki (cache/smarty/compile) bir Smarty hatasını gizler.