PHPackages                             ssch/typo3-rector - 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 &amp; ORM](/categories/database)
4. /
5. ssch/typo3-rector

ActiveRector-extension[Database &amp; ORM](/categories/database)

ssch/typo3-rector
=================

Instant fixes for your TYPO3 PHP code by using Rector.

v3.13.0(2mo ago)2592.8M↑15.1%66[31 issues](https://github.com/sabbelasichon/typo3-rector/issues)[2 PRs](https://github.com/sabbelasichon/typo3-rector/pulls)20MITPHPPHP ^7.4 || ^8.0CI passing

Since Sep 25Pushed 1mo ago10 watchersCompare

[ Source](https://github.com/sabbelasichon/typo3-rector)[ Packagist](https://packagist.org/packages/ssch/typo3-rector)[ Docs](https://www.typo3-rector.com/)[ Fund](https://paypal.me/schreiberten)[ GitHub Sponsors](https://github.com/sabbelasichon)[ RSS](/packages/ssch-typo3-rector/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (46)Versions (223)Used By (20)

[![Latest Stable Version](https://camo.githubusercontent.com/da38dc8fa5e75bf6c3551cfba8e8620c6ef37c0318c558f655cd955c9a6bd93c/68747470733a2f2f706f7365722e707567782e6f72672f737363682f7479706f332d726563746f722f762f737461626c652e737667)](https://packagist.org/packages/ssch/typo3-rector)[![Total Downloads](https://camo.githubusercontent.com/417f8452ee65c7918d68f6f7c2dc90a2bb9c74bb5629f1556eabd15a2698c188/68747470733a2f2f706f7365722e707567782e6f72672f737363682f7479706f332d726563746f722f642f746f74616c2e737667)](https://packagist.org/packages/ssch/typo3-rector)[![Monthly Downloads](https://camo.githubusercontent.com/595a6c7e359a06b444fe6b9a38063fb77387386e1a4a2f687c7ad27c29e38a21/68747470733a2f2f706f7365722e707567782e6f72672f737363682f7479706f332d726563746f722f642f6d6f6e74686c79)](https://packagist.org/packages/ssch/typo3-rector)[![Donate](https://camo.githubusercontent.com/604e3db9c8751116b3f765aad0353ec7ded655bbe8aaacbc38d8c4a6b784b3ed/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d50617950616c2d677265656e2e737667)](https://www.paypal.me/schreiberten)

Rector for TYPO3
================

[](#rector-for-typo3)

This project lets you apply instant upgrades and refactoring to your [TYPO3 Website](https://get.typo3.org/) and [extension](https://extensions.typo3.org) code, making it easier to migrate between TYPO3 releases and keeping your code free from deprecation.

It extends the [Rector](https://github.com/rectorphp/rector) project, which aims to provide instant upgrades and refactoring for any PHP code (5.3+).

Warning

❗ Never run this tool on production! Always run it on development environment where code is under version control (e.g. git). Review and test changes before releasing to production. Code migrations could potentially break your website!

URL**Repository:****Documentation:****Packagist:****Website:**Installation
------------

[](#installation)

TYPO3 Rector requires at least PHP 7.4 but is also compatible with PHP 8. You can find more details about the installation in our [installation documentation](docs/installation.md).

You can install the package via composer:

```
composer require --dev ssch/typo3-rector
```

You can create the rector config file with:

```
vendor/bin/typo3-init
```

Usage
-----

[](#usage)

To see the code migrations that Rector will do, run:

```
vendor/bin/rector process --dry-run
```

and when you want to execute the migrations run:

```
vendor/bin/rector process
```

Version matrix
--------------

[](#version-matrix)

v1v2, v3**TYPO3 versions**7 - 12 (not all rules)10 - 14 rules**file support**all files (typoscript, flexform, ...)only PHP filesRelated software
----------------

[](#related-software)

- [fractor](https://github.com/andreaswolf/fractor/) with its [typo3-fractor](https://github.com/andreaswolf/fractor/blob/main/packages/typo3-fractor/docs/typo3-fractor-rules.md)rules that migrate TypoScript, FlexForm, YAML and Fluid template files.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](docs/contribution.md) for details.

Funding/Sponsoring
------------------

[](#fundingsponsoring)

Help us out and sponsor our work! Visit our website [typo3-rector.com](https://www.typo3-rector.com) for more info.

This makes it possible to invest more time to keep the project alive and create even more rules for automated migration.

Support
-------

[](#support)

Please post questions in the TYPO3 Slack channel [\#ext-typo3-rector](https://typo3.slack.com/archives/C019R5LAA6A)or feel free to open an issue or start a discussion on GitHub.

Credits
-------

[](#credits)

Many thanks to [Tomas Votruba](https://tomasvotruba.com) and [Abdul Malik Ikhsan](https://github.com/samsonasik) for maintaining Rector. Many thanks to [All Contributors](https://github.com/sabbelasichon/typo3-rector/graphs/contributors).

Follow us on X:

- [TYPO3 Rector](https://x.com/TYPO3Rector)
- [Sebastian](https://x.com/schreiberten)
- [Henrik](https://x.com/he_coli)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

Known Drawbacks
---------------

[](#known-drawbacks)

### How to Apply Coding Standards?

[](#how-to-apply-coding-standards)

Rector uses [nikic/php-parser](https://github.com/nikic/PHP-Parser/), built on technology called an *abstract syntax tree* (AST). An AST doesn't know about spaces and when written to a file it produces poorly formatted code in both PHP and docblock annotations. **That's why your project needs to have a coding standard tool** and a set of formatting rules, so it can make Rector's output code nice and shiny again.

We're using [ECS](https://github.com/symplify/easy-coding-standard) with [this setup](ecs.php).

###  Health Score

71

—

ExcellentBetter than 100% of packages

Maintenance86

Actively maintained with recent releases

Popularity62

Solid adoption and visibility

Community49

Growing community involvement

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 58.6% 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 ~9 days

Recently: every ~15 days

Total

220

Last Release

69d ago

Major Versions

v2.13.1 → v3.1.02025-02-17

v2.14.3 → v3.5.02025-06-16

v2.15.0 → v3.6.02025-07-10

v2.15.1 → v3.6.12025-08-06

v2.15.2 → v3.7.02025-10-29

PHP version history (5 changes)v0.3.0PHP ^7.2

v0.8.0PHP ^7.3|^8.0

v0.11.0PHP &gt;=8.0

v0.11.32PHP &gt;=8.1

v1.0.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/bebdadb696b19cbbca63cd296ae4e4f48bcf42c20bc483d7b4d0599836dc753d?d=identicon)[schreiberten](/maintainers/schreiberten)

---

Top Contributors

[![sabbelasichon](https://avatars.githubusercontent.com/u/13050560?v=4)](https://github.com/sabbelasichon "sabbelasichon (1694 commits)")[![simonschaufi](https://avatars.githubusercontent.com/u/941794?v=4)](https://github.com/simonschaufi "simonschaufi (621 commits)")[![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (230 commits)")[![helsner](https://avatars.githubusercontent.com/u/16156392?v=4)](https://github.com/helsner "helsner (111 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (56 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (34 commits)")[![MK-42](https://avatars.githubusercontent.com/u/5477999?v=4)](https://github.com/MK-42 "MK-42 (21 commits)")[![samsonasik](https://avatars.githubusercontent.com/u/459648?v=4)](https://github.com/samsonasik "samsonasik (20 commits)")[![ayacoo](https://avatars.githubusercontent.com/u/5963331?v=4)](https://github.com/ayacoo "ayacoo (16 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (8 commits)")[![DanielSiepmann](https://avatars.githubusercontent.com/u/354250?v=4)](https://github.com/DanielSiepmann "DanielSiepmann (7 commits)")[![kitzberger](https://avatars.githubusercontent.com/u/1405149?v=4)](https://github.com/kitzberger "kitzberger (7 commits)")[![oliverklee](https://avatars.githubusercontent.com/u/765746?v=4)](https://github.com/oliverklee "oliverklee (6 commits)")[![Kanti](https://avatars.githubusercontent.com/u/471387?v=4)](https://github.com/Kanti "Kanti (6 commits)")[![Tuurlijk](https://avatars.githubusercontent.com/u/790979?v=4)](https://github.com/Tuurlijk "Tuurlijk (6 commits)")[![126016](https://avatars.githubusercontent.com/u/17493539?v=4)](https://github.com/126016 "126016 (5 commits)")[![t3easy](https://avatars.githubusercontent.com/u/3628035?v=4)](https://github.com/t3easy "t3easy (4 commits)")[![tomasnorre](https://avatars.githubusercontent.com/u/1212481?v=4)](https://github.com/tomasnorre "tomasnorre (4 commits)")[![linawolf](https://avatars.githubusercontent.com/u/48202465?v=4)](https://github.com/linawolf "linawolf (4 commits)")[![maddy2101](https://avatars.githubusercontent.com/u/1925287?v=4)](https://github.com/maddy2101 "maddy2101 (3 commits)")

---

Tags

asthacktoberfestinstant-upgradesphprectorrefactoringtypo3upgradedevautomationmigrationrefactoringupgraderector

###  Code Quality

TestsPHPUnit

Code StyleECS

### Embed Badge

![Health badge](/badges/ssch-typo3-rector/health.svg)

```
[![Health](https://phpackages.com/badges/ssch-typo3-rector/health.svg)](https://phpackages.com/packages/ssch-typo3-rector)
```

###  Alternatives

[rector/rector-src

Instant Upgrade and Automated Refactoring of any PHP code

134391.5k12](/packages/rector-rector-src)[rector/rector

Instant Upgrade and Automated Refactoring of any PHP code

10.3k123.1M6.0k](/packages/rector-rector)[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M568](/packages/symfony-maker-bundle)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
