upgrade_v11.md 4.6 KB

Upgrade v10 -> v11

Mise à jour de l'instance typo3 de la 10.4.36 vers la 11.5.29 LTS

Pour cette mise à jour, on reste en PHP 7.4.1

Analyse

Mise à niveau des extensions Opentalent

L'analyse des fichiers des extensions signale deux extensions "maison" comme incompatibles : ot_admin et ot_connect.

Au total, ce sont trois méthodes qui sont concernées par les dépréciations.

Un ticket est créé pour la mise à niveau : V8-4761

Mise à niveau des extensions tiers

Extension Version actuelle Dernière version Compatibilité Typo3 11 Compat. PHP
fluidtypo3/flux 9.7.2 9.7.4 ^11 ^7.4.0 - ^8
fluidtypo3/vhs 6.1.2 6.1.3 ^11 ^7.4.0 - ^8
georgringer/news 9.0 11.1.2 ^11.5.24 7.4 -> 8.3
helhum/typo3-console 6.6 7.1.6 ^11.5.26 >=7.4.1
causal/image_autoresize 2.1 2.2.0 ^11 ^7.4 - ^8
friendsoftypo3/frontend-editing 2.0 3.1.1 ^11.5 ?
sgalinski/lfeditor 6.0 7.1.11 ^11.5 ?
waldhacker/hcaptcha 2.0 2.1.1 ^11.5 ^7.2 - ^8
guzzle/guzzle 6.x 7.7 ^7.2 - ^8
nimut/testing-framework 5.2 6.0.1 ^11.5.3 ^7.2 - ^8.0

A priori pas de blocage, la mise à jour des extensions sera à faire en même temps que celle de typo3

Réaliser l'upgrade

  1. Faire un snapshot du serveur
  2. Maj tous les packages Typo3 de la version ^10.4 à la version ^11.5 dans le composer.json
  3. Maj les dépendances à leur dernière version compatible (voir paragraphe précédent)
  4. Aller à la page /setup de typo3, et faire passer les différentes opérations de mise à jour
  5. Tester

Notes upgrade en local

  • (réglé, voir: https://github.com/FluidTYPO3/vhs/issues/1869) J'ai dû modifier le type du param ... de la classe FluidTYPO3\Vhs\ViewHelpers\Resource\CollectionViewHelper qui générait une erreur (mettre Repository comme type à la place de RecordCollectionRepository débloque la situation...)
  • Il a fallu maj le fichier cli, le nouvel emplacement de la console est /var/www/typo3/vendor/bin/typo3
  • il faut mettre à jour le .htaccess (prendre celui ici: public/typo3/sysext/install/Resources/Private/FolderStructureTemplateFiles/root-htaccess ) et le copier dans public/, puis rajouter les lignes custom en début de fichier)
  • j'ai un bug avec gzuncompress au chargement du backend, on peut le corriger avec un sh cli cache:flush
  • comme suggéré dans la doc typo3, j'ai lancé un sh cli referenceindex:update

Notes upgrade sur test

  • déploiement sur test5

    cd /var/opentalent/git/ot_typo3 git fetch origin feature/v8-4762-upgrade_v11 git checkout feature/v8-4762-upgrade_v11

    cd /var/www/typo3

  • je copie colle le contenu du composer.json dans celui de test5

    php7.4 composer.phar update

  • je met à jour le fichier cli avec le bon chemin d'accès : /var/www/typo3/vendor/bin/typo3

    mv public/.htaccess public/.htaccess.old cp public/typo3/sysext/install/Resources/Private/FolderStructureTemplateFiles/root-htaccess public/.htaccess

  • je rajoute les premières lignes custom du .htaccess

    touch public/typo3conf/ENABLE_INSTALL_TOOL

  • je me rends à l'adresse https://sub.test5.opentalent.fr/typo3/install.php

  • je lance la maj de la structure de la DB

  • je lance l'upgrade wizard, et j'exécute toutes les tâches

  • je reset les préférences du backend user

  • je maj les packs de langues

  • je flush le cache

  • j'ajoute la ligne suivante au fichier nano /etc/php/7.4/cli/conf.d/20-apcu.ini : apc.enable_cli=on

    sh cli cache:flush sh cli referenceindex:update

  • je retire le plugin frontend-editing qui ne fonctionne pas : php7.4 composer.phar remove friendsoftypo3/frontend-editing

Up:

Je renomme le fichier composer.json et je créé un symlink vers le nouveau composer.json versionné dans le repo ot_typo3 :

mv composer.json composer.json.orig
ln -s /var/opentalent/git/ot_typo3/composer.json ./composer.json
php7.4 composer.phar install