spiral/code-style
PER-2–based PHP CS Fixer ruleset for Spiral components. Install as a dev dependency, add a .php-cs-fixer.dist.php via the Builder to include project paths, run via composer scripts, and integrate checks or auto-fixes in GitHub Actions CI.
Architecture fit is strong for PHP projects using PHP CS Fixer, as it provides a pre-configured PER-2 ruleset specifically optimized for Spiral (with Laravel compatibility noted in assessments). It operates as a pure configuration wrapper with zero runtime dependencies, fitting seamlessly into existing PHP toolchains. Integration feasibility is high due to minimal setup: Composer require, basic config file creation, and pre-built Composer scripts/GitHub Actions workflows. Technical risks are low for basic usage but include dependency on PHP CS Fixer stability (e.g., v2.3.0 switch to php-cs-fixer/shim could introduce version conflicts), and the future-dated release (2025-10-06) raises questions about data accuracy. Key questions: 1) How actively is this maintained given 0 dependents and only 7 stars? 2) What's the process for updating PER-2 alignment as PHP evolves? 3) How does it handle project-specific exceptions beyond the PER-2 baseline? 4) Is the GitHub Actions integration (spiral/gh-actions@master) stable for production use?
Stack fit is excellent for Laravel/Spiral projects as it extends existing PHP CS Fixer workflows without requiring new infrastructure. Migration path is trivial for new projects (add package + config), while existing projects need to replace custom CS Fixer configs and ensure php-cs-fixer is installed in require-dev. Compatibility is confirmed for PHP 8.0+ (per release notes) but requires explicit installation of PHP CS Fixer (not bundled). Sequencing should prioritize early CI integration: add during initial project setup or before major refactors, with cs:diff runs in PR checks before unit tests. For legacy projects, start with --dry-run to assess impact before enabling auto-fix in CI.
Maintenance effort is near-zero post-setup since it’s configuration-only, but requires periodic package updates to incorporate rule changes (e.g., v2.3.1 fixed PHP 8.4 deprecations). Support risk is high due to 0 dependents and minimal contributor activity—issues would rely solely on GitHub community support with no enterprise SLA. Scaling is robust for any codebase size as it leverages PHP CS Fixer’s efficient processing, but customizations across multiple projects could lead to config fragmentation. Failure modes include PHP CS Fixer version mismatches (e.g., if shim compatibility breaks), incorrect path configurations causing missed files, or rule conflicts triggering CI failures. Ramp-up is extremely fast (15-30 minutes) for teams familiar with PHP CS Fixer; new teams may need basic training on --dry-run and --diff workflows but no deep tooling expertise is required.
How can I help you explore Laravel packages today?