Facile Coding Standard Laravel Package

Product Decisions This Supports

• Build vs. buy: Provides a pre-configured, enterprise-grade coding standard (used internally by Facile.it) that eliminates the need to build/maintain custom PHP-CS-Fixer rules, reducing technical debt and accelerating onboarding.
• Roadmap priorities:
  • Team scalability: Enforces consistent code structure across projects, reducing cognitive load in code reviews and improving maintainability.
  • Modernization: Aligns with PHP 8.1+ and PSR-12+ standards, supporting long-term compatibility with newer Laravel and PHP ecosystems.
  • Risk mitigation: Introduces risky rule sets (e.g., @PER-CS3x0:risky) to gradually enforce stricter standards, reducing disruption while improving code quality.
  • Automated refactoring: Integrates Rector for safe, rule-based code transformations, enabling proactive improvements without manual effort.

When to Consider This Package

• Adopt if:
  • Your team uses Laravel/PHP and needs consistent, scalable coding standards without reinventing the wheel.
  • You prioritize reducing technical debt in legacy codebases or accelerating onboarding for new developers.
  • You want built-in risk management (e.g., @PER-CS3x0:risky) to phase in stricter rules without breaking changes.
  • Your stack supports PHP 8.1+ (dropped PHP 7.4/8.0 support in v1.5.0).
• Look elsewhere if:
  • You require PHP 7.4/8.0 compatibility (this package no longer supports these versions).
  • Your team prefers custom rule sets over pre-configured standards.
  • You lack CI/CD integration for automated linting/refactoring (this package assumes such infrastructure).

How to Pitch It (Stakeholders)

For Executives: "This package replaces manual coding standard enforcement with a battle-tested, Facile.it-proven solution that cuts code review time and reduces bugs. It’s like hiring a senior PHP architect to audit every commit—automatically. With Rector integration, we can even refactor legacy code safely at scale. The risky rule sets let us phase in improvements without disrupting releases."

For Engineering: "We’re upgrading to PER-CS 3.0, which now enforces trailing commas in all multi-line statements (not just arrays) and adds new rules for promoted properties, redundant readonly, and whitespace in arrays. The drop of PHP 7.4/8.0 support aligns us with modern Laravel, and Rector lets us automate fixes. This is a low-risk, high-reward upgrade for consistency and maintainability."