İçeriğe geç

Sorun giderme

title: Sorun giderme description: Sık karşılaşılan belirtiler, olası sebepleri ve çözümleri: beyaz sayfa, 403 ve "Forbidden", modül etkinleşmiyor, güncelleme sorunları, e-posta, önbellek, CSP ve diğerleri.

Bu sayfa belirtiden çözüme gider. Her durumda ilk üç adım aynıdır:

  1. AACP → Sistem → Karantina: bir modül hata verdi mi?
  2. cp-core/var/log/module_quarantine.log ve uygulama günlüğü (AACP → Bakım → Günlükler).
  3. php cp-core/bin/console cp:doctor: sistem sağlığı.

Site açılmıyor

Belirti Sebep Çözüm
Beyaz sayfa / 500 Önbellek bozuk ya da bir dosya eksik cp-core/var/cache/prod/ içini boşaltın. Sorun sürerse sunucu PHP hata günlüğüne bakın
"Kurulum sihirbazı" çıkıyor .env yok ya da kurulum kilidi eksik Dosyalar yanlış klasörde olabilir; belge kökünü ve .env'in varlığını kontrol edin
The metadata storage is not up to date DATABASE_URL'deki serverVersion gerçek sunucuyla uyuşmuyor MariaDB için serverVersion=mariadb-<sürüm> yazın
Her sayfa 503 Bakım modu açık ya da güncelleme yarım kaldı Bakım modunu kapatın; güncelleme kilidini ve cp-core/var/update/ durumunu kontrol edin. Süreç ortada ölmüşse bir sonraki istek kendini toparlar
Veritabanı bağlantı hatası DATABASE_URL yanlış / sunucu kapalı Kurtarma konsolu (/aacp/recovery, token tanımlıysa) veritabanı olmadan açılır
PHP sürüm hatası Sunucuda PHP < 8.4 PHP 8.4'e geçin

Yönetim paneline giremiyorum

  • Parolamı unuttum: giriş sayfasındaki sıfırlama bağlantısı (e-posta ayarlıysa). Değilse komut satırından cp:user:create-admin ile yeni yönetici açın.
  • Çok fazla başarısız deneme: hesap/IP geçici kilitlenir (varsayılan 15 dakika). Bekleyin ya da kurtarma konsolundan yönetin.
  • AACP "kapı sorusu" soruyor: AACP kapısı (isteğe bağlı) açık; cevabı yöneticiden isteyin.
  • 2FA kodu kabul edilmiyor: cihaz saatinin doğru olduğundan emin olun (zaman tabanlı kod).
  • WAF yüzünden engellendim: AACP → Güvenlik Merkezi → Canlı tehditler (ayarlar: Telemetri ayarları); IP'yi izinli listeye ekleyin ya da yasağı kaldırın. Kendinizi kilitlediyseniz kurtarma konsolu WAF'tan muaftır.

"Forbidden" / 403

Bağlam Anlam
Bir yazı gönderirken (forum, blog, belge) WAF yazı içeriğinde tehlikeli görünen bir kalıp bulmuş olabilir (örn. ../, .env). Yazı alanları dar bir muafiyetle korunur; yine takılıyorsa yolu muafiyet listesine eklenmesi için geliştiriciye bildirin
Yönetim ekranında Yeteneğiniz yok: roldeki yeteneği kontrol edin
Form gönderirken CSRF belirteci süresi dolmuş: sayfayı yenileyip tekrar deneyin
Sunucu düzeyi Web sunucusu (ModSecurity, Imunify360, Cloudflare) engelliyor olabilir: stilli bir hata sayfası görüyorsanız budur; hosting panelinden IP'yi açın ya da sunucu günlüğüne bakın
Tüm siteye düz "Forbidden" (yalnızca siz) IP'niz yasaklanmış olabilir (WAF otomatik yasağı). Panelden Güvenlik Merkezi → Genel bakış'tan ya da veritabanında DELETE FROM cp_banned_ips WHERE ip_address = '...'; ile kaldırın; ayrıntı: Modül belgeleri → "Güvenlik ve IP engelleri"

WAF'ı kapatmayın; olayları AACP → Güvenlik Merkezi → Canlı tehditler (ayarlar: Telemetri ayarları)'den inceleyip dar bir çözüm uygulayın.

Modül sorunları

Belirti Çözüm
"requires CPalius core X but Y is installed" Önce çekirdeği güncelleyin; modül core_version aralığı çekirdeği desteklemiyor
"unmet dependencies" Modülün gerektirdiği başka bir modülü önce etkinleştirin
Modül etkinleşmiyor, derleme hatası Mesaj dosya/satırı söyler (YAML girintisi, eksik sınıf); modül yazarına iletin
Menüde modül öğesi yok Rolünüzün yeteneği var mı; önbelleği temizleyin
Modül sayfası boş Karantina ve module_quarantine.log; hook'ları hata veriyor olabilir
Modül tablosu yok cp:doctor "modül SQL tutarlılığı" bulgusu; modül yazarına bildirin

Güncelleme sorunları

Belirti Çözüm
"Güncelle" düğmesi pasif Kartın altındaki sebebe bakın: imza doğrulanamadı / süresi dolmuş, PHP zip eklentisi yok, cp-core yazılabilir değil
"İmza süresi doldu" Yayıncı tarafında imza yenilenmeli; sizin yapacağınız bir şey yok, birkaç saat sonra tekrar deneyin
Güncelleme hata verdi Sistem dosyaları ve veritabanını otomatik geri aldı; hata mesajını ve cp-core/var/update/ günlüklerini saklayıp destek ile paylaşın
Güncelleme sonrası site garip cp-core/var/cache/prod/ boşaltın; Redis kullanıyorsanız temizleyin; cp:doctor çalıştırın
Güncelleme sonrası yeni özellik yok Modülün sürümü eski: mağazadan modülü de güncelleyin; cp:update çalıştırın

E-posta gitmiyor

  1. E-posta ayarı açık mı (varsayılan kapalı)?
  2. SMTP bilgisi doğru mu? AACP'den test e-postası gönderin.
  3. AACP → Bakım → Günlükler → E-posta günlüğü: gönderim hatası var mı? Başarısız olanlar buradan yeniden gönderilebilir.
  4. Kuyruk işçisi çalışıyor mu? (E-postalar kuyruğa girer.) AACP → Otomasyon → Kuyruk.
  5. Alan adınızda SPF/DKIM/DMARC kayıtları doğru mu? (Spam klasörüne düşebilir.)

Zamanlanmış işler çalışmıyor

Zamanlanmış yayın, SEO görevleri, özet e-postaları gibi her şey cron'a bağlıdır.

  • Sunucuda * * * * * php /yol/cp-core/bin/console cp:cron:run satırı var mı?
  • AACP → Otomasyon → Cron: son çalışma zamanları güncel mi?
  • Cron yoksa token'lı HTTP cron ucunu bir dış zamanlayıcıyla çağırın.
  • Aynı iş hâlâ çalışıyorsa yeni çalışma atlanır (çakışma kilidi): bu normaldir.

Görsel yüklenmiyor

  • Dosya türü izinli mi (JPEG, PNG, GIF, WebP, AVIF, BMP, TIFF, HEIC, ICO, PDF, MP4, WebM, OGG video, MOV, MKV)? SVG, HTML, arşiv türleri bilerek reddedilir.
  • Boyut sınırı: Medya ayarı ve sunucudaki upload_max_filesize / post_max_size.
  • public/uploads yazılabilir mi?

Sayfa değişikliği görünmüyor

  • Tarayıcıyı sert yenileyin (Ctrl+F5).
  • Kaynak HTML önbelleği: içerik kaydında ilgili sayfalar otomatik temizlenir; yine de eski görünüyorsa önbelleği panelden temizleyin.
  • Varnish/CDN önündeyse onun önbelleğini de temizleyin.
  • Tema dosyası değiştiyse Twig önbelleği için cache:clear.

Konsolda CSP uyarıları

CSP varsayılan olarak rapor modundadır: ihlaller engellenmez, yalnızca raporlanır ve konsolda görünür. Bir dış kaynağı gerçekten kullanmanız gerekiyorsa AACP → Güvenlik → CSP ayarlarında izin verin (csp_script_src, csp_img_src …). enforce moduna geçmeden önce rapor kayıtlarını inceleyin.

Yavaşlık

  • AACP → Bakım → Performans: Redis/Varnish durumları.
  • Geliştirme ortamında N+1 istisnası aldıysanız ilgili ekranda sorgu sayısını azaltın (geliştirici işi).
  • Sayfa önbelleği açık mı? Anonim trafik oturum açmamalı (oturumlu yanıt önbelleğe alınamaz).

Destek isterken ne vermeli

  1. CPalius sürümü (AACP panosunda).
  2. PHP sürümü ve sunucu türü (Apache/Nginx, paylaşımlı/VPS).
  3. cp:doctor çıktısı.
  4. module_quarantine.log ve ilgili günlük satırları (parola ve token içermediğinden emin olun).
  5. Sorunu yeniden üretme adımları.
Son güncelleme: 13.10.2026