Sorun giderme

Çoğu sorun birkaç nedene indirgenebilir: PHP sürümü, dosya izinleri, veritabanı kimlik bilgileri, web sunucusu URL yeniden yazması veya eksik bir işçi. Bu sayfa, operatörlerin en sık karşılaştığı belirtileri ve her birinin nasıl düzeltileceğini listeler. Şüphe duyduğunuzda, PHP hata günlüğü gerçeğe ulaşmanın en hızlı yoludur.

Kurulum sorunları

"PHP sürümünüz desteklenmiyor"

TubePress, her şeyden önce çalışan ayrıştırma güvenli bir sürüm koruyucusu tarafından zorunlu kılınan PHP 8.2 veya daha yenisini gerektirir. Barındırma panelinizde PHP sürümünü değiştirin (veya vhost'u daha yeni bir PHP-FPM soketine yönlendirin) ve yeniden yükleyin. Bkz. Gereksinimler.

"Veritabanına bağlanılamadı"

Yükleyicinin veritabanı adımında, sunucuyu (genellikle localhost veya 127.0.0.1), veritabanı adını, kullanıcı adını ve parolayı ve kullanıcının o veritabanında ayrıcalıklara sahip olduğunu iki kez kontrol edin. Veritabanı önceden mevcut olmalıdır — yükleyici tabloları oluşturur, şemanın kendisini değil.

Yükleyici yapılandırmayı yazamıyor / "yazılamaz" hatası

Web sunucusunun kurulum sırasında config/ ve storage/ dizinlerine yazma erişimi gerekir. Bu dizinleri PHP kullanıcısı tarafından yazılabilir yapın ve ardından tekrar deneyin. Kurulum'daki izin kılavuzuna bakın.

Kurulumu bitirdim ancak /install hâlâ yükleniyor

Kurulum, config/installed.php dosyasını yazar. Bu dosya eksikse uygulama kurulmamış olduğunu düşünür; kurulum tamamlandıysa bu dosya mevcut olmalı ve yükleyici kendini kilitlemelidir. config/ dizininin yazılabilir olduğunu yeniden kontrol edin.

Site yükleniyor ancak sayfalar 404 hatası veriyor

Ana sayfa çalışıyor ancak diğer tüm URL'ler 404 hatası döndürüyorsa, URL yeniden yazma işlemi ön denetleyiciye ulaşmıyor demektir.

• Apache — mod_rewrite'ın etkinleştirildiğini ve dahili .htaccess'in geçerli olması için AllowOverride All'un ayarlandığını doğrulayın.
• Nginx — location / bloğunuz ön denetleyiciye geçmelidir; örn. try_files $uri $uri/ /index.php?$query_string;. Web sunucusu notları için Mimari'ye bakın.

Giriş & yönetici erişimi

Yönetici girişini bulamıyorum

Güvenlik için özel bir yönetici URL'si belirlediyseniz, panel artık /admin'de bulunmaz — yalnızca gizli yolunuzda yanıt verir. Veritabanı erişiminiz varsa settings tablosundan kurtarın. Bkz. Güvenlik.

İki faktörlü kimlik doğrulama beni kilitledi

Kimlik doğrulayıcınızı kaybederseniz, erişimi yeniden kazanmak için veritabanında kullanıcının TOTP'sini (users tablosundaki ilgili sütun) devre dışı bırakın, ardından yeniden kaydolun. Ayrıntılar için Güvenlik'e bakın.

Yüklemeler & medya

Büyük dosya yüklemeleri başarısız oluyor veya zaman aşımına uğruyor

PHP limitlerini upload_max_filesize ve post_max_size şeklinde artırın ve Nginx'te client_max_body_size'ı yükseltin. Demo, yüksek bir client_max_body_size aracılığıyla gigabayt boyutunda yüklemelere izin verir; büyük dosyalar için sunucunuzda bunu yansıtın.

Bir video oynatılmıyor

Yeni yüklenen videolar, dönüştürme tamamlanana kadar hâlâ işleniyor olabilir. Formatın web'de oynatılabilir olduğunu, rendition dosyalarının depolamada mevcut olduğunu ve sunucunuzun .mp4/.webm için doğru MIME türünü gönderdiğini doğrulayın. Bkz. Oynatıcı.

Küçük resimler veya önizlemeler eksik

Küçük resim ve önizleme oluşturma, GD veya Imagick uzantısına (ve videodan türetilmiş kareler için FFmpeg'e) ihtiyaç duyar. Bunların yüklü olduğunu ve uploads/ dizininin yazılabilir olduğunu doğrulayın.

Dönüştürme işlemi takılı kaldı

İşler kuyrukta bekliyor ve hiç tamamlanmıyorsa:

• Dönüştürmenin çalıştığı yerde (yerel sunucu veya uzak bir işçi) FFmpeg'in yüklü olduğunu doğrulayın.
• Uzak dönüştürme sunucuları kullanıyorsanız, işçinin çalıştığını ve API anahtarının yönetici panelinde yapılandırılan anahtarla eşleştiğini kontrol edin.
• Zamanlayıcının çalıştığından emin olun (aşağıya bakın) — iş gönderimi ve yeniden deneme pseudo-cron üzerinde çalışır.

Zamanlanmış görevler çalışmıyor

Pseudo-cron yalnızca sayfa oluşturmalarında tetiklenir. Düşük trafikli bir sitede heartbeat onu canlı tutar — heartbeat_enabled'ın 1 olduğundan emin olun. Devre dışı bıraktıysanız, ya yeniden etkinleştirin ya da sitenize periyodik olarak istek gönderen bir sistem cron girişi ekleyin.

E-posta gönderilmiyor

E-posta & bildirimler bölümünden SMTP'yi yapılandırın ve onaylamak için yerleşik Test e-postası gönder düğmesini kullanın. Testler başarısız olursa, SMTP sunucusu/port/kimlik bilgilerini ve barındırma sağlayıcınızın giden postaya izin verdiğini doğrulayın; teslim edilebilirlik için etki alanınıza SPF/DKIM ayarlayın.

Performans

Ölçekte hızlı bir site için: OPcache'i etkinleştirin, PHP'ye yeterli bellek verin, MySQL'i PHP ile aynı ağda tutun ve CTR yeniden hesaplaması ile diğer zamanlanmış görevlerin çalışmasına izin verin. TubePress, büyük kütüphaneler için gereken dizinler ve parçalanmış işlerle birlikte gelir — bkz. Bakım.

Güncellemeler başarısız oluyor

Bir güncelleme uygulanamıyorsa, temel dosyaların PHP kullanıcısı tarafından yazılabilir olduğunu ve PHP 8.2+ kullandığınızı doğrulayın. Geri alabilmek için güncellemeden önce her zaman yedek alın. Bkz. Güncelleme.

Hâlâ takıldınız mı?

Tam hata mesajını ve ilgili günlük satırlarını toplayın, ardından panonuzdan veya yönetici panelindeki destek widget'ından bir bilet açın. Ne kadar fazla bağlam eklerseniz — PHP sürümü, web sunucusu ve ne yaptığınız — sorun o kadar hızlı çözülür. Bkz. Duyurular & destek.