Prestashop – Saviorhost İnternet Hizmetleri https://saviorhost.com/blog Web projenizi kurtaran hosting sağlayıcısı: Savior Host! Fri, 24 Oct 2025 14:51:44 +0000 tr hourly 1 https://wordpress.org/?v=7.0 https://saviorhost.com/blog/wp-content/uploads/2018/07/cropped-favicon-150x150.png Prestashop – Saviorhost İnternet Hizmetleri https://saviorhost.com/blog 32 32 PrestaShop’ta “500 Internal Server Error” Hatası: Nedenleri, Teşhis ve %100 Çözüm Kılavuzu https://saviorhost.com/blog/prestashopta-500-internal-server-error-hatasi-nedenleri-teshis-ve-0-cozum-kilavuzu/ https://saviorhost.com/blog/prestashopta-500-internal-server-error-hatasi-nedenleri-teshis-ve-0-cozum-kilavuzu/#respond Fri, 24 Oct 2025 14:51:21 +0000 https://saviorhost.com/blog/?p=2159 “500 Internal Server Error”, PrestaShop mağazalarında en sık görülen çökme senaryolarından biridir. Genellikle tema/modül güncellemeleri, PHP uyumsuzluğu, yanlış dosya izinleri, bozulmuş .htaccess veya eksik PHP eklentilerinden kaynaklanır. PrestaShop ekibi de 500’ün en yaygın nedenlerini ve çözüm yöntemlerini resmi yardım merkezinde özellikle listeliyor. help-center.prestashop.com

Aşağıdaki rehber, en hızlı geri dönüş için önce teşhis, ardından kalıcı çözüm adımlarını sunar. Geliştirici olmanıza gerek yok—adımları sırayla uygulamanız yeterli.

1) İlk Teşhis: Hatanın Gerçek Yüzünü Görün (Debug Mode)

500’ün “neden”ini görmek için Debug Mode’u açın. Yönetim paneline erişebiliyorsanız Gelişmiş Parametreler → Performans → Hata Ayıklama Modu (Debug Mode) bölümünden aktif edin; erişemiyorsanız config/defines.inc.php dosyasında _PS_MODE_DEV_ değerini true yapın. İşiniz bitince mutlaka kapatın. (Resmi yardım merkezi ve topluluk kılavuzları bunu önerir.) help-center.prestashop.com+1

Neyi beklemelisiniz?
Beyaz sayfa yerine ayrıntılı PHP/Symfony hata yığını göreceksiniz. Satır ve dosya adı, sorunun modül/tema/çekirdek kaynaklı olup olmadığını açık eder.

2) En Sık Nedenler ve Hızlı Çözümler

A) Tema/Modül Çatışmaları (Güncelleme Sonrası)

  • Belirti: 500, BO/FO’da aniden çökme.

  • Çözüm: Son kurduğunuz modülü FTP ile /modules/ altında geçici olarak yeniden adlandırın (devre dışı kalır). Ardından önbelleği temizleyip sayfayı yenileyin. PrestaShop’un genel 500 hata kılavuzu modül kaynaklı çöküşleri özel olarak vurgular. help-center.prestashop.com

B) PHP Sürümü / Eklenti Uyumsuzluğu

  • Belirti: Hata yığında Deprecated, Fatal error: Uncaught TypeError vb.

  • Çözüm: Kullanılan PrestaShop sürümünün PHP uyumluluğunu kontrol edin. PrestaShop 8 için öneri PHP 8.1’dir; sistem gereksinimleri resmi dökümantasyonda detaylıdır. Ayrıca intl gibi eklentilerin yüklü olduğundan emin olun. PrestaShop

C) Dosya/klasör izinleri hatalı (permissions)

  • Belirti: Log dizinine yazılamıyor, cache temizlenmiyor → 500.

  • Çözüm: Tipik olarak dosyalar 644, klasörler 755 olmalı; özellikle var/cache ve var/logs (veya /var/log) yazılabilir olmalı. Toplulukta izin/ownership kaynaklı 500’ler sıkça görülür. prestashop.com

D) Bozulmuş .htaccess veya URL Yeniden Yazımı (mod_rewrite)

  • Belirti: Friendly URL açıkken 500/404, yönlendirme döngüsü.

  • Çözüm: .htaccess dosyasını yeniden üretin ve sunucuda URL rewrite’ın aktif olduğundan emin olun. PrestaShop 8 kullanıcı kılavuzu Friendly URL’lerin URL rewriting gerektirdiğini özellikle belirtir. docs.prestashop-project.org

E) Önbellek/Smarty Bozulmaları

  • Belirti: Sayfalar açılmıyor ya da eski halini gösteriyor.

  • Çözüm: BO’dan Performans → Önbellek temizle; erişemiyorsanız var/cache/prod ve var/cache/dev içeriğini silin (dizini değil, içeriği). Barındırma sağlayıcı rehberleri manuel temizlemeyi adım adım gösterir. SiteGround

3) Adım Adım “Hızlı Kurtarma” Akışı (How-To)

  1. Debug Mode’u açın ve ekranda görünen gerçek hatayı not alın. (Sebebi netleştirir.) help-center.prestashop.com

  2. Son değişikliği geri alın: Yeni modül/tema/sürüm güncellemesi yaptıysanız kapatın veya geri sarın. help-center.prestashop.com

  3. Önbelleği temizleyin: BO → Performans’tan; erişemiyorsanız var/cache/prod/* ve var/cache/dev/* klasörlerinin içeriğini silin. SiteGround

  4. .htaccess’i yeniden oluşturun: BO → Mağaza Parametreleri → Trafik & SEO → Friendly URL’yi kapatıp kaydedin, sonra tekrar açıp kaydedin (yeniden yazım aktif olmalı). docs.prestashop-project.org

  5. PHP sürümü ve eklentileri doğrulayın: PrestaShop 8 için öneri PHP 8.1; intl, mbstring, gd, curl, zip gibi yaygın eklentileri kontrol edin (eksikler 500’e yol açabilir). PrestaShop

  6. İzin/ownership’i düzeltin: Özellikle var/ altındaki yazılabilir dizinler (cache/log) için kullanıcı ve izinleri kontrol edin. (Topluluk çözümleri sıkça buna işaret eder.) prestashop.com

  7. Kalıcı sorunlarda log’lara bakın: Yönetim → Gelişmiş Parametreler → Günlükler (Logs) ve sunucudaki var/log dosyaları ipucu verir. (Resmi 1.7 kılavuzu log sayfasını açıklar.) docs.prestashop-project.org

İpucu: Yerel/uzak sunucunuzun uyumluluğunu topluca test etmek için PrestaShop’un resmi PhpPsInfo aracını çalıştırabilirsiniz (gereksinim kontrolü). GitHub

4) Örnek Senaryo ve Çözüm (Kopyala–Yapıştır)

Belirti: Tema güncellemesi sonrası tüm sayfalarda 500.

Çözüm Planı:

# 1) Yönetim yoksa debug'ı elle açın:
# /config/defines.inc.php içinde:
# define('_PS_MODE_DEV_', false);
# yerine:
# define('_PS_MODE_DEV_', true);# 2) Önbellekleri temizleyin (dosyaları silin, klasörleri değil):
rm -rf var/cache/prod/* var/cache/dev/*# 3) Sorunlu modülü etkisizleştirin (geçici yeniden adlandırma):
# FTP/SFTP: /modules/sorunlu_modul → /modules/_sorunlu_modul.disabled

# 4) Apache’de mod_rewrite kontrol, Friendly URL yeniden kaydedin (.htaccess yenilensin)

# 5) İş bittiğinde debug’ı KAPATMAYI unutmayın.

5) Kalıcı Sağlamlık: “Bir daha yaşanmaması” için 6 öneri

  1. Sürüm uyum tablosuna göre güncelleyin: PHP/PrestaShop uyumunu kontrol etmeden sürüm yükseltmeyin. PrestaShop

  2. Staging ortamı kullanın: Modül/tema güncellemelerini önce test mağazasında deneyin.

  3. Düzenli yedek alın: Dosya + veritabanı.

  4. İzin politikası: Dosyalar 644, klasörler 755; var/ altı yazılabilir. prestashop.com

  5. Önbellek stratejisi: Büyük değişikliklerden sonra cache temizliği rutine bağlansın. SiteGround

  6. Güncel intl/ICU ve gerekli eklentiler: Yerelleştirme ve tarih/sayı biçimleri için kritik. PrestaShop

SSS (Kısa)

500 hatası neden olur?
En çok modül/tema uyumsuzluğu, PHP sürüm/eklenti uyumsuzluğu, bozuk .htaccess, yanlış izinler ve bozuk cache yüzünden. Resmi yardım merkezi bu başlıkları kapsıyor. help-center.prestashop.com

Önbelleği elle nasıl temizlerim?
Yönetim yoksa var/cache/prod/* ve var/cache/dev/* içeriğini silin; ardından siteyi yenileyin. SiteGround

Friendly URL açıkken 500/404 alıyorum, ne yapmalıyım?
URL yeniden yazımı (mod_rewrite) aktif mi kontrol edin; Friendly URL’yi kapat–kaydet–aç–kaydet yaparak .htaccess’i yeniden oluşturun. docs.prestashop-project.org

Hangi PHP sürümünü kullanmalıyım?
PrestaShop 8 için öneri PHP 8.1’dir (güncel resmi dökümantasyona göre). PrestaShop

]]> https://saviorhost.com/blog/prestashopta-500-internal-server-error-hatasi-nedenleri-teshis-ve-0-cozum-kilavuzu/feed/ 0