Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Compatibility: TYPO3 v14.x
This skill covers patterns for writing code that works on TYPO3 v14.
TYPO3 API First: Always use TYPO3's built-in APIs, core features, and established conventions before creating custom implementations. Do not reinvent what TYPO3 already provides. Always verify that the APIs and methods you use exist and are not deprecated in TYPO3 v14 by checking the official TYPO3 documentation.
1. Introduction to TYPO3 Rector
Rector is an automated refactoring tool that helps migrate TYPO3 between major versions. It applies predefined rules to update deprecated code patterns. For non-PHP migrations (FlexForms, TypoScript, Fluid, YAML), use Fractor -- see the skill.
PHP code
typo3-fractor
Installation
composer require --dev ssch/typo3-rector
# or with DDEV:
ddev composer require --dev ssch/typo3-rector
Important: Rector loads your project's autoloader. For TYPO3 v14 projects, Rector
must run on PHP 8.2+ because TYPO3 v14 packages use readonly classes and other
PHP 8.2 syntax — and webconsulting projects target PHP 8.4+, so run Rector on the same
PHP version the project requires. If your local PHP is older, always use DDEV or a
container: ddev exec vendor/bin/rector process --dry-run
Always run Rector, never skip it. Manual replacements (e.g. strpos -> str_starts_with)
miss edge cases that Rector rules handle correctly. Rector also catches deprecated TYPO3
namespace changes and method signature updates that are hard to find manually.
Incremental upgrades: On a very old codebase you may run UP_TO_TYPO3_13 in a dedicated step first, then UP_TO_TYPO3_14. Published extensions should declare typo3/cms-core: ^14.3 once you ship for v14 — 14.0 through 14.2 no longer receive security updates.
Current state (typo3-rector v3.14, mid-2026)
typo3-rector 3.14 runs on Rector 2.5 and is maintained by Simon Schaufelberger, partly funded through TYPO3 community budgets. Run composer update ssch/typo3-rector before each migration pass so the newest v14 rules apply. Notable in 3.14:
Migrates TYPO3-bundled Fluid class names to standalone Fluid, which TYPO3 v14 uses
Hardens the HashService and MailMessage::send() migrations
2. Running Rector
Dry Run (Preview Changes)
# Show what would be changed
ddev exec vendor/bin/rector process --dry-run
# For specific extension
ddev exec vendor/bin/rector process packages/my_extension --dry-run
Apply Changes
# Apply all changes
ddev exec vendor/bin/rector process
# Apply to specific path
ddev exec vendor/bin/rector process packages/my_extension
Read the full guide when the task needs detailed examples, long templates, troubleshooting matrices, appendices, or sections not included above. Keep this file unloaded for narrow tasks so the skill follows progressive disclosure.
