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

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

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

Instant fixes for your TYPO3 PHP code by using Rector.

v3.14.2(2w ago)2603.2M↓19.7%69[27 issues](https://github.com/sabbelasichon/typo3-rector/issues)[4 PRs](https://github.com/sabbelasichon/typo3-rector/pulls)20MITPHPPHP ^7.4 || ^8.0CI passing

Since Sep 25Pushed 3d 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 3d ago

READMEChangelog (10)Dependencies (92)Versions (229)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)

TYPO3 Rector
============

[](#typo3-rector)

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
```

Documentation
-------------

[](#documentation)

The TYPO3 Rector specific documentation can be found in the [Documentation](docs) folder in this repository, anything Rector specific can be found on the [Rector Website](https://getrector.com/documentation).

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, Fluid template, .htaccess and composer.json 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

74

—

ExcellentBetter than 100% of packages

Maintenance96

Actively maintained with recent releases

Popularity63

Solid adoption and visibility

Community51

Growing community involvement

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 58.3% 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 ~28 days

Total

223

Last Release

17d 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 >=8.0

v0.11.32PHP >=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 (630 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] (58 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (35 commits)")[![samsonasik](https://avatars.githubusercontent.com/u/459648?v=4)](https://github.com/samsonasik "samsonasik (25 commits)")[![MK-42](https://avatars.githubusercontent.com/u/5477999?v=4)](https://github.com/MK-42 "MK-42 (21 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)")[![Tuurlijk](https://avatars.githubusercontent.com/u/790979?v=4)](https://github.com/Tuurlijk "Tuurlijk (6 commits)")[![Kanti](https://avatars.githubusercontent.com/u/471387?v=4)](https://github.com/Kanti "Kanti (6 commits)")[![oliverklee](https://avatars.githubusercontent.com/u/765746?v=4)](https://github.com/oliverklee "oliverklee (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

136406.3k14](/packages/rector-rector-src)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M577](/packages/shopware-core)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[composer/composer

Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere.

29.5k196.2M3.1k](/packages/composer-composer)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k251.2M25.3k](/packages/friendsofphp-php-cs-fixer)

PHPackages © 2026

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