Mise à jour Carento : sauvegardes, comparaison de fichiers, Composer, Artisan, cache, templates et personnalisations à reprendre sans casser le site.
Mettre Carento à jour correctement – système Laravel de réservation de voitures
Mettre à jour un système Laravel comme Carento peut sembler simple au premier abord. Mais dès que des modifications spécifiques, des templates personnalisés ou une logique adaptée entrent en jeu, le niveau de risque augmente nettement. Ce guide pratique présente notre processus réel de mise à jour, les problèmes typiques rencontrés et les outils utilisés pour mettre à niveau un système Carento personnalisé de manière contrôlée, stable et sûre.
🚀 Pourquoi les mises à jour régulières de Carento sont importantes
Carento reçoit régulièrement des correctifs de sécurité, des améliorations de performance, des ajustements de l’interface et de nouvelles fonctionnalités. Les points ci-dessous résument les changements importants introduits dans les versions récentes :
📌 Changelog : Carento – système Laravel de réservation de voitures
Version 1.1.8.1 (nécessite PHP 8.2+)
- Ajout de catégories d’équipements
- Ajout d’une option miles/kilomètres
- Amélioration de la configuration des devises
- Ajout de nouveaux endpoints API pour les véhicules
- Ajout d’un paramètre d’expiration pour la vérification par e-mail
- Amélioration de l’UI et de l’UX
- Correction de bugs dans le tableau de bord vendeur
Carento – système Laravel de réservation de voitures – v1.1.0 à 1.1.8.1
- Parmi les évolutions ajoutées ou mises à jour figurent notamment la puissance des véhicules, les codes promo, les outils de réservation, la prise en charge multi-vendeur, la gestion des devises, les notifications push, un système de vente de véhicules, des ajustements GDPR des cookies, des optimisations de cache, des améliorations du sitemap, la prise en charge de PHP 8.3 et la mise à niveau vers Laravel 12.x.
Le changelog complet est disponible dans les notes de version officielles de Carento. L’essentiel à retenir est que chaque version apporte des améliorations concrètes, aussi bien dans la base technique que dans l’interface utilisateur.
🔧 Notre stratégie de mise à jour – méthode et logique
Nous avons récemment mis à niveau une installation Carento fortement personnalisée de la version v1.1.0 à v1.1.8.1. Une méthode contrôlée s’est révélée efficace et peut également être appliquée à des projets similaires :
✅ Étape 1 : créer une sauvegarde complète
Ne lancez jamais une mise à jour sans sauvegarde complète des fichiers et de la base de données. Une sauvegarde fonctionnelle est la condition essentielle pour pouvoir revenir en arrière en toute sécurité.
- Parmi les outils adaptés figurent cp -r sous Linux/macOS, FileZilla sous Windows, ainsi que phpMyAdmin ou mysqldump pour la base de données.
✅ Étape 2 : comparer les fichiers d’origine avec les personnalisations
Comme Carento est souvent modifié en dehors d’un processus de déploiement standardisé, nous avons comparé les fichiers d’origine et ceux du projet avec des outils de diff. Cela permet d’identifier précisément les changements qui doivent être conservés.
🖥 Outils recommandés :
🟦 WinMerge (Windows)
- Comparaison simple de dossiers par glisser-déposer.
- Les fichiers modifiés sont clairement mis en évidence.
- Les différences de code peuvent être examinées ligne par ligne.
- Gratuit, rapide et adapté également aux débutants.
🟩 Meld (Linux/macOS/Windows)
- Interface légère et claire.
- Comparaison au niveau des fichiers ou des dossiers.
- Les modifications peuvent être fusionnées de manière interactive.
🟥 Beyond Compare (toutes plateformes)
- Outil professionnel adapté aux comparaisons plus complexes.
- Fusion 3 voies, coloration syntaxique et prise en charge de Git.
- Particulièrement adapté aux grandes bases de code.
Autres outils pour macOS
- P4Merge, DiffMerge, Kaleidoscope (payant) et KDiff3.
✅ Étape 3 : effectuer la mise à jour avec Composer et Artisan
Après la comparaison des fichiers, nous avons réalisé la mise à jour à l’aide des outils CLI de Laravel. Les commandes restent volontairement inchangées :
composer install --no-dev --optimize-autoloaderphp artisan migrate --forcephp artisan cache:clearphp artisan view:clear ⚠️ Remarque : en production, il faut utiliser --force pour les migrations ; sinon elles ne seront pas exécutées.
✅ Étape 4 : réappliquer les personnalisations de façon contrôlée
Cette étape demande une attention particulière. Les styles, la logique ou les modifications de contrôleurs peuvent entrer en conflit avec les changements de la nouvelle version. Nous recommandons donc de :
- Documenter séparément le code personnalisé et les modifications propres au projet
- Identifier clairement les changements avec des commentaires comme // Custom logic start dans PHP/Blade
- Documenter les overrides, en particulier les templates Blade personnalisés du thème
🧪 Problèmes fréquents lors des mises à jour de Carento
⚠️ 1. Les templates Blade affichent encore l’ancien contenu
Il arrive que le fichier mis à jour soit correct alors que Laravel continue à servir une ancienne vue en cache. Commencez alors par vider le cache des vues :
php artisan view:clearSi nécessaire, le dossier /storage/framework/views peut également être nettoyé de manière contrôlée.
⚠️ 2. La configuration ou les routes sont encore en cache
Si les changements de configuration ou de devise ne sont pas visibles, videz de manière ciblée les caches concernés :
php artisan route:clear⚠️ 3. Les overrides du thème écrasent les modifications
Le système de thème de Carento peut remplacer des vues comme car-item-grid.blade.php, style-1.blade.php et d’autres composants. Vérifiez en particulier les conflits entre :
- /platform/themes/carento/views/...
- /resources/views/vendor/...
- /resources/views/components/...
⚠️ 4. Le changement de devise ne fonctionne plus
Les changements de devise peuvent rester invisibles si des accessors sont mis en cache ou si Blade ne se rend pas de nouveau. Vérifiez donc la sortie dynamique et évitez les valeurs statiques.
- Utiliser get_application_currency() dans les accessors
- Éviter les valeurs de devise codées en dur
- Afficher les données de devise pour le débogage si nécessaire :
<pre>{{ get_application_currency() }}</pre>🛡️ Rendre les mises à jour sûres et reproductibles
Que vous gériez le site d’un client ou que vous utilisiez Carento vous-même, les mises à jour doivent être reproductibles. Une gestion de versions claire, une bonne documentation et un environnement de staging réduisent nettement les risques. Site web
✅ Utiliser Git pour le contrôle de version ✅ Documenter les personnalisations ✅ Suivre les fichiers modifiés ✅ Utiliser des outils de diff avant toute copie ✅ Tester d’abord les mises à jour sur un environnement de staging
Mettre Carento à jour de façon professionnelle : retour d’expérience
Une mise à jour Carento structurée combine une préparation rigoureuse, une reprise contrôlée des fichiers, les migrations de base de données et des tests ciblés. Les fonctions personnalisées sont ainsi préservées, les conflits sont détectés tôt et les performances du site en production peuvent rester stables même lors de changements de version importants.