adrum/inertia-phpstan

PHPStan extension to validate Inertia.js page existence on disk

v1.0.0 2025-07-28 04:54 UTC

Requires

• php: ^8.1
• phpstan/phpdoc-parser: ^2.2
• phpstan/phpstan: ^2.1.11

Requires (Dev)

• phpunit/phpunit: ^10.0

MIT

• laravel
• static-analysis
• inertia
• PHPStan

README

A PHPStan extension that validates Inertia.js page existence on disk when used in Laravel controllers.

Features

• Validates Inertia::render() static calls
• Validates inertia() helper function calls
• Validates $this->inertia() method calls in controllers
• Supports multiple page directory configurations
• Supports various file extensions (.vue, .jsx, .tsx, .js, .ts)
• Handles both dot notation (Auth.Login) and slash notation (Auth/Login) for page names

Installation

composer require --dev adrum/inertia-phpstan

Configuration

Add the extension to your phpstan.neon:

includes:
    - vendor/adrum/inertia-phpstan/extension.neon

Usage

The extension will automatically validate that Inertia pages exist on disk when analyzing your controllers:

class UserController extends Controller
{
    public function dashboard()
    {
        // ✓ Will pass if resources/js/Pages/Dashboard.vue exists
        return Inertia::render('Dashboard');
    }

    public function profile()
    {
        // ✗ Will fail if resources/js/Pages/Profile/Edit.vue doesn't exist
        return Inertia::render('Profile/Edit');
    }
}

Page Directory Configuration

The extension looks for pages in these directories by default:

• resources/js/Pages
• resources/js/pages
• resources/ts/Pages
• resources/ts/pages
• resources/vue/Pages
• resources/vue/pages
• resources/react/Pages
• resources/react/pages

Supported File Extensions

• .vue
• .jsx
• .tsx
• .js
• .ts

Example

See the examples/ directory for a sample controller and PHPStan configuration.