ssch/typo3-rector

Instant fixes for your TYPO3 PHP code by using Rector.

Maintainers

Details

github.com/sabbelasichon/typo3-rector

Homepage

Source

Issues

Chat

Documentation

Fund package maintenance!
sabbelasichon
paypal.me/schreiberten

Installs: 1 533 106

Dependents: 133

Suggesters: 1

Security: 0

Stars: 231

Watchers: 12

Forks: 63

Open Issues: 42

Type:rector-extension

v3.0.1 2024-12-20 00:24 UTC

Requires

Requires (Dev)

Suggests

MIT c3ec82f0d9bcd0e44df17c88c5204d95415d74cf

  • Sebastian Schreiber <breakpoint.woop@schreibersebastian.de>
  • Henrik Elsner
  • Simon Schaufelberger

migrationautomationdevupgraderefactoringrector

This package is auto-updated.

Last update: 2024-12-20 23:30:29 UTC

README

Latest Stable Version Total Downloads Monthly Downloads Donate

Rector for TYPO3

This project lets you apply instant upgrades and refactoring to your TYPO3 Website and extension code, making it easier to migrate between TYPO3 releases and keeping your code free from deprecation.

It extends the 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!

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.

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

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

Contributing

Please see CONTRIBUTING for details.

Funding/Sponsoring

Help us out and sponsor our work! Visit our website 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

Please post questions in the TYPO3 Slack channel #ext-typo3-rector or feel free to open an issue or start a discussion on GitHub.

Credits

Many thanks to Tomas Votruba and Abdul Malik Ikhsan for maintaining Rector. Many thanks to All Contributors.

Follow us on X:

License

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

Known Drawbacks

How to Apply Coding Standards?

Rector uses 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 with this setup.