Résolution des problèmes de mise à jour

Problèmes courants et solutions

1. « La page de mise à jour ne s'affiche pas » : Pas de redirection vers la page de mise à jour

Symptôme : Vous avez téléversé les nouveaux fichiers mais le panneau d'administration ne redirige pas vers la page de mise à jour.

Causes possibles :

• Le nouveau fichier config/larapen/version.php n'a pas été téléversé correctement.
• Le cache de configuration est périmé.

Solution :

1. Vérifiez que le fichier config/larapen/version.php existe et contient le nouveau numéro de version.
2. Videz le cache de configuration. Si vous avez un accès SSH :

   php artisan config:clear
   php artisan cache:clear

3. Si vous n'avez pas d'accès SSH, essayez de supprimer le fichier bootstrap/cache/config.php via votre Gestionnaire de fichiers.
4. Déconnectez-vous et reconnectez-vous au panneau d'administration.

2. « Erreur 500 Internal Server Error » après le téléversement des fichiers

Symptôme : Le site web affiche une erreur 500 après le téléversement des nouveaux fichiers.

Causes possibles :

• Téléversement incomplet (certains fichiers manquants ou corrompus).
• Incompatibilité de version PHP.
• Problème de permissions de fichiers.

Solution :

1. Consultez le journal d'erreurs PHP de votre serveur pour les messages d'erreur spécifiques.
2. Re-téléversez tous les fichiers de l'archive de la release, en vous assurant que le téléversement se termine sans erreur.
3. Vérifiez que votre version PHP correspond aux exigences listées dans le changelog.
4. Vérifiez les permissions des fichiers : les répertoires doivent être en 755, les fichiers en 644.
5. Si le problème persiste, restaurez à partir de votre sauvegarde et contactez le support.

3. Erreur « Mise à jour échouée » pendant le processus de mise à jour

Symptôme : Le processus de mise à jour affiche un message d'échec pour une version spécifique.

Solution :

1. Notez le message d'erreur exact et le numéro de version.
2. Consultez le fichier de log Laravel à storage/logs/laravel.log pour des informations d'erreur détaillées.
3. Causes courantes :
   • Problème de permissions de base de données: L'utilisateur de la base de données peut manquer de privilèges pour créer/modifier des tables. Accordez tous les privilèges.
   • Espace disque: Assurez-vous que votre serveur dispose de suffisamment d'espace disque libre.
   • Version MySQL: Certaines migrations peuvent nécessiter MySQL 8.0+. Vérifiez votre version MySQL.
4. Après avoir résolu le problème, réessayez la mise à jour. Le système reprendra à partir de la version qui a échoué.
5. Si le problème persiste, restaurez à partir de la sauvegarde et contactez le support avec les détails de l'erreur.

4. Page blanche ou styles manquants après la mise à jour

Symptôme : Le site web se charge mais apparaît sans style ou vide.

Solution :

1. Videz tous les caches :
   • Panneau d'administration : Paramètres → Cache → Vider tous les caches
   • Ou via SSH : php artisan cache:clear && php artisan config:clear && php artisan view:clear
2. Recompilez les assets du thème : Apparence → Thèmes → Tout compiler
3. Effectuez un rafraîchissement forcé du navigateur : Ctrl+Maj+R (Windows/Linux) ou Cmd+Maj+R (Mac).
4. Vérifiez la console du navigateur (F12) pour les erreurs de chargement JavaScript ou CSS.

5. Erreurs « Class not found » ou « Method not found »

Symptôme : Erreurs de classe ou méthode PHP après la mise à jour.

Solution :

1. Régénérez les fichiers d'autoload de Composer. Via SSH :

   composer dump-autoload

2. Si vous n'avez pas d'accès SSH, cherchez une option de régénération autoload_classmap.php dans votre panneau d'hébergement, ou contactez votre hébergeur.
3. Assurez-vous que tous les fichiers ont été téléversés correctement; des téléversements incomplets peuvent causer des classes manquantes.

6. Mise à jour bloquée ou timeout

Symptôme : Le processus de mise à jour semble se bloquer ou expire.

Solution :

1. NE cliquez PAS à nouveau sur « Mettre à jour »: un verrou empêche les mises à jour simultanées.
2. Attendez quelques minutes que le verrou expire (5 minutes).
3. Si la mise à jour ne se termine toujours pas, essayez de l'exécuter via SSH :

   php artisan larapen:update --force

4. Si le verrou est bloqué, supprimez-le :

   php artisan cache:clear

   Puis réessayez la mise à jour.

7. Add-on non détecté après la mise à jour

Symptôme : Un add-on n'apparaît pas dans le panneau d'administration ou ses fonctionnalités sont manquantes après la mise à jour.

Solution :

1. Allez dans Add-ons dans le panneau d'administration et vérifiez que l'add-on est listé et activé.
2. Cliquez sur « Synchroniser » pour re-scanner le répertoire des extensions.
3. Vérifiez que les fichiers de l'add-on sont dans le bon répertoire : extensions/addons/{nom-addon}/
4. Vérifiez que le fichier addon.json existe et est un JSON valide.

8. Bloqué après de mauvais paramètres (CAPTCHA, mail, etc.)

Symptôme : Des paramètres incorrects saisis dans le panneau d'administration vous empêchent de vous connecter (ex. mauvaises clés CAPTCHA, configuration mail cassée).

Solution — Option 1 : Forcer les valeurs .env (temporaire) :

1. Ajoutez la ligne suivante à votre fichier .env :

   SETTINGS_FORCE_ENV=captcha

   Cela indique au système d'ignorer les paramètres de la base de données pour ce groupe et d'utiliser les valeurs du .env à la place.

2. Si le cache de configuration est activé, exécutez : php artisan config:clear
3. Connectez-vous et corrigez les paramètres dans le panneau d'administration.
4. Supprimez la ligne SETTINGS_FORCE_ENV du .env une fois corrigé.

Noms de groupes disponibles : general, social_auth, geoip, cache, queue, captcha, ai, translator, currency_exchange, mail, sms, cookie_consent, locale. Utilisez all pour ignorer toutes les substitutions de la base de données.

Solution — Option 2 : Réinitialiser via CLI (permanent) :

1. Connectez-vous à votre serveur via SSH.
2. Exécutez la commande suivante pour désactiver le paramètre problématique :

   php artisan settings:reset captcha_enabled

3. Vous pouvez également cibler des clés spécifiques :

   php artisan settings:reset captcha_driver --value=none
   php artisan settings:reset login_captcha_enabled

La commande détecte automatiquement les clés *_enabled et les désactive par défaut (en définissant la valeur à 0). Elle vide également le cache des paramètres automatiquement.

Quand contacter le support

Si aucune des solutions ci-dessus ne résout votre problème :

1. Restaurez à partir de votre sauvegarde pour revenir à un état fonctionnel.
2. Rassemblez les informations suivantes :
   • Le message d'erreur (capture d'écran ou texte)
   • Le contenu de storage/logs/laravel.log (les 100 dernières lignes)
   • Votre version PHP (php -v)
   • Votre version MySQL
   • La version depuis laquelle et vers laquelle vous mettez à jour
3. Ouvrez un ticket de support avec ces détails.