Dépannage

La plupart des problèmes se résument à quelques causes : version PHP, permissions de fichiers, identifiants de base de données, réécriture du serveur web ou worker manquant. Cette page liste les symptômes les plus fréquents rencontrés par les opérateurs et la façon de les résoudre. En cas de doute, le journal d'erreurs PHP est le chemin le plus rapide vers la vérité.

Problèmes d'installation

« Votre version de PHP n'est pas supportée »

TubePress nécessite PHP 8.2 ou une version plus récente, imposée par un garde-fou de version sécurisé qui s'exécute en premier. Changez la version PHP dans votre panneau d'hébergement (ou faites pointer le vhost vers un socket PHP-FPM plus récent) et rechargez. Voir Configuration requise.

« Impossible de se connecter à la base de données »

Lors de l'étape base de données de l'installateur, vérifiez l'hôte (souvent localhost ou 127.0.0.1), le nom de la base de données, l'utilisateur et le mot de passe, et que l'utilisateur dispose des privilèges nécessaires sur cette base de données. La base de données doit déjà exister — l'installateur crée les tables, pas le schéma lui-même.

L'installateur ne peut pas écrire la configuration / une erreur « not writable »

Le serveur web nécessite un accès en écriture à config/ et storage/ pendant l'installation. Rendez ces répertoires accessibles en écriture pour l'utilisateur PHP, puis réessayez. Voir les instructions de permissions dans Installation.

J'ai terminé l'installation mais /install se charge toujours

L'installation écrit config/installed.php. S'il est absent, l'application considère qu'elle n'est pas installée ; si l'installation s'est terminée, ce fichier doit exister et l'installateur se verrouille. Vérifiez à nouveau que config/ était accessible en écriture.

Le site se charge mais les pages retournent une erreur 404

Si la page d'accueil fonctionne mais que toutes les autres URLs retournent une erreur 404, la réécriture d'URL n'atteint pas le contrôleur frontal.

• Apache — confirmez que mod_rewrite est activé et qu'AllowOverride All est défini pour que le fichier .htaccess fourni soit pris en compte.
• Nginx — votre location / doit rediriger vers le contrôleur frontal, p. ex. try_files $uri $uri/ /index.php?$query_string;. Voir Architecture pour les notes sur le serveur web.

Connexion et accès administrateur

Je ne trouve pas la page de connexion administrateur

Si vous avez défini une URL d'administration personnalisée pour des raisons de sécurité, le panneau n'est plus accessible à /admin — il répond uniquement à votre chemin secret. Récupérez-le depuis la table settings si vous avez accès à la base de données. Voir Sécurité.

L'authentification à deux facteurs me bloque

Si vous perdez votre authentificateur, désactivez le TOTP de l'utilisateur dans la base de données (la colonne correspondante dans la table users) pour récupérer l'accès, puis réinscrivez-vous. Détails dans Sécurité.

Téléversements et médias

Les grands téléversements échouent ou expirent

Augmentez les limites PHP upload_max_filesize et post_max_size, et sur nginx augmentez client_max_body_size. La démo permet des téléversements de plusieurs gigaoctets grâce à un client_max_body_size élevé ; appliquez la même configuration sur votre serveur pour les fichiers volumineux.

Une vidéo ne se lit pas

Les vidéos récemment téléversées peuvent être encore en cours de traitement jusqu'à la fin du transcodage. Vérifiez que le format est compatible web, que les fichiers de rendu existent dans le stockage, et que votre serveur envoie le bon type MIME pour .mp4/.webm. Voir Lecteur.

Les miniatures ou aperçus sont manquants

La génération des miniatures et des aperçus nécessite l'extension GD ou Imagick (et FFmpeg pour les images extraites des vidéos). Vérifiez qu'elles sont installées et que uploads/ est accessible en écriture.

Le transcodage est bloqué

Si les tâches restent en file d'attente et ne se terminent jamais :

• Confirmez que FFmpeg est installé là où le transcodage s'exécute (serveur local ou worker distant).
• Si vous utilisez des serveurs de transcodage distants, vérifiez que le worker fonctionne et que sa clé API correspond à celle configurée dans l'administration.
• Assurez-vous que le planificateur est en cours d'exécution (voir ci-dessous) — la distribution et la reprise des tâches s'exécutent via le pseudo-cron.

Les tâches planifiées ne s'exécutent pas

Le pseudo-cron ne se déclenche que lors du rendu des pages. Sur un site peu fréquenté, le heartbeat le maintient actif — assurez-vous que heartbeat_enabled vaut 1. Si vous l'avez désactivé, réactivez-le ou ajoutez une entrée cron système qui appelle votre site périodiquement.

L'envoi des e-mails ne fonctionne pas

Configurez SMTP sous E-mail & notifications et utilisez le bouton intégré Envoyer un e-mail de test pour confirmer. Si les tests échouent, vérifiez l'hôte/port/identifiants SMTP et que votre hébergeur autorise le courrier sortant ; pour la délivrabilité, configurez SPF/DKIM sur votre domaine.

Performances

Pour un site réactif à grande échelle : activez OPcache, donnez suffisamment de mémoire à PHP, gardez MySQL sur le même réseau que PHP, et laissez le recalcul CTR et les autres tâches planifiées s'exécuter. TubePress est fourni avec les index et les tâches fragmentées nécessaires pour les grandes bibliothèques — voir Maintenance.

Les mises à jour échouent

Si une mise à jour ne s'applique pas, confirmez que les fichiers core sont accessibles en écriture par l'utilisateur PHP et que vous utilisez PHP 8.2+. Sauvegardez toujours avant de mettre à jour afin de pouvoir revenir en arrière. Voir Mises à jour.

Toujours bloqué ?

Rassemblez le message d'erreur exact et les lignes de journal pertinentes, puis ouvrez un ticket depuis votre tableau de bord ou le widget de support intégré à l'administration. Plus vous incluez de contexte — version PHP, serveur web et ce que vous faisiez — plus vite le problème est résolu. Voir Annonces & support.