Typo3 Fractor Laravel Package

Product Decisions This Supports

• TYPO3 Modernization & Upgrade Efficiency: Accelerates migration from older TYPO3 versions (e.g., pre-14) by automating TypoScript, YAML, and Fluid template updates, reducing manual refactoring effort.
• DevOps & CI/CD Integration: Enables automated pre-commit or pre-deployment checks to catch deprecated syntax early, improving code quality and reducing production incidents.
• Cost Savings (Build vs. Buy): Avoids hiring specialized TYPO3 consultants for manual upgrades by leveraging open-source tooling, lowering long-term maintenance costs.
• Roadmap for TYPO3 14+ Adoption: Critical for teams planning to upgrade to newer TYPO3 LTS versions, where backward compatibility breaks are inevitable.
• Custom Rule Development: Extensible for internal TYPO3-specific linting/rules (e.g., enforcing team coding standards) via the underlying Fractor framework.

When to Consider This Package

• Adopt if:

  • Your team maintains a TYPO3 10/11/12/13 instance and plans upgrades to v14+.
  • You need to automate TypoScript/XML/Fluid template refactoring (e.g., replacing deprecated lib.page with page in Fluid).
  • Your workflow includes CI/CD pipelines where pre-merge validation of TYPO3 syntax is valuable.
  • You’re comfortable with PHP-based tooling and can validate changes via dry-run.

• Look elsewhere if:

  • Your TYPO3 version is already v14+ (no upgrade path needed).
  • Your project relies heavily on custom XML/TypoScript that isn’t covered by the predefined rules.
  • Your team lacks PHP/composer expertise to configure or debug the tool.
  • You need real-time IDE integration (e.g., VSCode linting) instead of CLI-based batch processing.
  • Your TYPO3 instance is highly customized with unsupported extensions (risk of breaking changes).

How to Pitch It (Stakeholders)

For Executives: "TYPO3 Fractor is a low-cost, high-impact tool to automate the painful process of upgrading our TYPO3 instance to v14+. By running this in our CI pipeline, we can catch and fix deprecated code early—reducing upgrade time from weeks to days and cutting consultant fees. The MIT license and active maintenance (via the Fractor monorepo) make it a safe bet for our roadmap."

For Engineering/DevOps: *"This is a TYPO3-specific fork of Fractor, a PHP-based refactoring tool. It’ll let us:

• Auto-fix TypoScript/XML/Fluid deprecations before they block upgrades.
• Run in CI as a pre-commit hook or GitHub Action to enforce modern TYPO3 syntax.
• Extend rules if needed (e.g., for custom extensions). Warning: Always test changes locally first—this is a dev-only tool (never run in prod). Start with --dry-run to review diffs."*

For Developers: *"Think of it like ESLint for TYPO3—but for your templates and TypoScript. Install it via Composer, configure it to target your Configuration/TypoScript/ or Resources/Private/ folders, and let it handle the boring parts of upgrades. Example:

composer require a9f/typo3-fractor --dev
./vendor/bin/fractor process --dry-run  # Preview changes

Pro tip: Pair it with typo3-rector for PHP-level upgrades."*