Agent-Skills.md

Agent Skills: PHP Modernization Skill

>-

UncategorizedID: dirnbauer/webconsulting-skills/php-modernization

Repository

dirnbauer/webconsulting-skills
dirnbauerLicense: NOASSERTION
192

Install this agent skill to your local

pnpm dlx add-skill https://github.com/dirnbauer/webconsulting-skills/tree/HEAD/skills/php-modernization

Skill Files

Browse the full folder contents for php-modernization.

Download Skill

Loading file tree…

skills/php-modernization/SKILL.md

Skill Metadata

Name
"php-modernization"
Description
"Use when working with ANY PHP modernization task: upgrading PHP 8.1+ (TYPO3 v14.3 LTS accepts 8.2-8.5), adding strict types, configuring PHPStan/Rector/PHP-CS-Fixer, refactoring to enums/DTOs/readonly/property hooks (PHP 8.4), improving type safety, reviewing PHP code quality. Triggers: PHP upgrade, modernize, type safety, PHPStan, Rector, PHP-CS-Fixer, enum, DTO, readonly, strict_types, property hooks, PHP 8.5."

PHP Modernization Skill

Modernize PHP applications to PHP 8.x with type safety, PSR compliance, and static analysis.

Expertise Areas

  • PHP 8.x: Constructor promotion, readonly, enums, match, attributes, union/intersection types, #[Override], typed constants, #[SensitiveParameter], property hooks
  • PSR/PER Compliance: Active PHP-FIG standards (PSR-3/4/6/7/11/14/15/16/17/18/20, PER-CS)
  • Static Analysis: PHPStan (level 9+, treatPhpDocTypesAsCertain: false), PHPat, Rector, PHP-CS-Fixer
  • Type Safety: DTOs/VOs over arrays, generics via PHPDoc, copy-on-write awareness
  • Pitfalls: DOMDocument UTF-8 encoding, PHP-CS-Fixer deprecated aliases

Reference Documentation

| Topic | Reference File | |-------|---------------| | PHP 8.0-8.5 features | references/php8-features.md | | PSR/PER compliance | references/psr-per-compliance.md | | PHPStan levels | references/phpstan-compliance.md | | Static analysis tools | references/static-analysis-tools.md | | PHP-CS-Fixer deprecations | references/php-cs-fixer-deprecations.md | | Type safety, DTOs | references/type-safety.md | | Request DTOs | references/request-dtos.md | | Adapter registry | references/adapter-registry-pattern.md | | Multi-version adapters | references/multi-version-adapters.md | | Symfony patterns | references/symfony-patterns.md | | TYPO3 PSR patterns | references/typo3-psr-patterns.md | | Migration planning | references/migration-strategies.md |

Always run vendor/bin/php-cs-fixer fix --dry-run 2>&1 | grep -A 20 "Detected deprecations" to check for deprecated rules.

Running Scripts

Verify a project: scripts/verify-php-project.sh /path/to/project

Required Tools

| Tool | Requirement | |------|-------------| | PHPStan | Level 9 minimum, level 10 recommended | | PHPat | Required for defined architectures | | Rector | Required for automated modernization | | PHP-CS-Fixer | Required with @PER-CS ruleset |

Core Rules

  • DTOs required over arrays for structured data
  • Backed enums required for fixed value sets (not constants)
  • PSR interfaces for type-hinting dependencies (PSR-3, PSR-6, PSR-7, PSR-11, PSR-14, PSR-18)

See references/core-rules.md for code examples and scoring criteria.

Migration Checklist

  • [ ] declare(strict_types=1) in all files
  • [ ] PER Coding Style via PHP-CS-Fixer (@PER-CS) with no deprecated aliases
  • [ ] PHPStan level 9+ (treatPhpDocTypesAsCertain: false, level 10 for new projects)
  • [ ] PHPat architecture tests for layer boundaries
  • [ ] Return types and parameter types on all methods
  • [ ] DTOs for data transfer, no array params/returns
  • [ ] Backed enums for all status/type values
  • [ ] Type-hint against PSR interfaces, not implementations
  • [ ] #[Override] on overridden methods (PHP 8.3+)
  • [ ] #[SensitiveParameter] on password/secret params (PHP 8.2+)
  • [ ] Typed class constants (PHP 8.3+)

Contributing: https://github.com/netresearch/php-modernization-skill

Credits & Attribution

This skill is based on the excellent work by Netresearch DTT GmbH.

Original repository: https://github.com/netresearch/php-modernization-skill

Copyright (c) Netresearch DTT GmbH — Methodology and best practices (MIT / CC-BY-SA-4.0)

Special thanks to Netresearch DTT GmbH for their generous open-source contributions to the TYPO3 community, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection