OpenCart ile çalışan herkesin bir gün mutlaka karşılaştığı hatalardan biri HTTP 500 Internal Server Error problemidir. Bu hata, sitenin tamamen çökmesine kadar gidebildiği için panik yaratır; ama merak etme, altında yatan sebepler genellikle çözülebilir türdendir. Bu makalede, OpenCart’ta 500 hatasının neden ortaya çıktığını, nasıl tespit edileceğini ve adım adım nasıl çözüleceğini pratik şekilde anlatıyoruz.

HTTP 500 Hatası Nedir?

HTTP 500 hatası, sunucunun isteği işleyemediği anlamına gelir. Yani sorun tarayıcıda değil, sunucu tarafındadır. Bu hata OpenCart'ta genellikle:

  • Bozuk bir eklenti

  • Hatalı bir tema dosyası

  • PHP uyumsuzlukları

  • Eksik dosyalar

  • Yanlış izinler

  • Bellek limitleri

gibi konulardan kaynaklanır.

1. Hata Loglarını Açın (En Kritik Adım)

OpenCart 3.x ve 2.x sürümlerinde yönetim paneline girebiliyorsan şu yolu izle:

Sistem → Bakım → Hata Kayıtları

Ama çoğu zaman 500 hatasında panele bile girilmez. O yüzden FTP üzerinden:

/system/storage/logs/error.log

veya

/system/logs/error.log

dosyasını kontrol edin.

Log dosyasındaki en son satır genellikle sorunun kaynağıdır.

2. PHP Sürümünü Kontrol Edin

OpenCart sürümünüz hangi PHP versiyonunu destekliyorsa onunla çalışmalısınız.
Örneğin:

  • OpenCart 3.0.2.0 → PHP 7.2 - 7.4 önerilir

  • OpenCart 2.3.x → PHP 5.6 - 7.0

Hatalı PHP sürümü = kesin 500 error.

Hosting panelinden PHP versiyonunu bir tık aşağı/yukarı alıp tekrar deneyin.

3. Eklenti (Extension) veya OCMOD Çakışması

Yeni bir modül yükledikten sonra siten çöktüyse %90 ihtimalle sebep OCMOD’dur.

Çözüm:

FTP üzerinden:

/system/storage/modification/

klasörünün içini komple silin.
Sonra yönetim paneline girip:

Eklentiler → Modifikasyonlar → Yeniden Oluştur (Refresh) butonuna basın.

Panel açılmıyorsa:

/vqmod/vqcache/

klasörünü temizleyin (varsa).

4. Tema Dosyası Kaynaklı Hatalar

Özellikle Journal 3, Fastor gibi ağır temalarda ufak bir dosya hatası bile 500 error sebebi olur.

Kontrol edilmesi gereken klasörler:

/catalog/view/theme/TEMAADI/
/catalog/controller/
/catalog/model/

Son yüklediğiniz dosyayı geri alın veya temayı varsayılana döndürerek test edin.

5. .htaccess Dosyası Bozuk Olabilir

OpenCart'ın çalışması için doğru .htaccess dosyası şarttır.

Sitenizdeki .htaccess dosyasını geçici olarak .htaccess_old yapın.
Eğer site açılırsa sorun dosyadadır.

Orijinal OpenCart .htaccess içeriğini kullanarak yenileyin.

6. Dosya İzinleri (CHMOD) Yanlış Olabilir

Bazı sunucularda izin hataları 500 error’a yol açar.

OpenCart için ideal izinler:

Dosyalar → 644
Klasörler → 755
config.php → 444
admin/config.php → 444

Özellikle şu iki dosyanın izinlerini kontrol edin:

config.php
admin/config.php

7. Memory Limit ve Upload Limitleri

Sunucunun bellek limiti düşükse site hata verebilir.

PHP.ini veya hosting panelinizde:

memory_limit = 512M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

yapmanız önerilir.

8. Bozuk Bir Kod Parçası (PHP Syntax Hatası)

Son düzenlediğiniz dosyayı mutlaka kontrol edin. Bir tane bile ; eksik olsa 500 hatası verir.

En yaygın problem alanları:

  • controller dosyaları

  • model dosyaları

  • theme Twig değişiklikleri

  • eklenen custom PHP kodları

IDE kullanıyorsanız (VSCode gibi), dosyayı açtığınız anda hatayı gösterir.

9. Cron Job veya API Hataları

Bazen cron görevleri veya API çağrıları da 500 hatasına sebep olur.
error.log bunu söylüyorsa ilgili cron adresini devre dışı bırakıp tekrar test edin.

10. Hosting Kaynaklı Problemler

Bazı zamanlarda sorun tamamen sunucudadır:

  • ModSecurity engelliyor olabilir

  • Nginx/Apache çakışması olabilir

  • Sunucu bellek yetmiyor olabilir

  • Cloudflare yönlendirmesi yanlış olabilir

Hosting destek birimine "500 error alıyorum, error log gönderir misiniz?" diye yazmanız yeterlidir.


11. Üye Kayıtta 500 Error

Sistem/mağazalar alanında e-posta sekmesine geçerek smtp ayarlarınızı eksiksiz yaptığınızdan emin olun. Smtp alanına girdiğiniz mailin aynısı veri sekmesindeki mail alanında da olması gerekir aksi taktirde çalışmaz. Yapılmayan smtp ayarlarında veya yanlıs yapılan smtp ayarlarında üye olamama, sipariş verememe gibi sorunlar yaşamanız muhtemeldir. Eğer sitee üye olurken 500 error hatası alıyorsanız bilinki smtp ayarlarını eksik veya yanlıştır.

OpenCart'ta HTTP 500 hatası ilk bakışta büyük bir sorun gibi görünse de, genellikle birkaç temel noktayı kontrol ederek çözülebilir:

  • Log dosyaları

  • PHP sürümü

  • Modifikasyonlar

  • Tema dosyaları

  • .htaccess

  • Sunucu ayarları

Bu rehber yardımıyla, sorunun kaynağını çok daha hızlı tespit edebilir ve siteyi yeniden ayağa kaldırabilirsiniz.