Problemen oplossen

De meeste problemen zijn terug te herleiden tot een handvol oorzaken: PHP-versie, bestandsrechten, databasegegevens, herschrijving door de webserver of een ontbrekende worker. Op deze pagina staan de symptomen die beheerders het vaakst tegenkomen en hoe elk probleem op te lossen. Bij twijfel is uw PHP-foutenlog de snelste weg naar de waarheid.

Installatieproblemen

"Uw PHP-versie wordt niet ondersteund"

TubePress vereist PHP 8.2 of nieuwer, afgedwongen door een parse-veilige versiebewaker die vóór alles andere wordt uitgevoerd. Schakel de PHP-versie in uw hostingpaneel (of wijs de vhost naar een nieuwere PHP-FPM-socket) en herlaad. Zie Vereisten.

"Kan geen verbinding maken met de database"

Controleer tijdens de databasestap van de installatie nogmaals de host (vaak localhost of 127.0.0.1), de databasenaam, gebruiker en wachtwoord, en of de gebruiker rechten heeft op die database. De database moet al bestaan — de installatie maakt tabellen aan, niet het schema zelf.

De installatie kan de configuratie niet schrijven / een fout "niet beschrijfbaar"

De webserver heeft schrijftoegang nodig tot config/ en storage/ tijdens de installatie. Maak die mappen beschrijfbaar door de PHP-gebruiker en probeer het opnieuw. Zie de richtlijnen voor rechten in Installatie.

Ik heb de installatie voltooid maar /install wordt nog steeds geladen

De installatie schrijft config/installed.php. Als dit bestand ontbreekt, denkt de app dat het niet is geïnstalleerd; als de installatie is voltooid, moet dat bestand bestaan en blokkeert de installatie zichzelf. Controleer opnieuw of config/ beschrijfbaar was.

De site laadt maar pagina's geven 404

Als de startpagina werkt maar elke andere URL 404 geeft, bereikt URL-herschrijving de frontcontroller niet.

• Apache — bevestig dat mod_rewrite is ingeschakeld en dat AllowOverride All is ingesteld zodat het meegeleverde .htaccess-bestand wordt nageleefd.
• Nginx — uw location / moet worden doorgestuurd naar de frontcontroller, bijv. try_files $uri $uri/ /index.php?$query_string;. Zie Architectuur voor de webserveraantekeningen.

Inloggen & beheerderstoegang

Ik kan de beheerderslogin niet vinden

Als u een aangepaste beheerders-URL voor beveiliging heeft ingesteld, bevindt het paneel zich niet meer op /admin — het reageert alleen op uw geheime pad. Haal het op uit de settings-tabel als u databasetoegang heeft. Zie Beveiliging.

Tweefactorauthenticatie sluit mij buiten

Als u uw authenticator kwijtraakt, schakel dan de TOTP van de gebruiker in de database uit (de relevante kolom in de users-tabel) om toegang te herwinnen en meld u daarna opnieuw aan. Details in Beveiliging.

Uploads & media

Grote uploads mislukken of lopen vast

Verhoog de PHP-limieten upload_max_filesize en post_max_size, en verhoog op Nginx client_max_body_size. De demo staat uploads van meerdere gigabytes toe via een hoge client_max_body_size; spiegel dat op uw server voor grote bestanden.

Een video speelt niet af

Nieuw geüploade video's kunnen nog in verwerking zijn totdat het transcoderen is voltooid. Bevestig dat het formaat geschikt is voor het web, dat de renderingsbestanden in de opslag aanwezig zijn en dat uw server het juiste MIME-type verstuurt voor .mp4/.webm. Zie Speler.

Miniaturen of voorbeeldweergaven ontbreken

Het genereren van miniaturen en voorbeeldweergaven vereist de GD- of Imagick-extensie (en FFmpeg voor frames afgeleid van video). Controleer of ze zijn geïnstalleerd en of uploads/ beschrijfbaar is.

Transcodering is vastgelopen

Als taken in de wachtrij blijven zitten en nooit worden voltooid:

• Bevestig dat FFmpeg is geïnstalleerd waar transcodering wordt uitgevoerd (lokale server of een externe worker).
• Als u externe transcoderingsservers gebruikt, controleer dan of de worker actief is en of de API-sleutel overeenkomt met de sleutel die in het beheerdersdashboard is geconfigureerd.
• Zorg ervoor dat de planner tikt (zie hieronder) — taakdistributie en -herpoging worden uitgevoerd op de pseudo-cron.

Geplande taken worden niet uitgevoerd

De pseudo-cron wordt alleen geactiveerd bij het weergeven van pagina's. Op een rustige site houdt de heartbeat het actief — zorg ervoor dat heartbeat_enabled op 1 staat. Als u het hebt uitgeschakeld, schakel het dan opnieuw in of voeg een systeem-cron-vermelding toe die uw site periodiek bezoekt.

E-mail wordt niet verzonden

Configureer SMTP onder E-mail & meldingen en gebruik de ingebouwde knop Test-e-mail verzenden om te bevestigen. Als tests mislukken, verifieer dan de SMTP-host/poort/inloggegevens en of uw host uitgaand e-mailverkeer toestaat; voor afleverbaarheid, stel SPF/DKIM in op uw domein.

Prestaties

Voor een snelle site op grote schaal: schakel OPcache in, geef PHP voldoende geheugen, houd MySQL op hetzelfde netwerk als PHP en laat de CTR-herberekening en andere geplande taken draaien. TubePress wordt geleverd met de indexen en gesegmenteerde taken die nodig zijn voor grote bibliotheken — zie Onderhoud.

Updates mislukken

Als een update niet kan worden toegepast, bevestig dan dat de kernbestanden beschrijfbaar zijn door de PHP-gebruiker en dat u PHP 8.2+ gebruikt. Maak altijd een back-up vóór het updaten zodat u kunt terugdraaien. Zie Bijwerken.

Nog steeds vastgelopen?

Verzamel het exacte foutbericht en de relevante logregels en open vervolgens een ticket vanuit uw dashboard of de ondersteuningswidget in het beheerdersdashboard. Hoe meer context u opneemt — PHP-versie, webserver en wat u deed — hoe sneller het wordt opgelost. Zie Aankondigingen & ondersteuning.