Rozwiązywanie problemów

Większość problemów sprowadza się do kilku przyczyn: wersja PHP, uprawnienia plików, dane dostępowe do bazy danych, przepisywanie adresów URL przez serwer WWW lub brakujący proces roboczy. Ta strona zawiera listę najczęstszych objawów napotykanych przez administratorów oraz sposoby ich rozwiązania. W razie wątpliwości dziennik błędów PHP to najszybsza droga do prawdy.

Problemy z instalacją

„Twoja wersja PHP nie jest obsługiwana"

TubePress wymaga PHP 8.2 lub nowszego, co jest egzekwowane przez bezpieczną strażnicę wersji uruchamianą przed wszystkim innym. Zmień wersję PHP w panelu hostingowym (lub wskaż vhost na nowszy socket PHP-FPM) i przeładuj. Zobacz Wymagania.

„Nie można połączyć się z bazą danych"

Na etapie konfiguracji bazy danych w instalatorze dokładnie sprawdź hosta (często localhost lub 127.0.0.1), nazwę bazy danych, użytkownika i hasło, a także czy użytkownik ma uprawnienia do tej bazy. Baza danych musi już istnieć — instalator tworzy tabele, ale nie samą bazę.

Instalator nie może zapisać konfiguracji / błąd „not writable"

Serwer WWW potrzebuje uprawnień do zapisu w katalogach config/ i storage/ podczas konfiguracji. Nadaj tym katalogom uprawnienia do zapisu przez użytkownika PHP, a następnie spróbuj ponownie. Zobacz wskazówki dotyczące uprawnień w Instalacji.

Zakończyłem instalację, ale /install nadal się ładuje

Instalacja tworzy plik config/installed.php. Jeśli go brakuje, aplikacja uważa, że nie jest zainstalowana; jeśli konfiguracja została ukończona, plik ten powinien istnieć, a instalator blokuje się sam. Sprawdź ponownie, czy katalog config/ był zapisywalny.

Strona ładuje się, ale strony zwracają 404

Jeśli strona główna działa, ale każdy inny adres URL zwraca 404, przepisywanie URL nie dociera do kontrolera frontowego.

• Apache — upewnij się, że moduł mod_rewrite jest włączony, a dyrektywa AllowOverride All jest ustawiona, aby dołączony plik .htaccess był respektowany.
• Nginx — blok location / musi przekazywać żądania do kontrolera frontowego, np. try_files $uri $uri/ /index.php?$query_string;. Zobacz Architekturę w celu uzyskania uwag dotyczących serwera WWW.

Logowanie i dostęp do panelu administracyjnego

Nie mogę znaleźć strony logowania do panelu administracyjnego

Jeśli ustawiłeś niestandardowy adres URL panelu administracyjnego ze względów bezpieczeństwa, panel nie jest już dostępny pod adresem /admin — odpowiada tylko pod Twoją tajną ścieżką. Odzyskaj go z tabeli settings, jeśli masz dostęp do bazy danych. Zobacz Bezpieczeństwo.

Uwierzytelnianie dwuskładnikowe blokuje mi dostęp

Jeśli utracisz aplikację uwierzytelniającą, wyłącz TOTP użytkownika w bazie danych (odpowiednia kolumna w tabeli users), aby odzyskać dostęp, a następnie ponownie się zarejestruj. Szczegóły w Bezpieczeństwie.

Przesyłanie plików i media

Duże przesyłania kończą się niepowodzeniem lub przekroczeniem limitu czasu

Zwiększ limity PHP upload_max_filesize i post_max_size, a na Nginx zwiększ client_max_body_size. Demo umożliwia przesyłanie plików o rozmiarze wielu gigabajtów dzięki wysokiej wartości client_max_body_size; zastosuj to samo na swoim serwerze dla dużych plików.

Film nie odtwarza się

Nowo przesłane filmy mogą nadal być w trakcie przetwarzania do zakończenia transkodowania. Sprawdź, czy format jest odpowiedni do odtwarzania w przeglądarce, czy pliki rendycji istnieją w magazynie oraz czy serwer wysyła poprawny typ MIME dla .mp4/.webm. Zobacz Odtwarzacz.

Brakuje miniatur lub podglądów

Generowanie miniatur i podglądów wymaga rozszerzenia GD lub Imagick (oraz FFmpeg dla klatek z filmów). Sprawdź, czy są zainstalowane oraz czy katalog uploads/ jest zapisywalny.

Transkodowanie utknęło

Jeśli zadania czekają w kolejce i nigdy się nie kończą:

• Upewnij się, że FFmpeg jest zainstalowany wszędzie tam, gdzie odbywa się transkodowanie (serwer lokalny lub zdalny proces roboczy).
• Jeśli korzystasz ze zdalnych serwerów transkodowania, sprawdź, czy proces roboczy działa i czy jego klucz API jest zgodny z tym skonfigurowanym w panelu administracyjnym.
• Upewnij się, że harmonogram działa (patrz poniżej) — wysyłanie zadań i ponowne próby działają na pseudo-cron.

Zaplanowane zadania nie działają

Pseudo-cron uruchamia się tylko przy renderowaniu stron. Na spokojnej witrynie puls utrzymuje go przy życiu — upewnij się, że heartbeat_enabled ma wartość 1. Jeśli go wyłączyłeś, włącz go ponownie lub dodaj wpis cron systemowego, który będzie okresowo odwiedzał Twoją witrynę.

E-mail nie jest wysyłany

Skonfiguruj SMTP w sekcji E-mail i powiadomienia i użyj wbudowanego przycisku Wyślij testowy e-mail, aby potwierdzić. Jeśli testy nie powiodą się, sprawdź hosta/port/dane dostępowe SMTP oraz czy Twój hosting zezwala na wysyłanie poczty wychodzącej; w celu zapewnienia dostarczalności skonfiguruj rekordy SPF/DKIM dla swojej domeny.

Wydajność

W przypadku szybkiej witryny na dużą skalę: włącz OPcache, zapewnij PHP wystarczającą ilość pamięci, utrzymaj MySQL w tej samej sieci co PHP i pozostaw włączone przeliczanie CTR oraz inne zaplanowane zadania. TubePress zawiera indeksy i zadania porcjowane niezbędne do obsługi dużych bibliotek — zobacz Konserwację.

Aktualizacje kończą się niepowodzeniem

Jeśli aktualizacja się nie zastosuje, sprawdź, czy pliki rdzenia są zapisywalne przez użytkownika PHP i czy używasz PHP 8.2+. Zawsze wykonaj kopię zapasową przed aktualizacją, aby móc cofnąć zmiany. Zobacz Aktualizowanie.

Nadal masz problem?

Zbierz dokładny komunikat błędu i odpowiednie linie dziennika, a następnie otwórz zgłoszenie z pulpitu nawigacyjnego lub widżetu wsparcia w panelu administracyjnym. Im więcej kontekstu podasz — wersja PHP, serwer WWW i co robiłeś — tym szybciej problem zostanie rozwiązany. Zobacz Ogłoszenia i wsparcie.