Risoluzione dei problemi

La maggior parte dei problemi si riduce a poche cause: versione PHP, permessi dei file, credenziali del database, riscrittura del web server o un worker mancante. Questa pagina elenca i sintomi più comuni riscontrati dagli operatori e come risolverli. In caso di dubbio, il log degli errori PHP è il modo più rapido per trovare la causa.

Problemi di installazione

«La tua versione PHP non è supportata»

TubePress richiede PHP 8.2 o versioni successive, applicato da un controllo di versione sicuro che viene eseguito prima di tutto il resto. Cambia la versione PHP nel pannello di hosting (o punta il vhost a un socket PHP-FPM più recente) e ricarica. Vedi Requisiti.

«Impossibile connettersi al database»

Durante la fase di configurazione del database del programma di installazione, verifica nuovamente l'host (spesso localhost o 127.0.0.1), il nome del database, l'utente e la password, e che l'utente abbia i privilegi su quel database. Il database deve già esistere — il programma di installazione crea le tabelle, non lo schema stesso.

Il programma di installazione non riesce a scrivere la configurazione / errore «non scrivibile»

Il web server ha bisogno di accesso in scrittura a config/ e storage/ durante la configurazione. Rendi quelle directory scrivibili dall'utente PHP, quindi riprova. Vedi le indicazioni sui permessi in Installazione.

Ho terminato l'installazione ma /install si carica ancora

L'installazione scrive config/installed.php. Se è mancante, l'app pensa di non essere installata; se la configurazione è stata completata, quel file dovrebbe esistere e il programma di installazione si blocca automaticamente. Verifica nuovamente che config/ fosse scrivibile.

Il sito si carica ma le pagine danno 404

Se la home page funziona ma ogni altro URL restituisce 404, la riscrittura degli URL non sta raggiungendo il front controller.

• Apache — conferma che mod_rewrite sia abilitato e che AllowOverride All sia impostato in modo che il file .htaccess incluso sia rispettato.
• Nginx — il blocco location / deve passare al front controller, ad es. try_files $uri $uri/ /index.php?$query_string;. Vedi Architettura per le note sul web server.

Accesso e pannello di amministrazione

Non riesco a trovare l'accesso all'amministrazione

Se hai impostato un URL amministrazione personalizzato per sicurezza, il pannello non si trova più a /admin — risponde solo al tuo percorso segreto. Recuperalo dalla tabella settings se hai accesso al database. Vedi Sicurezza.

L'autenticazione a due fattori mi sta bloccando

Se perdi l'autenticatore, disabilita il TOTP dell'utente nel database (la colonna pertinente nella tabella users) per riottenere l'accesso, poi registrati di nuovo. Dettagli in Sicurezza.

Upload e media

Gli upload di file grandi falliscono o vanno in timeout

Aumenta i limiti PHP upload_max_filesize e post_max_size, e su Nginx aumenta client_max_body_size. La demo consente upload di più gigabyte tramite un valore elevato di client_max_body_size; replica questa configurazione sul tuo server per file di grandi dimensioni.

Un video non viene riprodotto

I video appena caricati potrebbero essere ancora in fase di elaborazione fino al termine della transcodifica. Conferma che il formato sia distribuibile via web, che i file di rendition esistano nello storage e che il tuo server invii il tipo MIME corretto per .mp4/.webm. Vedi Player.

Le miniature o le anteprime sono mancanti

La generazione di miniature e anteprime richiede l'estensione GD o Imagick (e FFmpeg per i frame derivati dal video). Verifica che siano installate e che uploads/ sia scrivibile.

La transcodifica è bloccata

Se i lavori rimangono in coda e non vengono mai completati:

• Conferma che FFmpeg sia installato ovunque venga eseguita la transcodifica (server locale o worker remoto).
• Se utilizzi server di transcodifica remoti, verifica che il worker sia in esecuzione e che la sua chiave API corrisponda a quella configurata nell'amministrazione.
• Assicurati che lo scheduler stia funzionando (vedi sotto) — il dispatching dei lavori e i tentativi di ripetizione vengono eseguiti sul pseudo-cron.

I lavori pianificati non vengono eseguiti

Il pseudo-cron si attiva solo durante il rendering delle pagine. Su un sito poco trafficato, l'heartbeat lo mantiene attivo — assicurati che heartbeat_enabled sia 1. Se lo hai disabilitato, riabilitalo oppure aggiungi una voce di cron di sistema che acceda periodicamente al tuo sito.

L'email non viene inviata

Configura SMTP in Email & notifiche e usa il pulsante integrato Invia email di test per confermare. Se i test falliscono, verifica host/porta/credenziali SMTP e che il tuo host consenta la posta in uscita; per la recapitabilità, configura SPF/DKIM sul tuo dominio.

Prestazioni

Per un sito reattivo su larga scala: abilita OPcache, dai a PHP sufficiente memoria, mantieni MySQL sulla stessa rete di PHP e lascia in esecuzione il ricalcolo CTR e gli altri task pianificati. TubePress include gli indici e i lavori suddivisi in blocchi necessari per librerie di grandi dimensioni — vedi Manutenzione.

Gli aggiornamenti falliscono

Se un aggiornamento non viene applicato, conferma che i file core siano scrivibili dall'utente PHP e che tu stia utilizzando PHP 8.2+. Esegui sempre un backup prima di aggiornare in modo da poter eseguire il rollback. Vedi Aggiornamento.

Ancora bloccato?

Raccogli il messaggio di errore esatto e le righe di log pertinenti, poi apri un ticket dal tuo pannello di controllo o dal widget di supporto nell'amministrazione. Più contesto fornisci — versione PHP, web server e cosa stavi facendo — più rapidamente viene risolto. Vedi Annunci & supporto.