Mo4 Coding Standard Laravel Package

Product Decisions This Supports

• Enforce consistency in PHP/Laravel codebases: Aligns with Symfony’s coding standards while adding MO4-specific rules (e.g., array formatting, use statement ordering, string interpolation). Reduces cognitive load for developers by standardizing style.
• Accelerate onboarding: New developers can quickly adapt to project conventions, reducing time spent debating formatting.
• Automate code quality: Integrates with CI/CD pipelines (e.g., GitHub Actions) to block non-compliant PRs, improving maintainability.
• Build vs. buy: Avoids reinventing a custom ruleset; leverages battle-tested Symfony/Slevomat standards with MO4 extensions.
• Use cases:
  • Laravel monorepos with multiple teams.
  • Projects adopting Symfony-like conventions (e.g., Doctrine, API Platform).
  • Teams prioritizing readability over strict PSR compliance (e.g., omitting class docblocks).

When to Consider This Package

• Adopt if:
  • Your team uses Symfony, Laravel, or Doctrine and values consistency.
  • You’re migrating from PSR-12 or need stricter formatting (e.g., array alignment, use statement ordering).
  • You want auto-fixable rules (e.g., phpcbf for 80% of violations).
  • Your codebase is PHP 8.1+ (minimum requirement).
• Look elsewhere if:
  • You need PSR-12 strict compliance (this omits some PSR rules, like class docblocks).
  • Your team prefers custom rules (e.g., unique business logic formatting).
  • You’re not using PHP_CodeSniffer (alternatives: PHPStan, Psalm, or custom ESLint).
  • Your project is pre-PHP 7.2 (minimum PHP version).

How to Pitch It (Stakeholders)

For Executives: "This package standardizes our PHP/Laravel codebase using Symfony’s proven conventions, reducing technical debt and onboarding time. It automates 80% of formatting fixes via CI, letting devs focus on features—not style debates. Low maintenance (MIT-licensed, actively updated) and integrates seamlessly with our existing toolchain."

For Engineering: "MO4 Coding Standard extends Symfony’s rules with Laravel-friendly additions (e.g., array alignment, use statement sorting). Most violations auto-fix with phpcbf, and it’s configurable—we can tweak use-statement ordering or disable rules like class docblocks. Lightweight (~17 stars but backed by Mayflower’s infrastructure)."