Skip to main content
Kurulum sırasında bir hata mı aldınız? Panik yok — GurStore standart bir Laravel uygulaması olduğundan hataların neredeyse tamamı birkaç bilinen nedenden kaynaklanır. En sık karşılaşılan durum olan HTTP 500 ile başlayalım.

​
HTTP 500 — “Bu sayfa çalışmıyor”

https://magazaniz.com veya /install açıldığında HTTP ERROR 500 görüyorsanız, uygulama çalışıyor ama başlangıçta bir şeye takılıyor demektir. Sırasıyla şunları kontrol edin.

​
Adım 1 — Gerçek hatayı görün

500 hatası varsayılan olarak ayrıntıyı gizler. Gerçek nedeni iki şekilde görebilirsiniz:
Dosyalarınızda şu dosyayı açın ve en alttaki (en yeni) satırlara bakın:
Buradaki hata mesajı (ör. Permission denied, could not find driver, No application encryption key) size tam olarak neyin yanlış olduğunu söyler. Aşağıdaki bölümlerde bu mesajların çözümleri var.

​
Adım 2 — En sık 4 neden ve çözümü

Belge kökü (document root) uygulamanın public klasörünü göstermelidir. Kök klasörü gösteriyorsa 500 veya bozuk sayfa alırsınız.Tarayıcıda https://magazaniz.com/index.php yerine kaynak kodu (ör. .env içeriği) görüyorsanız, kesinlikle document root yanlıştır.
Log’da Permission denied veya failed to open stream ... storage/logs görüyorsanız izin sorunudur.
  • storage ve bootstrap/cache klasörlerine 755 (veya 775) izni verin; storage için alt klasörlere de uygulayın (Recurse).
  • VPS’te: sudo chown -R www-data:www-data /var/www/gurstore && sudo chmod -R 775 storage bootstrap/cache
Log’da No application encryption key has been specified görüyorsanız:
  • Dosyalar arasında .env yoksa, .env.example dosyasını .env olarak kopyalayın.
  • Ardından bir uygulama anahtarı üretin. SSH varsa:
    SSH yoksa .env içindeki APP_KEY= satırına 32 karakterlik rastgele bir değeri base64:... biçiminde eklemeniz gerekir; en kolayı hosting sağlayıcınızdan SSH/terminal desteği istemektir.
Genellikle GurStore paketi bir .env ile gelir ve sihirbaz gerisini yazar; bu adım yalnızca .env hiç yoksa gerekir.
Log’da could not find driver (PDO/veritabanı sürücüsü) veya Call to undefined function (eksik eklenti) görüyorsanız:
  • PHP sürümünü 8.2+ (8.3 önerilir) yapın.
  • Şu eklentileri etkinleştirin: pdo, openssl, mbstring, curl, tokenizer, xml, fileinfo, bcmath, json, gd/imagick.
  • cPanel’de: Select PHP Version → Extensions. Plesk’te: PHP Settings.
Tam liste: Genel Bakış → Sistem Gereksinimleri.

​
Sayfanın Tamamı Boş (Beyaz Ekran)

Hiç içerik gelmiyor, hata da yok. Genellikle APP_DEBUG=false ile gizlenmiş bir 500’dür. Yukarıdaki Adım 1’i uygulayıp storage/logs/laravel.log’a bakın.

​
404 — Ana sayfa açılıyor ama diğer sayfalar “Not Found”

Ana sayfa gelir ama /install, /admin gibi yollar 404 verirse, Apache’de mod_rewrite kapalı veya .htaccess yok sayılıyor demektir.
1

.htaccess dosyasının varlığını doğrulayın

public/.htaccess dosyasının var olduğundan emin olun (File Manager’da gizli dosyaları göster).
2

mod_rewrite / AllowOverride

Paylaşımlı hostinglerde mod_rewrite genelde açıktır; kapalıysa hosting desteğine açtırın. VPS’te Apache kullanıyorsanız AllowOverride All olmalı (veya Nginx yapılandırmasında try_files satırı).

​
403 — Forbidden

  • Belge kökü doğru klasörü (public) gösteriyor ama index.php yerine dizin listesi engelleniyor olabilir. Document root’un public klasörünün kendisi olduğundan emin olun.
  • public içinde index.php dosyasının bulunduğunu doğrulayın (arşiv eksik çıkmış olabilir).

​
SSL / Cloudflare Hataları (525, 526, Yönlendirme Döngüsü)

Cloudflare’de turuncu bulut (Proxied) açıksa ve sunucunuzda geçerli SSL yoksa 525/526 ya da sonsuz yönlendirme alırsınız.
1

Önce DNS only ile ilerleyin

Cloudflare DNS → Records’ta kaydı DNS only (gri bulut) yapın, kurulumu tamamlayın.
2

SSL modunu Full (strict) yapın

Sunucunuza Let’s Encrypt SSL kurduktan sonra Cloudflare SSL/TLS → Overview → Full (strict) seçin, ardından isterseniz turuncu buluta geçin.
Ayrıntı: Alan Adı & DNS.

​
”Lisans” / “Lisanssız” Uyarısı

Kurulum bitti ama site kilitli veya lisans hatası veriyorsa:
  • Kurulum yöntemi sayfanızdaki cron (zamanlanmış görev) adımını uyguladığınızdan emin olun — lisans arka planda cron ile yenilenir.
  • Sunucunuzun dışarıya (özellikle api.gurstore.net) bağlantı yapabildiğini doğrulayın; bazı sunucular giden bağlantıları engeller.
  • Ayrıntı: Lisans & Etki Alanı.

​
/install Sayfası Açılmıyor / “Zaten kurulu” diyor

Kurulum bir kez tamamlandığında /install güvenlik için kilitlenir. Kurulumu yeniden çalıştırmanız gerekiyorsa (ör. yanlış veritabanı girdiniz), hosting/SSH erişiminizle kurulum kilidini kaldırmak için destek ekibimizle iletişime geçin.

​
Hâlâ Çözülmediyse

Aşağıdakileri hazırlayıp destek ekibimize iletin; çok daha hızlı yardımcı oluruz:

laravel.log çıktısı

storage/logs/laravel.log dosyasının son 20–30 satırı.

Ortam bilgisi

PHP sürümü, hosting türü (cPanel/Plesk/VPS) ve alan adınız.

Ne denediniz?

Hangi adımda takıldığınız ve ekranda görünen tam hata metni.

Bize ulaşın

gurstore.net/contact veya Discord.