Automatisiere TYPO3 Upgrades: Vollständig Rector Leitfaden 2025

composer global require ssch/typo3-rector

# Add to your ~/.bashrc or ~/.zshrc
export PATH="$PATH:$HOME/.composer/vendor/bin"

typo3-rector --version

composer require --dev ssch/typo3-rector

wget https://github.com/sabbelasichon/typo3-rector/releases/latest/download/typo3-rector.phar
chmod +x typo3-rector.phar

<?php

declare(strict_types=1);

use Rector\Config\RectorConfig;
use Ssch\TYPO3Rector\Set\Typo3SetList;

return RectorConfig::configure()
    ->withPaths([
        __DIR__ . '/typo3conf/ext/your_extension',
        // Add more paths as needed
    ])
    ->withSets([
        Typo3SetList::TYPO3_95,
        Typo3SetList::TYPO3_104,
        Typo3SetList::TYPO3_11,
        Typo3SetList::TYPO3_12,
    ])
    ->withSkip([
        // Skip specific files or directories
        __DIR__ . '/typo3conf/ext/your_extension/Resources',
    ]);

->withPaths([
    __DIR__ . '/typo3conf/ext',
    __DIR__ . '/packages',
    __DIR__ . '/src',
])

->withSets([
    Typo3SetList::TYPO3_76,      // For v7.6 migrations
    Typo3SetList::TYPO3_87,      // For v8.7 migrations  
    Typo3SetList::TYPO3_95,      // For v9.5 migrations
    Typo3SetList::TYPO3_104,     // For v10.4 migrations
    Typo3SetList::TYPO3_11,      // For v11 migrations
    Typo3SetList::TYPO3_12,      // For v12 migrations
    Typo3SetList::TYPO3_13,      // For v13 migrations
])

->withSkip([
    __DIR__ . '/vendor',
    __DIR__ . '/typo3',
    '*/Resources/Private/Vendor/*',
])

git add .
git commit -m "Backup before Rector migration"

typo3-rector process --dry-run

typo3-rector process

git diff

// rector.php
return RectorConfig::configure()
    ->withPaths([
        __DIR__ . '/typo3conf/ext/your_extension',
    ])
    ->withSets([
        Typo3SetList::TYPO3_11,
    ]);

// rector.php for extension development
return RectorConfig::configure()
    ->withPaths([
        __DIR__ . '/Classes',
        __DIR__ . '/Configuration',
    ])
    ->withSets([
        Typo3SetList::TYPO3_12,
        Typo3SetList::TYPO3_13,
    ])
    ->withSkip([
        __DIR__ . '/Resources',
        __DIR__ . '/Documentation',
    ]);

return RectorConfig::configure()
    ->withPaths([
        __DIR__ . '/typo3conf/ext',
        __DIR__ . '/packages',
    ])
    ->withSets([
        Typo3SetList::TYPO3_95,
        Typo3SetList::TYPO3_104,
        Typo3SetList::TYPO3_11,
        Typo3SetList::TYPO3_12,
    ])
    ->withSkip([
        '*/Resources/Private/Vendor/*',
        '*/node_modules/*',
        '*/Resources/Public/JavaScript/Contrib/*',
    ]);

use Rector\Php74\Rector\Property\TypedPropertyRector;
use Rector\DeadCode\Rector\ClassMethod\RemoveUnusedPromotedPropertyRector;

return RectorConfig::configure()
    ->withRules([
        TypedPropertyRector::class,
        RemoveUnusedPromotedPropertyRector::class,
    ])
    ->withSets([
        Typo3SetList::TYPO3_12,
    ]);

return RectorConfig::configure()
    ->withParallel()
    ->withPaths([
        __DIR__ . '/typo3conf/ext',
    ]);

return RectorConfig::configure()
    ->withMemoryLimit('2G')
    ->withPaths([
        __DIR__ . '/typo3conf/ext',
    ]);

// First: TCA migrations
return RectorConfig::configure()
    ->withSets([
        Typo3SetList::TCA_120,
    ]);

// Second: Code migrations  
return RectorConfig::configure()
    ->withSets([
        Typo3SetList::TYPO3_12,
    ]);

git add .
git commit -m "Apply TYPO3 v11 Rector rules"

git add .
git commit -m "Apply TYPO3 v12 Rector rules"

php -d memory_limit=2G vendor/bin/typo3-rector process

return RectorConfig::configure()
    ->withMemoryLimit('2G')
    ->withParallel(4); // Adjust based on CPU cores

return RectorConfig::configure()
    ->withSkip([
        SpecificRectorRule::class,
        SpecificRectorRule::class => [
            __DIR__ . '/specific/file.php',
        ],
    ]);

typo3-rector process --debug

php -d xdebug.mode=debug vendor/bin/typo3-rector process

$dispatcher = GeneralUtility::makeInstance(Dispatcher::class);
$dispatcher->connect(
    DataHandler::class,
    'processDatamap_afterDatabaseOperations',
    MyClass::class,
    'handleAfterDatabaseOperations'
);

// In Services.yaml
services:
  MyVendor\MyExtension\EventListener\AfterDatabaseOperationsEventListener:
    tags:
      - name: event.listener
        identifier: 'my-after-database-operations'
        event: TYPO3\CMS\Core\DataHandling\Event\AfterDatabaseOperationsEvent

$GLOBALS['TCA']['pages']['columns']['doktype']['items'][] = [
    'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:pages.doktype.custom',
    123,
    'EXT:my_extension/Resources/Public/Icons/custom.svg'
];

$GLOBALS['TCA']['pages']['columns']['doktype']['items'][] = [
    'label' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:pages.doktype.custom',
    'value' => 123,
    'icon' => 'EXT:my_extension/Resources/Public/Icons/custom.svg'
];

$absPath = GeneralUtility::getFileAbsFileName('EXT:my_extension/Resources/Private/Templates/');

$absPath = GeneralUtility::getFileAbsFileName('EXT:my_extension/Resources/Private/Templates/') ?: '';

jobs:
  rector:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: 8.1
          
      - name: Install dependencies
        run: composer install --no-dev --optimize-autoloader
        
      - name: Run Rector
        run: vendor/bin/typo3-rector process --dry-run

rector:
  image: php:8.1
  script:
    - composer install --no-dev
    - vendor/bin/typo3-rector process --dry-run
  only:
    - merge_requests

return RectorConfig::configure()
    ->withParallel(8)
    ->withMemoryLimit('4G')
    ->withPaths([
        __DIR__ . '/typo3conf/ext',
    ])
    ->withSkip([
        '*/Tests/*',
        '*/Documentation/*',
        '*/Resources/Public/*',
    ]);

# Get list of changed PHP files
CHANGED_FILES=$(git diff --name-only --diff-filter=AM main...HEAD | grep '\.php$')

# Run Rector only on changed files
typo3-rector process $CHANGED_FILES

typo3-rector --version

composer require --dev a-r-m-i-n/fractor

// fractor.php
use TYPO3\Fractor\Configuration\FractorConfiguration;

return FractorConfiguration::configure()
    ->withFileExtensions(['typoscript', 'ts', 'txt'])
    ->withPaths([
        __DIR__ . '/Configuration/TypoScript',
    ]);

// Before
$GLOBALS['TYPO3_DB']->exec_SELECTquery(/* ... */);

// After  
GeneralUtility::makeInstance(ConnectionPool::class)
    ->getConnectionForTable('pages')
    ->select(/* ... */);

// Before
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'][] = 'MyClass';

// After
// Event listener registration in Services.yaml

// Before
'items' => [
    ['Label', 'value'],
]

// After
'items' => [
    ['label' => 'Label', 'value' => 'value'],
]

<?php

namespace MyVendor\MyExtension\Rector;

use Rector\Core\Rector\AbstractRector;
use Symplify\RuleDocGenerator\ValueObject\RuleDefinition;

final class MyCustomRector extends AbstractRector
{
    public function getRuleDefinition(): RuleDefinition
    {
        return new RuleDefinition(
            'Replace custom deprecated method',
            [/* examples */]
        );
    }

    public function getNodeTypes(): array
    {
        return [MethodCall::class];
    }

    public function refactor(Node $node): ?Node
    {
        // Your custom refactoring logic
        return $node;
    }
}