PHPackages appzap/migrator - 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. appzap/migrator ActiveTypo3-cms-extension[Database & ORM](/categories/database) appzap/migrator =============== A TYPO3 Extension for SQL Migrations 1.2.0(11y ago)95014GPL-2.0PHP Since Jul 11Pushed 10y ago2 watchersCompare [ Source](https://github.com/smichaelsen/typo3-migrator)[ Packagist](https://packagist.org/packages/appzap/migrator)[ RSS](/packages/appzap-migrator/feed)WikiDiscussions develop Synced 6d ago READMEChangelogDependenciesVersions (10)Used By (0) TYPO3 Migrator [![exticon](https://raw.githubusercontent.com/smichaelsen/typo3-migrator/develop/ext_icon.gif)](https://raw.githubusercontent.com/smichaelsen/typo3-migrator/develop/ext_icon.gif) ================================================================================================================================================================================================= [](#typo3-migrator-) A TYPO3 Extension for SQL Migrations ------------------------------------ [](#a-typo3-extension-for-sql-migrations) Today TYPO3 projects are mostly developed and deployed using git. This extension can help you to work with SQL changes in this environment. Apply SQL changes on all developer instances or even deploy changes to your Live System. What it does ------------ [](#what-it-does) The migrator just executes numbered sql files (`001.sql`, `002.sql`, etc) that you place in a certain directory. Once the migrator is called it checks for new .sql files and executes them in the right order. So if you want to distribute a SQL Command (e.g. an INSERT statement for a new record) accross your installations, just create a file with a higher number than the existing ones and push it into your repository. Once others pull it and execute the migrator they will have your changes applied! Setup ----- [](#setup) - Make sure the backend user `_cli_lowlevel` exists. It doesn't need any rights. - Create a folder where you want to have your SQL files. If it is inside your web root, protect it with a *.htaccess* file with the following contents: `deny from all`. - Install this Extension using the Extension Manager. - Configure it in the Extension Manager. - *Path to the folder with SQL files*: Relative path to the folder you just created. - *Path to the mysql binary*: Adjust to the mysql binary on your machine. Invoke ------ [](#invoke) The Migrator can be invoked in two ways: ### Command Line [](#command-line) $php cli\_dispatch.phpsh extbase migration:migratesqlfiles ### Scheduler Task [](#scheduler-task) Create a Scheduler Task of the class “Extbase Command Controller Task” and choose “Migrator Migration: migrateSqlFiles” as command. You can invoke the task regularly by cronjob or just by hand when you need it. Troubleshooting --------------- [](#troubleshooting) If the execution of an SQL file fails, the counter of the last last executed file is not increased and the file will be executed again on the next run. Notice that it already might have done changes to your database before it crashed. If you want to see/change the internal pointer of the last executed SQL file, you’ll find it in the table `sys_registry` with the namespace and key `AppZap\Migrator` / `lastExecutedVersion`. ### Can I omit migration numbers? [](#can-i-omit-migration-numbers) Yes, after `003.sql` the next file can be `005.sql`. Be aware once `005.sql` is executed and you add `004.sql` afterwards, `004.sql`will never be executed. ### Can I use timestamps as migration numbers? [](#can-i-use-timestamps-as-migration-numbers) Yes. ### Can I start at 0? [](#can-i-start-at-0) No, at the moment the first file must be `001.sql` or higher. ### Do I need the leading zeros? [](#do-i-need-the-leading-zeros) No, you can also use `1.sql` and so on. ### Can I undo a migration? [](#can-i-undo-a-migration) No, the migrator only knows one direction. You’ll need to do it manually. ### Health Score 34 — LowBetter than 77% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community10 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~58 days Recently: every ~73 days Total 6 Last Release 4036d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/886face3e57e668db2bf95d62325f423baf7e9d8949a9e4c84d3a0e6c3891920?d=identicon)[smichaelsen](/maintainers/smichaelsen) --- Top Contributors [![smichaelsen](https://avatars.githubusercontent.com/u/912435?v=4)](https://github.com/smichaelsen "smichaelsen (6 commits)") ### Embed Badge ![Health badge](/badges/appzap-migrator/health.svg) ``` [![Health](https://phpackages.com/badges/appzap-migrator/health.svg)](https://phpackages.com/packages/appzap-migrator) ``` ### Alternatives [doctrine/orm Object-Relational-Mapper for PHP 10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter a PHP SQL highlighting library 3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database The Illuminate Database package. 2.8k52.4M9.4k](/packages/illuminate-database)[mongodb/mongodb MongoDB driver library 1.6k64.0M546](/packages/mongodb-mongodb)[ramsey/uuid-doctrine Use ramsey/uuid as a Doctrine field type. 90340.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel Reliese Components for Laravel Framework code generation. 1.7k3.4M16](/packages/reliese-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)