Phpstan Rules Wrapper Laravel Package

Product Decisions This Supports

• Code Quality & Maintainability: Enable stricter static analysis for Laravel/PHP projects without manual configuration overhead, reducing technical debt and improving developer productivity.
• Developer Experience (DX): Standardize PHPStan rules across teams, reducing inconsistencies in code reviews and onboarding friction.
• Build vs. Buy: Eliminates the need to manually curate and maintain multiple PHPStan rule packages, saving engineering time and reducing dependency sprawl.
• Scalability: Ideal for mid-to-large Laravel projects where code quality is critical (e.g., enterprise SaaS, financial systems, or high-traffic applications).
• Roadmap Alignment: Supports initiatives like:
  • "Zero Bug" initiatives (e.g., catching dead code, type inconsistencies).
  • Performance optimization (e.g., type coverage analysis via tomasvotruba/type-coverage).
  • Security hardening (e.g., deprecation rules, PSR compliance via staabm/phpstan-psr3).
• CI/CD Integration: Enables automated static analysis in pipelines, aligning with DevOps goals for faster, safer deployments.

When to Consider This Package

Adopt when:

• Your team uses PHPStan (or is open to adopting it) for static analysis in a Laravel/PHP codebase.
• You need pre-configured, battle-tested rules without manual setup (e.g., for PHPUnit, Mockery, or strict typing).
• Your project prioritizes code quality, maintainability, or developer productivity over raw speed (installation adds minimal overhead).
• You lack dedicated PHPStan experts to curate rulesets in-house.

Look elsewhere if:

• Your project is small or experimental (overhead may not justify benefits).
• You require custom PHPStan rules not covered by this wrapper (e.g., domain-specific logic).
• Your team prefers alternative tools (e.g., Psalm, PHPMD) or already has a mature PHPStan configuration.
• You’re constrained by legacy PHP versions (<8.4; this package requires PHP 8.4+).
• You need real-time IDE feedback (this is CLI-focused; pair with PHPStan’s IDE plugins).

How to Pitch It (Stakeholders)

For Executives: "This package lets us enforce best practices in our PHP/Laravel codebase automatically—catching bugs, dead code, and security risks early without hiring specialists. It’s like having a senior developer review every PR, but at scale. The upfront cost is minimal (a single Composer command), and the long-term ROI comes from fewer production issues and faster onboarding. Think of it as ‘GitHub Copilot for code quality.’"

For Engineering Leaders: *"This wrapper bundles 10+ PHPStan rule packages into one dependency, saving us from managing fragmented configs. Key benefits:

• Standardized quality: Enforces PSR standards, type safety, and dead-code removal across teams.
• CI/CD ready: Integrates seamlessly with GitHub Actions/GitLab CI for automated static analysis.
• Low maintenance: Rules are pre-configured and updated via dependency management. We’re trading a tiny setup cost for consistent, high-quality code—ideal for scaling our Laravel apps without technical debt."*

For Developers: *"Tired of flaky static analysis or manual rule tweaking? This package gives you out-of-the-box PHPStan superpowers with zero config. It catches:

• Dead code (even in tests).
• Type inconsistencies (e.g., null returns).
• PHPUnit/Mockery anti-patterns.
• Deprecations and PSR violations. Just run composer require wyrihaximus/phpstan-rules-wrapper, and let it handle the rest. No more arguing about ‘style’—just cleaner, safer code."*