PHPackages toumoro/tm-migration - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. toumoro/tm-migration ActiveTypo3-cms-extension[Database & ORM](/categories/database) toumoro/tm-migration ==================== TYPO3 extension that brings together the tools used for a major TYPO3 migration. v13.4.10(6mo ago)21.8k↓33.3%1GPL-2.0-or-laterPHPPHP >= 8.1 < 8.5 Since Jun 16Pushed 6mo agoCompare [ Source](https://github.com/toumoro/tm_migration)[ Packagist](https://packagist.org/packages/toumoro/tm-migration)[ Docs](https://github.com/toumoro/tm_migration)[ RSS](/packages/toumoro-tm-migration/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (11)Versions (17)Used By (0) [![Latest Stable Version](https://camo.githubusercontent.com/e12595783a0f5d9207958c7bbba947572d8fbbcd3dc3afb9a8aee12400ca1631/68747470733a2f2f706f7365722e707567782e6f72672f746f756d6f726f2f746d2d6d6967726174696f6e2f762f737461626c65)](https://packagist.org/packages/toumoro/tm-migration)[![Total Downloads](https://camo.githubusercontent.com/67575f53dae6f43ea42556d8dcf65bedd1376cb9793350df26bef423a222827f/68747470733a2f2f706f7365722e707567782e6f72672f746f756d6f726f2f746d2d6d6967726174696f6e2f646f776e6c6f616473)](https://packagist.org/packages/toumoro/tm-migration)[![License](https://camo.githubusercontent.com/405f3b819b02c16a7f60dd86bbc436603cc173299226629c8affea3c2e824491/68747470733a2f2f706f7365722e707567782e6f72672f746f756d6f726f2f746d2d6d6967726174696f6e2f6c6963656e7365)](https://packagist.org/packages/toumoro/tm-migration) FR -- [](#fr) Extension tm\_migration ======================= [](#extension-tm_migration) > Une extension TYPO3 qui regroupe des outils essentiels pour faciliter les migrations majeures de TYPO3. --- Dépendances ----------- [](#dépendances) PackageVersionCompatibilité`typo3-fractor`v0.5.112.4.0 & 13.4.0`typo3-rector`2.14.4 & v3.5.012.4.0 & 13.4.0`core-upgrader`dev-release/v12 & dev-release/v1312.4.0 & 13.4.0--- Étapes ------ [](#étapes) **1. Installer l’extension via composer :** ``` composer require toumoro/tm-migration --dev ``` **2. Mettre à jour les dépendances Composer vers les dernières versions :** ``` composer require $(composer show -s --format=json | jq '.requires | keys | map(.+" ") | add' -r) composer require --dev $(composer show -s --format=json | jq '.devRequires | keys | map(.+" ") | add' -r) ``` **3. Configurer l’extension dans `config/system/settings.php` :** ``` 'tm_migration' => [ 'cTypeToListTypeMappingArray' => 'pi_plugin1:new_content_element1', 'disableTrucateLogUpgradeWizard' => '1', 'numberOfDays' => '180', 'upgradeWizards' => [ 'exlcuded' => 'fillTranslationSourceField', 'fromVersion' => '9.5' ], ], ``` **4. Copier le dossier de migration dans le répertoire racine de votre projet :** ``` chmod +x vendor/toumoro/tm-migration/services/configure.sh vendor/toumoro/tm-migration/services/configure.sh ``` **5. Exporter les valeurs `CType` et `list_type` en JSON ou CSV (optionnel) :** - Ces commandes d'export de CType/ListType préparent à l'éxécution des Ugrade Wizards. - Permet de générer le mapping de ListType vers CType afin de les préciser dans setting.php (tm\_migration\[cTypeToListTypeMappingArray\]). ``` vendor/bin/typo3 tmexport:types -t [TYPE_FICHIER] -m [NOM_FICHIER] ``` Exemple pour CSV : ``` vendor/bin/typo3 tmexport:types -t csv -m types.csv ``` Exemple pour JSON : ``` vendor/bin/typo3 tmexport:types -t json ``` **6. Corriger les relations MM en double (uniquement si nécessaire) :** - 6.0. Exécuter la commande de correction des doublons MM : ``` vendor/bin/typo3 tmupgrade:fixdatabaseerrors ``` - 6.1. Exécuter la commande de update schema : ``` vendor/bin/typo3 database:updateschema "*.add,*.change" ``` **7. Exécuter les Upgrade Wizards :** ``` vendor/bin/typo3 tmupgrade:run ``` **8. Copier les fichiers de configuration Rector & Fractor dans votre projet :** ``` cp vendor/toumoro/tm-migration/Resources/Private/Config/Rector/rector_v13.php . cp vendor/toumoro/tm-migration/Resources/Private/Config/Fractor/fractor_v13.php . ``` **9. Exécuter Rector & Fractor en mode simulation (dry-run) :** ``` vendor/bin/rector process --debug --dry-run 2>&1 | tee rector-dryrun.txt vendor/bin/fractor process --dry-run 2>&1 | tee fractor-dryrun.txt ``` **10. Appliquer les correctifs de Rector & Fractor :** ``` vendor/bin/rector process vendor/bin/fractor process ``` > **Astuce :**Utiliser `--debug` avec Rector évite les problèmes liés au traitement en parallèle. **11. Importer les fichiers SQL (avant et après la mise à jour du schéma de base de données) :** ``` vendor/bin/typo3 tmupgrade:importsql -f [NOM_FICHIER] vendor/bin/typo3 tmupgrade:importsql -d [REPERTOIRE] ``` Exemple : ``` vendor/bin/typo3 tmupgrade:importsql -f migration.sql vendor/bin/typo3 tmupgrade:importsql -d before-updateschema ``` **12. Séparer les entrées d’historique de `sys_log` (uniquement si vous migrez un site depuis une version TYPO3 < 9.5) :** ``` vendor/bin/typo3 tmupgrade:seperate-syshistory-from-syslog -d [JOURS] -l [LIMITE] ``` --- Script pour exécuter toutes les étapes : ---------------------------------------- [](#script-pour-exécuter-toutes-les-étapes-) - Utilisez ce script pour re-simuler les étapes de migration ou pour le jour du déploiement en production. ``` chmod +x migration/run.sh migration/run.sh ``` EN -- [](#en) tm\_migration Extension ======================= [](#tm_migration-extension) > A TYPO3 extension that bundles essential tools to streamline major TYPO3 migrations. --- Dependencies ------------ [](#dependencies) PackageVersionCompatibility`typo3-fractor`v0.5.112.4.0 & 13.4.0`typo3-rector`2.14.4 & v3.5.012.4.0 & 13.4.0`core-upgrader`dev-release/v12 & dev-release/v1312.4.0 & 13.4.0--- Steps ----- [](#steps) **1. Install the extension via composer:** ``` composer require toumoro/tm-migration --dev ``` **2. Update Composer dependencies to the latest versions:** ``` composer require $(composer show -s --format=json | jq '.requires | keys | map(.+" ") | add' -r) composer require --dev $(composer show -s --format=json | jq '.devRequires | keys | map(.+" ") | add' -r) ``` **3. Configure the extension in `config/system/settings.php`:** ``` 'tm_migration' => [ 'cTypeToListTypeMappingArray' => 'pi_plugin1:new_content_element1', 'disableTrucateLogUpgradeWizard' => '1', 'numberOfDays' => '180', 'upgradeWizards' => [ 'exlcuded' => 'fillTranslationSourceField', 'fromVersion' => '9.5' ], ], ``` **4. Copy the migration folder to the base directory of your project:** ``` chmod +x vendor/toumoro/tm-migration/services/configure.sh vendor/toumoro/tm-migration/services/configure.sh ``` **5. Export `CType` and `list_type` values to JSON or CSV (optional):** - These CType/ListType export commands prepare for the execution of Upgrade Wizards. - Allows you to generate the mapping from ListType to CType in order to specify them in setting.php (tm\_migration\[cTypeToListTypeMappingArray\]). ``` vendor/bin/typo3 tmexport:types -t [FILE_TYPE] -m [FILE_NAME] ``` Example for CSV: ``` vendor/bin/typo3 tmexport:types -t csv -m types.csv ``` Example for JSON: ``` vendor/bin/typo3 tmexport:types -t json ``` **6. Fix duplicate MM relations command ( only if needed ) :** - 6.0. Exécuter la commande de correction des doublons MM : ``` vendor/bin/typo3 tmupgrade:fixdatabaseerrors ``` - 6.1. Exécuter la commande de update schema : ``` vendor/bin/typo3 database:updateschema "*.add,*.change" ``` **7. Run Upgrade Wizards:** ``` vendor/bin/typo3 tmupgrade:run ``` **8. Copy Rector & Fractor configuration files to your project:** ``` cp vendor/toumoro/tm-migration/Resources/Private/Config/Rector/rector_v13.php . cp vendor/toumoro/tm-migration/Resources/Private/Config/Fractor/fractor_v13.php . ``` **9. Run Rector & Fractor in dry-run mode (simulation):** ``` vendor/bin/rector process --debug --dry-run 2>&1 | tee rector-dryrun.txt vendor/bin/fractor process --dry-run 2>&1 | tee fractor-dryrun.txt ``` **10. Apply Rector & Fractor corrections:** ``` vendor/bin/rector process vendor/bin/fractor process ``` > **Tip:**Using `--debug` with Rector avoids issues caused by parallel processing. **11. Import SQL files (before and after database schema update):** ``` vendor/bin/typo3 tmupgrade:importsql -f [FILE_NAME] vendor/bin/typo3 tmupgrade:importsql -d [DIRECTORY] ``` Example: ``` vendor/bin/typo3 tmupgrade:importsql -f migration.sql vendor/bin/typo3 tmupgrade:importsql -d before-updateschema ``` **12. Seperate history entries from sys\_log command ( only if migrating a site from TYPO3 version < 9.5 ):** ``` vendor/bin/typo3 tmupgrade:sepearate-syshistory-from-syslog -d [DAYS] -l [LIMIT] ``` --- Run All Steps Script: --------------------- [](#run-all-steps-script) - Use this script to re-simulate migration steps or for the day of production deployment. ``` chmod +x migration/run.sh migration/run.sh ``` ### Health Score 44 — FairBetter than 92% of packages Maintenance66 Regular maintenance activity Popularity24 Limited adoption so far Community14 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 77.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~13 days Total 11 Last Release 204d ago PHP version history (3 changes)13.4.0PHP >=8.1 v13.4.1PHP ^8.1 || ^8.2 v13.4.10PHP >= 8.1 < 8.5 ### Community Maintainers ![](https://www.gravatar.com/avatar/ded88026dc7bfd3d5a42cd486830ba428b8e2cc3cf0c9835fbcf25e6f9a61483?d=identicon)[tm\_souellet](/maintainers/tm_souellet) ![](https://www.gravatar.com/avatar/e74a2ef1f9ad7854090fee38c884708070dc9c7ad20c4751c989550e73e95b05?d=identicon)[tm-lmathieu](/maintainers/tm-lmathieu) ![](https://www.gravatar.com/avatar/f23ec0cffa408a37e7e57dbf28cfbe38c87d3126eb1724374e5ae6bd2ff05c36?d=identicon)[mehdiguermazi](/maintainers/mehdiguermazi) --- Top Contributors [![tm-hdaoud](https://avatars.githubusercontent.com/u/211350868?v=4)](https://github.com/tm-hdaoud "tm-hdaoud (61 commits)")[![mehdiguermazi](https://avatars.githubusercontent.com/u/73132442?v=4)](https://github.com/mehdiguermazi "mehdiguermazi (15 commits)")[![tm-lmathieu](https://avatars.githubusercontent.com/u/16961738?v=4)](https://github.com/tm-lmathieu "tm-lmathieu (2 commits)")[![simouel](https://avatars.githubusercontent.com/u/56318224?v=4)](https://github.com/simouel "simouel (1 commits)") --- Tags migrationtypo3Toumoro ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/toumoro-tm-migration/health.svg) ``` [![Health](https://phpackages.com/badges/toumoro-tm-migration/health.svg)](https://phpackages.com/packages/toumoro-tm-migration) ``` ### Alternatives [in2code/migration Framework for any kind of TYPO3 migrations and imports. Also exports and imports content from and to json files. 6277.0k3](/packages/in2code-migration)[wazum/sluggi TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects 39488.5k](/packages/wazum-sluggi)[a9f/typo3-fractor TYPO3 extension for the File Read-Analyse-Change Tool. Allows modifying XML files 17213.8k36](/packages/a9f-typo3-fractor)[stefanfroemken/mysqlreport Analyze and profile your TYPO3 databases queries 1314.9k](/packages/stefanfroemken-mysqlreport) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)