Comment mettre à jour l'application principale

Avant de commencer

• Lisez le changelog de la nouvelle version sur CodeCanyon. Portez attention aux instructions spéciales pour les mises à jour majeures.
• Créez une sauvegarde complète de votre base de données et de vos fichiers. Consultez notre article Sauvegarde avant mise à jour.
• Assurez-vous que votre serveur répond aux exigences de la nouvelle version (vérifiez le changelog pour tout changement de version PHP ou d'extensions).
• Si vous avez effectué des personnalisations CSS, sauvegardez votre fichier CSS personnalisé pour pouvoir le restaurer après la mise à jour.
• Si vous avez modifié des traductions, sauvegardez vos fichiers de langue dans le dossier /lang/ pour pouvoir fusionner leur contenu après la mise à jour.

Méthode 1 : Mise à jour via SSH (recommandée)

Cette méthode est plus rapide et plus fiable. Elle nécessite un accès SSH (terminal) à votre serveur.

1. Mettez votre site en maintenance depuis le Panneau d'administration → Paramètres → Général → Mode maintenance. Ne vous déconnectez pas en tant qu'administrateur.
2. Videz le cache du site depuis le Panneau d'administration (bouton Vider le cache).
3. Téléchargez la dernière version depuis CodeCanyon (Téléchargements → Larapen → « Installable PHP File »).
4. Copiez le fichier .zip à la racine de votre serveur (le même dossier où les fichiers ont été téléversés lors de l'installation).
5. Renommez le fichier zip en larapen.zip sur le serveur.
6. Supprimez le répertoire vendor de votre serveur afin qu'aucun ancien fichier inutilisé ne subsiste des versions précédentes.
7. Ouvrez un terminal et naviguez vers le dossier racine de votre site.
8. Exécutez la commande suivante :

   unzip -o larapen.zip -x ".htaccess" -x "public/.htaccess"

   Les options -x excluent les fichiers .htaccess afin de préserver votre configuration serveur existante.

9. Attendez que la commande se termine.
10. Si vous avez installé des add-ons, mettez-les à jour vers leur dernière version (voir Comment mettre à jour les add-ons).
11. Visitez https://votresite.com/upgrade dans votre navigateur et cliquez sur le bouton « Upgrade Now ».
12. Une fois la mise à jour terminée, votre site sera remis en ligne automatiquement (le mode maintenance est désactivé).

Méthode 2 : Mise à jour traditionnelle (FTP)

Utilisez cette méthode si vous n'avez pas d'accès SSH à votre serveur.

1. Mettez votre site en maintenance depuis le Panneau d'administration → Paramètres → Général → Mode maintenance. Ne vous déconnectez pas en tant qu'administrateur.
2. Videz le cache du site depuis le Panneau d'administration (bouton Vider le cache).
3. Téléchargez la dernière version depuis CodeCanyon.
4. Copiez le fichier .zip à la racine de votre serveur.
5. Supprimez le répertoire vendor de votre serveur (via FTP ou le Gestionnaire de fichiers).
6. Extrayez le fichier .zip dans le dossier racine du site en écrasant les anciens fichiers.
7. Si vous avez installé des add-ons, mettez-les à jour vers leur dernière version.
8. Visitez https://votresite.com/upgrade dans votre navigateur et cliquez sur le bouton « Upgrade Now » (assurez-vous d'être connecté en tant qu'administrateur).
9. Une fois la mise à jour terminée, votre site sera remis en ligne automatiquement.

Après la mise à jour

Vérifier la mise à jour

• Vérifiez que le numéro de version affiché dans le pied de page du panneau d'administration correspond à la nouvelle version.
• Parcourez les pages front-end de votre site pour vous assurer que tout s'affiche correctement.
• Testez les fonctionnalités clés : formulaire de contact, téléversement de médias, édition de pages.

Vider les caches supplémentaires

Si vous rencontrez des problèmes d'affichage ou de comportement après la mise à jour :

• Allez dans Paramètres → Cache dans le panneau d'administration et cliquez sur « Vider tous les caches ».
• Videz le cache de votre navigateur (Ctrl+Maj+Suppr / Cmd+Maj+Suppr).

Sécurité des données