Ana içeriğe geç

SSS ve Sorun Giderme

Kurulum Sorunları​

Kurulumdan sonra sayfa boş​

Boş beyaz bir sayfa, neredeyse her zaman sessizce bastırılan bir PHP hatasına işaret eder.

  1. Bir dosya yöneticisinde (hosting kontrol panelinizin Dosya Yöneticisi veya FTP) storage/logs/laravel.log dosyasını açın. Son birkaç satıra bakın — neyin yanlış gittiğini açıklayan bir hata mesajı olacaktır.
  2. Yaygın nedenler:
    • Eksik PHP uzantıları (gereksinimler sayfasını kontrol edin)
    • Yanlış dosya izinleri (aşağıdaki izinler bölümüne bakın)
    • Yapılandırma dosyasındaki yanlış veritabanı kimlik bilgileri

500 Internal Server Error​

Bu, sunucunun kendinden kurtulamadığı bir hatayla karşılaştığı anlamına gelir.

  1. Gerçek hata mesajı için storage/logs/laravel.log dosyasını kontrol edin.
  2. Web sunucunuzun hata günlüğünü kontrol edin — cPanel'de Günlükler → Hata Günlüğü altında bulunur.
  3. En yaygın nedenler:
    • Yanlış veritabanı kimlik bilgileri
    • Yapılandırma dosyasında APP_KEY değeri eksik veya çok kısa
    • Gerekli bir PHP uzantısı etkin değil

Yükleyici beni sürekli başa yönlendiriyor​

Bu genellikle yükleyicinin diske yazamadığı anlamına gelir. Kurulum işlemi tamamlandığında storage/installed.lock adlı bir dosya oluşturur. Bu dosyayı oluşturamazsa kurulumun hiç tamamlanmadığını düşünür.

Düzeltme: storage/ klasörünün ve içindeki her şeyin yazılabilir olduğundan emin olun. Hosting dosya yöneticinizde storage klasörüne sağ tıklayın ve izinleri 755 veya 775 olarak ayarlayın.

Veritabanı bağlantısı başarısız oldu​

Yükleyicideki hata mesajı "Connection refused" veya "Access denied" diyecektir.

  • Veritabanı ana bilgisayar adını, veritabanı adını, kullanıcı adını ve parolayı tekrar kontrol edin. Bunların hepsi cPanel'de veritabanı oluştururken ayarlanır.
  • cPanel hosting için veritabanı ana bilgisayar adı neredeyse her zaman localhost'tur.
  • Veritabanı kullanıcısının veritabanı üzerinde tam izinlere sahip olduğundan emin olun.

İzin hataları (storage veya cache'e yazılamıyor)​

LeadHub'ın belirli klasörlere yazması gerekir. Dosyaları yazamıyor hataları görüyorsanız:

Hosting dosya yöneticinizde, bu klasörlerin 755 iznine ayarlandığından emin olun (bazı hostlar 775 gerektirir):

  • storage/
  • storage/logs/
  • storage/framework/
  • storage/app/
  • bootstrap/cache/

E-posta Sorunları​

E-postalar gönderilmiyor​

  1. Ayarlar → E-posta bölümüne gidin ve tüm alanların doğru doldurulduğunu kontrol edin.
  2. Test E-postası Gönder'e tıklayın ve kendi e-posta adresinizi girin.
  3. Test e-postası gelmezse, herhangi bir SMTP hatası için storage/logs/laravel.log dosyasını kontrol edin.
  4. Cron job'ın çalıştığından emin olun — e-postalar işlemek için cron job'a ihtiyaç duyan iş kuyruğundan geçer. Aşağıdaki Cron Job bölümüne bakın.

E-postalar spam'e düşüyor​

  • En yaygın neden, "Gönderen E-posta" adresinin SMTP sağlayıcınız tarafından yetkilendirilmiş bir etki alanıyla eşleşmemesidir.
  • Etki alanınızın DNS ayarlarına SPF ve DKIM kayıtları ekleyin. E-posta sağlayıcınız (SendGrid, Mailgun vb.) tam olarak ne eklemeniz gerektiğini söyleyecektir.
  • İşlem e-postaları için Gönderen adresi olarak kişisel Gmail veya ücretsiz e-posta adreslerini kullanmaktan kaçının. Profesyonel bir gönderim hizmeti kullanın.

Test e-postası başarısız oluyor​

  • SMTP kimlik bilgilerinizi kontrol edin — tek bir yanlış karakter başarısızlığa neden olur.
  • Gmail için normal parolanızı değil Uygulama Parolası kullanmanız gerekir.
  • Paylaşımlı hostingde 587 portu engellenmiş olabilir. Bunun yerine SSL ile 465 portunu deneyin.
  • Kullandığınız portta giden SMTP'ye izin verilip verilmediğini hosting sağlayıcınıza sorun.

Cron Job Sorunları​

Otomasyonlar çalışmıyor / Raporlar teslim edilmiyor​

LeadHub tüm arka plan işlerini işlemek için bir cron job kullanır: otomasyonlar, e-posta gönderimi, rapor teslimi ve zamanlanmış görevler.

Cron job komutu:

php /path/to/your/leadhub/cron.php

/path/to/your/leadhub/ kısmını sunucunuzdaki gerçek yol ile değiştirin.

cPanel'de ayarlamak için:

  1. cPanel'e giriş yapın.
  2. Cron Jobs bölümüne gidin.
  3. Sıklığı Her Dakika olarak ayarlayın (beş alanın tümüne * girin).
  4. Komut: php /home/yourusername/public_html/cron.php
  5. Yeni Cron Job Ekle'ye tıklayın.

Yoldan emin değilseniz hosting sağlayıcınızla kontrol edin veya sitenizin kök klasörüne gittiğinizde cPanel Dosya Yöneticisinde gösterilen tam yola bakın.

Çalıştırılacak başka komut yoktur. Cron'dan artisan komutları çalıştırmaya çalışmayın — yalnızca cron.php kullanın.

Cron job'ın çalışıp çalışmadığını nasıl kontrol ederim​

cPanel'de Cron Jobs bölümüne gidin ve oluşturduğunuz cron job'a bakın. Orada listeleniyorsa zamanlanmıştır. Gerçekten çalışıp çalışmadığını doğrulamak için komutun sonuna geçici olarak >> /tmp/crontest.log 2>&1 ekleyebilir, bir dakika bekleyip dosyayı çıktı için kontrol edebilirsiniz.

Lead Kaynak Sorunları​

Webhook lead almıyor​

  1. Dış serviste (Facebook, Typeform vb.) yapılandırdığınız webhook URL'sinin, sonundaki token dahil, tam olarak doğru olduğunu kontrol edin.
  2. LeadHub'da entegrasyon veya lead kaynağı ayarlarına gidin ve "Test" veya "Ping" düğmesi arayın — bağlantıyı doğrulamak için kullanın.
  3. Gelen webhook hataları için storage/logs/laravel.log dosyasını kontrol edin.
  4. Sunucunuzun internetten erişilebilir olduğundan emin olun (gelen bağlantıları engelleyen bir güvenlik duvarının arkasında değil).

IMAP gelen kutusu yoklanmıyor​

IMAP yoklaması (lead'ler için bir e-posta gelen kutusunu kontrol etme) cron job'ın çalışmasını gerektirir. Yukarıdaki Cron Job bölümüne bakın. Cron job çalışıyor ancak IMAP hâlâ yoklanmıyorsa:

  1. Entegrasyon yapılandırmasındaki IMAP bağlantı ayarlarını kontrol edin.
  2. Sunucunuzda php-imap PHP uzantısının yüklü olduğundan emin olun.
  3. IMAP bağlantı hataları için storage/logs/laravel.log dosyasını kontrol edin.

Paylaşımlı Hostingde Performans Sorunları​

Uygulama yavaş veya zaman aşımına uğruyor​

Paylaşımlı hostingin sınırlı kaynakları vardır. Yapabileceğiniz birkaç şey:

PHP bellek sınırını artırın: Sitenizin kök klasöründeki .htaccess dosyasına şu satırı ekleyin:

php_value memory_limit 256M

Ya da PHP ayarlarınızda artırması için hosting sağlayıcınızdan isteyin.

Önbelleği etkinleştirin: Yapılandırma dosyanızda CACHE_DRIVER=file veya CACHE_DRIVER=database bulunduğundan emin olun. Bunlar paylaşımlı hostingde ek kurulum gerektirmeden çalışır.

Kuyruk toplu iş boyutlarını azaltın: Sunucunuz büyük içe aktarmalar veya toplu işlemlerle zorlanıyorsa daha küçük gruplar halinde işleyin.

Günlükleri Nasıl Kontrol Ederim​

Ana günlük dosyası şurada bulunur:

storage/logs/laravel.log

Hosting dosya yöneticinizde bu dosyaya gidip açmak için tıklayarak görüntüleyebilirsiniz. Dosyanın altına bakın — en son hatalar orada görünür.

Günlük dosyası zamanla büyüyebilir. Güvenle silebilirsiniz (uygulama otomatik olarak yeni bir tane oluşturur).

Önbelleği Nasıl Temizlerim​

Eski veriler veya son değişiklikleri yansıtmayan sayfalar görüyorsanız, önbelleği temizlemek yardımcı olabilir.

Bunu hosting dosya yöneticinizden yapın:

  1. bootstrap/cache/ dizinine gidin
  2. Bu klasörün içindeki tüm dosyaları silin (klasörün kendisini değil)
  3. storage/framework/cache/data/ dizinine gidin
  4. Bu klasörün içindeki tüm dosya ve alt klasörleri silin

Önbellek bir sonraki sayfa yüklemesinde otomatik olarak yeniden oluşturulur.

Klasörlerin kendisini silmeyin — yalnızca içeriği silin.

Yükleyiciyi Yeniden Nasıl Çalıştırırım​

Kurulum sihirbazından yeniden geçmeniz gerekiyorsa (örneğin yeni bir veritabanına taşındıktan sonra):

  1. Hosting dosya yöneticinizde storage/ klasörüne gidin.
  2. installed.lock adlı dosyayı silin.
  3. Sitenizi bir tarayıcıda ziyaret edin — yükleyici otomatik olarak başlayacaktır.

Bu verilerinizi silmez. Sadece yükleyicinin tekrar çalışmasına izin verir. Veritabanınız ve dosyalarınız bozulmadan kalır.

Yapılandırma Dosyasındaki Yaygın Hatalar​

Sitenizin kök klasöründeki yapılandırma dosyası (.env) birçok ayarı kontrol eder. Yaygın hatalar:

  • APP_KEY eksik — bu 32 karakterlik rastgele bir dize olmalıdır. Eksik veya yanlışsa uygulama başlamaz.
  • DB_HOST yanlış — paylaşımlı hosting için bu neredeyse her zaman localhost'tur. Alan adınızı kullanmayın.
  • = etrafında boşluklar — biçim KEY=value şeklinde boşluksuz. KEY = value çalışmaz.
  • Özel karakterler içeren tırnak işareti olmayan değerler — veritabanı parolanız # veya & içeriyorsa tüm değeri çift tırnak içine alın: DB_PASSWORD="my#p@ss&word"

Yardım Alma​

Bu belgeleri kullanarak bir sorunu çözemiyorsanız:

  1. Önce günlük dosyasını kontrol edin storage/logs/laravel.log adresinde. Oradaki hata mesajı genellikle neyin yanlış olduğunu tam olarak söyler.
  2. CodeCanyon yorumlarını arayın LeadHub ürün sayfasında — birçok yaygın sorun orada yanıtlanmıştır.
  3. CodeCanyon'da bir destek talebi açın LeadHub ürün sayfasına gidip Destek'e tıklayarak. Bunu yaparken günlük dosyanızın ilgili bölümünü ekleyin.

Desteğe ulaşırken her zaman şunları ekleyin:

  • Hosting ortamınız (paylaşımlı hosting / VPS, hangi sağlayıcı)
  • Sunucunuzun çalıştırdığı PHP sürümü
  • storage/logs/laravel.log dosyasının son birkaç satırı