Notice de migration versions 1906 à 1907
-
Un nombre important de classes a été déplacé.
Pour en tenir compte, votre projet doit effectuer les cherche-et-remplace suivants, en vérifiant à chaque fois qu’il s’agit bien de références aux objets du framework.
Mise à jour du code
Il faut déplacer en masse les composants :
-
/widget/button/
->/component/button/
: attention à exclure vos propres références
-Widget\Button
->Component\Button
-Widget/Button
->Component/Button
-
/widget/input/
->/component/input/
: attention à exclure vos propres références
-Widget\Input
->Component\Input
-Widget/Input
->Component/Input
-
/widget/menu
->/component/menu/
: attention à exclure vos propres références
-Widget\Menu
->Component\Menu
-Widget/Menu
->Component/Menu
-
/widget/tab
->/component/tab/
: attention à exclure vos propres références
-Widget\Tab
->Component\Tab
-Widget/Tab
->Component/Tab
-
/widget/trashcan
->/component/trashcan/
: attention à exclure vos propres références
-Widget\Trashcan
->Component\Trashcan
-Widget/Trashcan
->Component/Trashcan
Puis déplacer les fonctionnalités qui restent :
-
/framework/export
->/framework/feature/export
: attention à exclure vos propres références
-Framework/Export
->Framework/Feature/Export
-Framework\Export
->Framework\Feature\Export
-
/framework/import
->/framework/feature/import
: attention à exclure vos propres références
-Framework/Import
->Framework/Feature/Import
-Framework\Import
->Framework\Feature\Import
-
/widget/
->/feature/
: attention à exclure vos propres références
-Framework\Widget
->Framework\Feature
-Framework/Widget
->Framework/Feature
-
Color\Widget
->Widget\Color
: il est conseillé de vérifier au cas par cas
-Feature\Edit\Widgets\Collection_As_Map
->Widget\Collection_As_Map
-Feature\Edit\Widgets\Map_As_Collection
->Widget\Map_As_Collection
Vérifier le tri des clauses use dans vos scripts modifiés, pour rétablir l’ordre alphabétique.
Recalcul du cache
- supprimer le dossier cache (notamment les fichiers weaver.php* vont poser problème)
- lancer un recalcul complet du cache
- il est recommandé de faire un service apache2 force-reload pour s’assurer de l’invalidation complète de l’opcacheMise à jour des données
À exécuter sur tous les environnements (développement, test, pré-production, production) au moment dès application de la mise à jour.
Il faut notamment mettre à jour les settings et user-settings en appelant :/ITRocks/Framework/Updater/Migrate/Apply1906/run
Bogues / points d’attention
Après la procédure, il peut arriver que la page de login du logiciel plante. Il en résulte notamment un non-chargement des CSS :
- voir la console dans le navigateur, une erreur indiquera que App est inconnu
- regardez le code source de la page : vous constaterez que tous les css / js n’ont pas été chargésPour éviter / corriger ce souci, il faut forcer la recompilation des assets dans main.html :
- pour chaque fichier assets.html de vos différents projets
- rajoutez une ligne blanche à la fin
- enregistrez le fichier
- retirez la ligne blanche (et ré-enregistrez)
- créez un fichier update dans la racine du projet
- consultez de nouveau la page de login : tout est revenu dans l’ordre