creifenscheid/db-rector

This TYPO3 extension is an typo3-rector adapter with backend module to refactor sys_template.config data.

v12.3.0 2024-06-25 11:49 UTC

Requires

• php: ^8.1||^8.2
• ssch/typo3-rector: ^1
• typo3/cms-core: ^11.5||^12.4

Requires (Dev)

• roave/security-advisories: dev-latest

Replaces

• typo3-ter/db-rector: v12.3.0

GPL-2.0-or-later

• Christian Reifenscheid

README

Disclaimer

It is recommended to NOT run this extension in productive environments!

Installation

This extension must be installed via composer, e.g. composer req -dev creifenscheid/db-rector, to install typo3-rector and get it running. You can download it from the TYPO3 Extension Repository, but it still has to be installed via composer.

What does it do

This extension is an adapter to run typo3-rector in the TYPO3 backend to refactor typoscript stored in sys_template.config.

Features

• backend module to
  • view all typoscript stored in the db
  • run typo3-rector on single db entries
  • Review the result of the typo3-rector process (incl. diff view)
  • apply typo3-rector result to the corresponding sys_template record
  • roll back the original typoscript
• security
  • backend module is only active in TYPO3 context „development“ by default

Note

If the sys_template record has been adjusted after the rector process or the applying of the rector result, the corresponding rector model is going to be reset.
So the updated sys_template typoscript can be processed again.

Known working setups

• DDEV (TYPO3 11, TYPO3 12)

Known not working setups

• MacOS + MAMP

Configuration

Extension configuration

Rector configuration

To configure typo3-rector a file named rector.php is required.
This file is generated more or less automatically.
There is some sort of „template“, which is copied into the working folder.

Since just typoscript refactoring is needed, the rector config file is kept small and simple.

The following configuration parameter are defined dynamically:

Support

I don't want your money or anything else. I am doing this for fun, with heart and to improve my coding skills. Constructive critisism is very welcome. If you want to contribute, feel free to do so. Thank you!