PHPStan Configuration Fixes

This document describes the PHPStan configuration issues that were resolved.

Issues Fixed

1. Missing Larastan Extension Include

Problem: The phpstan.neon configuration file was missing the Larastan extension include, which is required for PHPStan to properly analyze Laravel-specific code.

Solution: Added the following to the top of phpstan.neon:

includes:
    - vendor/larastan/larastan/extension.neon

This allows PHPStan to:

• Understand Laravel facades and helpers
• Recognize Illuminate framework classes and methods
• Properly analyze Laravel-specific code patterns
• Resolve Laravel service container bindings

2. Invalid excludePaths Syntax

Problem: The excludePaths section had invalid syntax: vendor (?)

Solution: Fixed to proper YAML syntax:

excludePaths:
    - vendor
    - tests/Pest.php
    - tests/Feature

Testing the Fix

To verify the fixes work correctly:

# Install dependencies
composer install


composer analyse

Expected Behavior

With these configuration fixes:

Before:

• PHPStan reported 233 errors
• Most errors were "unknown class" for Laravel framework classes
• Unknown methods on Laravel components
• Missing PSR interfaces

After:

• Larastan extension loads Laravel-specific type information
• Framework classes are properly recognized
• Only actual code issues (if any) should be reported
• Level 9 analysis runs successfully

Notes

• The project uses PHP 8.3+ and Laravel Zero 12.x
• PHPStan is configured at level 9 (maximum strictness)
• Larastan 3.x is specified in composer.json as a dev dependency
• All strict checking options are enabled in the configuration