README

Overview

PHPStan Report is a Laravel package that provides an elegant web interface for viewing, analyzing, and managing PHPStan static analysis results. Transform your code quality insights into an interactive, user-friendly dashboard.

Features ✨

🎯 Dynamic Level Control - Adjust PHPStan analysis levels (1-10) through an intuitive web interface
⚡ Real-time Analysis - Execute PHPStan analysis directly from your browser
📊 Beautiful Reports - View detailed analysis results with clear, organized presentation
🌓 Theme Support - Switch between dark and light themes with session persistence
📋 Copy Functionality - One-click copy for error messages and solutions
📱 Responsive Design - Optimized experience across mobile and desktop devices
🚀 Composer Integration - Seamless integration with Composer scripts
💾 Auto-save Settings - Automatically remembers your preferred configuration

Requirements

PHP: 8.3+
Laravel: 11.0+ or 12.0+
Composer: Latest stable version

Installation

Install the package via Composer:

composer require gboquizo/phpstan-report

Quick Setup

Run the installation command to automatically configure PHPStan Report:

php artisan install:phpstan-report

This command performs the following actions:

Creates phpstan.neon - Generates a configuration file with level 3 analysis (if not exists)
Publishes assets - Copies package assets to public/vendor/phpstan-report
Updates composer.json - Adds PHPStan script for easy execution
Runs initial analysis - Executes PHPStan analysis and asset discovery

Generated Configuration

The installation creates a basic phpstan.neon configuration:

parameters:
    level: 3
    paths:
        - app

You can customize this configuration according to your project needs.

Screenshots 💄

Usage

Accessing the Web Interface

Navigate to the PHPStan Report dashboard using any of these methods:

Direct URL: https://your-application.com/phpstan-report
Artisan route list: Use php artisan route:list --name=phpstan to verify the route

Dashboard Features

📊 Analysis Dashboard

Real-time statistics showing total errors, warnings, and analysis status
File-based organization with expandable error lists
Severity indicators with color-coded error types

⚙️ Level Management

Interactive slider to adjust PHPStan analysis levels (1-10)
Instant feedback showing level descriptions and expected behavior
Automatic re-analysis when level changes are applied

🚀 Analysis Execution

One-click analysis button for immediate code scanning
Progress indicators showing analysis status
Success/error notifications with detailed feedback

🎨 User Experience

Theme toggle between dark and light modes
Persistent preferences saved across browser sessions
Mobile-optimized interface for analysis on-the-go
Copy-to-clipboard functionality for quick error sharing

Command Line Usage

You can also run PHPStan analysis through Composer:

# Run analysis (added by installation command)
composer phpstan-report

Getting Help

If you encounter issues:

Check the logs - Laravel logs may contain helpful error messages
Verify requirements - Ensure PHP and Laravel versions meet minimum requirements
Clear cache - Run php artisan config:clear and php artisan cache:clear
Open an issue - Report bugs or request features