Download the PHP package toumoro/tm-migration without Composer
On this page you can find all versions of the php package toumoro/tm-migration. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download toumoro/tm-migration
More information about toumoro/tm-migration
Files in toumoro/tm-migration
Package tm-migration
Short Description TYPO3 extension that brings together the tools used for a major TYPO3 migration.
License GPL-2.0-or-later
Homepage https://github.com/toumoro/tm_migration
Informations about the package tm-migration
tm_migration
TYPO3 extension that brings together essential tools for major TYPO3 migrations.
đ Features
â Dependencies
This extension relies on:
typo3-fractor
typo3-rector
core-upgrader
đ CLI Commands
Export CTypes and List Types Command
Export CType
and list_type
values to JSON or CSV:
Example for CSV:
Example for JSON:
Fix duplicate MM relations Command
Clean up duplicate entries in MM relation tables (e.g. sys_category_record_mm
):
SQL Migration Command
This command allows the execution of custom SQL scripts as part of the migration process. It's especially useful for applying additional database changes that are not handled automatically by TYPO3 or Doctrine migrations.
Prerequisites
Ensure the migration folder is copied to the base directory of your project. This folder contains the necessary SQL scripts and structure required for the migration process.
Usage
-f [FILE_NAME]
: Specifies the SQL file to execute. If omitted, it defaults tomigration.sql
.-
-d [DIRECTORY]
: (Optional) Use this to specify a custom directory where the SQL file is located.There are two predefined directories under the
migration
folder:before-updateschema
: for SQL scripts that should run before the TYPO3 schema update.after-updateschema
: for scripts that should run after the schema update.
For full list of options, run:
Execute the Project-Level Migration and Setup Script
Clear sys_log Command
Command that clears the sys_log entries not related to sys_history and older than -d Days with limit -l Limit.
Upgrade Wizards Execution Command
Two options are available in the extension settings :
- Specify the version from which the upgrade wizards should start executing.
- Exclude specific upgrade wizard identifiers from being executed.
đ§Š Upgrade Wizards
-
Migrate
list_type
toCType
Upgrade wizard to migratelist_type
plugins toCType
content elements using a configurable mapping array.
The mapping can be customized via thetm_migration
extension settings. -
Clean log table
Upgrade wizard to delete or truncate entries fromsys_log
based on the retention period set in the extension settings. -
Migrate grid elements to container
Upgrade wizard to migrategrid elements
tocontainer
content elements. - Fix Broken Redirects
Upgrade wizard to repair broken redirects after a major migration.
âī¸ Rector & Fractor Configurations
Sample Rector and Fractor configurations are provided in:
To copy them into your project:
đ Dry Runs (Simulations)
Before applying automatic fixes, you can run Rector and Fractor in dry-run mode to preview changes:
Run Rector dry-run:
Run Fractor dry-run:
⥠Apply automatic fixes
When ready, apply the code modifications:
âšī¸ Tip:
Using--debug
with Rector avoids issues caused by parallel processing.
Update composer dependencies to the latest version (to be tested and reviewed)
All versions of tm-migration with dependencies
typo3/cms-core Version ^12.4.0 || ^13.4.0
a9f/typo3-fractor Version ^v0.5.1
ssch/typo3-rector Version ^2.14.4 || ^v3.5.0
wapplersystems/core-upgrader Version dev-release/v12 || dev-release/v13