jdecool/phpstan-report

Enhance PHPStan analysis by providing report analysis

0.11.3 2025-05-12 20:00 UTC

Requires

• php: ^8.1
• monolog/monolog: ^2.0 || ^3.0
• phpstan/phpstan: ^1.11 || ^2.0
• psr/log: ^2.0 || ^3.0
• symfony/config: ^5.4 || ^6.0 || ^7.1
• symfony/console: ^5.4 || ^6.0 || ^7.1
• symfony/dependency-injection: ^5.4 || ^6.0 || ^7.1
• symfony/filesystem: ^5.4 || ^6.0 || ^7.1
• symfony/finder: ^5.4 || ^6.0 || ^7.1
• symfony/polyfill-intl-icu: ^1.31

Requires (Dev)

• ergebnis/composer-normalize: ^2.43
• fakerphp/faker: ^1.24
• phpunit/phpunit: ^10.5
• symfony/var-dumper: ^5.4 || ^6.0 || ^7.1

MIT

• Jérémy DECOOL

README

A simple wrapper around PHPStan to extends PHPStan's functionality by providing a customizable report generation feature. It allows you to run PHPStan analysis and generate reports on ignored errors in various formats.

Installation

You can install the package via composer:

composer require --dev jdecool/phpstan-report

Usage

The main command provided by this package is analyze. Here's the basic usage:

$ php vendor/bin/phpstan-report analyze

Options

• --report-output-format: Specify the output format for the report
• --report-without-analyze: Generate a report without running the PHPStan analysis
• --report-continue-on-error: Continue report generation even if the analysis fails
• --report-maximum-allowed-errors: Set the maximum number of allowed errors
• --report-sort-by: Sort the report results (options: identifier, occurrence)
• --report-exclude-identifier: Identifier to exclude from the report (accepts multiple values)
• --report-file-<format>: Export report in an output file for a particular format
• --report-http-target-url: The target URL to send the report to (available only if output format is http)
• --report-http-add-header: Add a header to the HTTP request (available only if output format is http)

Available formats are: text, html, http, json, gitlab and heatmap.

For a full list of options, run:

$ php vendor/bin/phpstan-report analyze --help

Examples

Run analysis and generate a text report:

$ php vendor/bin/phpstan-report analyze src tests

Generate an HTML report without running analysis:

$ php vendor/bin/phpstan-report analyze --report-without-analyze --report-output-format=html

Run analysis, continue on error, and save report to a file:

$ php vendor/bin/phpstan-report analyze --report-continue-on-error --report-file-json=report.json src

Generate a heatmap report of files with most ignored errors:

$ php vendor/bin/phpstan-report analyze --report-file-heatmap=heatmap.svg src