Aller au contenu
TubePress — gratuit, auto-hébergé & activement maintenu
Prise en main

Mettre à jour TubePress

Mises à jour en un clic, mises à jour manuelles, versions signées et garde-fou de version PHP.

TubePress se met à jour comme WordPress : un clic dans le panneau d'administration télécharge une version signée, la vérifie, effectue une sauvegarde, remplace le cœur et exécute les migrations de base de données. Vos thèmes, plugins, médias et paramètres ne sont pas modifiés.

Cette page explique précisément ce qu'une mise à jour modifie, comment l'appliquer et comment rester en sécurité.

Fonctionnement des mises à jour

Les versions sont distribuées sous forme de paquets signés depuis tubepress.io. Avant que TubePress ne touche le moindre fichier, chaque paquet est vérifié deux fois :

  • une somme de contrôle SHA-256 — toute incohérence annule la mise à jour ; et
  • une signature Ed25519 — le cœur refuse de s'installer sans signature valide, donc tout paquet altéré ou non signé est rejeté immédiatement.

Une mise à jour ne remplace que le cœur fixe. Concrètement :

Remplacé
src/, sql/, templates/admin/, templates/install/ et config/app.php.
Jamais modifié
Vos themes/, plugins/, les médias uploadés dans public/uploads/, le contenu de votre base de données et vos paramètres (dont config/database.php).

Juste avant l'échange des fichiers, TubePress copie le cœur actuel dans storage/backups/ et effectue une sauvegarde de la base de données. S'il ne peut pas créer cette sauvegarde, la mise à jour du cœur s'annule plutôt que de risquer vos données. Les fichiers sont ensuite échangés de manière atomique, les nouvelles migrations numérotées dans sql/ s'exécutent automatiquement, et le résultat est consigné dans un journal de mise à jour que vous pouvez consulter ou depuis lequel vous pouvez effectuer un retour arrière.

Mise à jour en un clic

Accédez à Admin → Mises à jour sur /admin/updates (accès administrateur requis). L'écran affiche votre version actuelle et les mises à jour disponibles pour le cœur, les plugins et les thèmes. Vérifier les mises à jour interroge à nouveau tubepress.io à la demande.

Cliquez pour appliquer un élément et TubePress télécharge, vérifie, sauvegarde, remplace et migre — puis enregistre le résultat. Si quelque chose semble anormal ensuite, vous pouvez revenir à la sauvegarde qui vient d'être créée.

Mises à jour automatiques

Préférez ne pas intervenir ? Activez le paramètre auto_update_enabled (il est désactivé par défaut). Lorsqu'il est activé, une tâche pseudo-cron en arrière-plan vérifie périodiquement et applique les mises à jour en attente au plus une fois par jour. Par souci de sécurité, il est délibérément conservateur :

  • le cœur et les plugins gratuits se mettent à jour automatiquement ;
  • les thèmes sont toujours laissés à votre soin pour une mise à jour manuelle, afin que vos personnalisations ne soient jamais écrasées sans surveillance ; et
  • les éléments payants sont ignorés — ils nécessitent un achat depuis le marketplace.

Le planificateur est le même pseudo-cron intégré utilisé ailleurs — voir Maintenance.

Mise à jour manuelle

La mise à jour en un clic est la méthode recommandée car c'est la seule qui vérifie également les signatures, effectue des sauvegardes et exécute vos migrations de base de données. Si votre panneau ne peut vraiment pas atteindre tubepress.io (un hôte derrière un pare-feu ou isolé), vous pouvez effectuer la mise à jour manuellement :

  1. Sauvegardez d'abord. Effectuez une sauvegarde complète des fichiers et de la base de données — voir Sauvegardes.
  2. Obtenez la version officielle. Téléchargez le ZIP signé depuis la page de téléchargement ou votre compte.
  3. Remplacez uniquement le cœur. Écrasez src/, sql/, templates/admin/, templates/install/ et config/app.php avec la nouvelle version. Laissez themes/, plugins/, public/uploads/ et config/database.php en place.
  4. Appliquez les nouvelles migrations. Appliquez les nouveaux fichiers numérotés dans sql/ à votre base de données — c'est l'étape que le programme de mise à jour intégré effectue normalement pour vous.
Utilisez le panneau quand vous le pouvez. Les mises à jour manuelles ignorent les vérifications automatiques de signature et les migrations, alors réservez-les pour quand le programme de mise à jour intégré n'est pas disponible.

Le garde de version PHP

TubePress inclut une petite porte de sécurité d'analyse (config/php-guard.php) qui s'exécute à chaque point d'entrée avant le démarrage de l'application. Elle est écrite délibérément en PHP à l'ancienne afin d'être analysable par n'importe quelle version — ce qui signifie que si un site est déplacé vers, ou rétrogradé sur, une version PHP plus ancienne que la version requise 8.2, les visiteurs voient une page propre “Mise à niveau PHP requise” au lieu d'une erreur fatale brute.

Cela est important lors des mises à jour : les nouvelles versions peuvent utiliser une syntaxe PHP plus récente, donc confirmez que votre hôte exécute PHP 8.2 ou une version plus récente (8.4 recommandé) avant et après la mise à jour. Plus de détails dans Maintenance.

Avant de mettre à jour

Les mises à jour sont conçues pour être sûres et réversibles, mais une sauvegarde reste votre ceinture de sécurité :

  • Sauvegardez les fichiers et la base de données — le programme de mise à jour fait sa propre sauvegarde, mais conservez aussi votre propre copie. Voir Sauvegardes.
  • Vérifiez PHP — confirmez que vous utilisez la version 8.2+ (idéalement 8.4).
  • Notez vos personnalisations — les modifications de thèmes et de plugins sont préservées, mais un inventaire rapide ne fait jamais de mal.
  • Mettez à jour lors d'un moment calme — l'échange est quasi-instantané, mais choisissez un moment à faible trafic, par précaution.
Ne modifiez jamais le cœur. Les modifications apportées à src/ ou templates/admin/ seraient remplacées lors de la prochaine mise à jour. Construisez avec des thèmes et des plugins à la place — les mises à jour ne les touchent jamais.

Étapes suivantes

Toujours bloqué ?

Ouvrez un ticket depuis votre tableau de bord et notre équipe vous assistera.

Essayer la démo en direct → Télécharger TubePress →