README

Centralized PHP linter configurations. Rules are bundled - you configure only paths.

Installation

composer require --dev devwolk/linters

Requirements: PHP 8.4+

Supported Tools

Tool	Description
Rector	Auto-refactoring, PHP migrations
PHP-CS-Fixer	Code formatting (PSR-12)
PHPStan	Static analysis (level 8)
PHPCS	Code style (PSR-12 + Slevomat)
PHPCBF	Auto-fix PHPCS violations
PHPMD	Code quality detector
composer-unused	Unused dependencies
composer-normalize	Normalize composer.json

Configuration

An example of the full composer.json configuration:

{
  "extra": {
    "linters": {
      "rector": {
        "paths": ["app", "database", "tests", "routes"],
        "php-version": "8.4",
        "skip-dirs": ["app/Http/Requests"],
        "skip-files": ["app/Providers/AutoWireServiceProvider.php"],
        "sets": [
          "laravel12",
          "phpunit12",
          "doctrine"
        ],
        "parallel": {
          "enabled": true,
          "files-per-process": 40,
          "timeout": 360,
          "max-processes": 2
        },
        "cache-dir": ".cache/rector",
        "memory-limit": "2048M"
      },
      "php-cs-fixer": {
        "paths": ["app", "config", "database", "routes"],
        "skip-dirs": ["bootstrap", "config", "docker", "public", "resources", "routes", "storage", "vendor"],
        "skip-files": [],
        "parallel": true,
        "cache-dir": ".cache/php-cs-fixer"
      },
      "phpcs": {
        "paths": ["app", "config", "database", "routes"],
        "skip-dirs": ["vendor"],
        "skip-files": ["tests/TestCase.php", "*\\.blade\\.php$"],
        "parallel": 4,
        "cache-dir": ".cache/phpcs",
        "rule-excludes": {
          "Generic.Metrics.CyclomaticComplexity.TooHigh": ["tests/*", "src/Utils/ConfigurationLoader.php"],
          "Squiz.WhiteSpace.ScopeClosingBrace": ["tests/*", "src/Utils/ConfigurationLoader.php"]
        }
      }
    }
  }
}

Options

Option	Type	Tools	Description
`paths`	`string[]`	all*	Required. Directories to analyze
`php-version`	`string`	rector	Target PHP version: `8.3`, `8.4`, `8.5` (default: `8.4`)
`skip-dirs`	`string[]`	all*	Directories to exclude
`skip-files`	`string[]`	all*	File patterns to exclude
`parallel`	`bool\|int\|object`	rector, php-cs-fixer, phpstan, phpcs	Parallel execution
`cache-dir`	`string`	rector, php-cs-fixer, phpstan, phpcs	Cache directory
`baseline`	`string`	phpstan, phpmd	Baseline file
`sets`	`string[]`	rector	Rector sets: `laravel11`, `laravel12`, `symfony`, `doctrine`
`memory-limit`	`string`	rector	Memory limit (e.g., `2048M`, `4G`)
`rule-excludes`	`object`	phpcs	Rule-specific exclude patterns (see below)
`named-filters`	`string[]`	composer-unused	Packages to ignore

*except composer-unused and composer-normalize

PHPCS Rule Excludes

The rule-excludes option allows you to exclude specific PHPCS rules for certain files or directories:

{
  "extra": {
    "linters": {
      "phpcs": {
        "paths": ["src", "tests"],
        "rule-excludes": {
          "Generic.Metrics.CyclomaticComplexity.TooHigh": ["tests/*", "src/Utils/ConfigurationLoader.php"],
          "Squiz.WhiteSpace.ScopeClosingBrace": ["tests/*", "src/Utils/ConfigurationLoader.php"]
        }
      }
    }
  }
}

This generates XML rules like:

<rule ref="Generic.Metrics.CyclomaticComplexity.TooHigh">
    <exclude-pattern>tests/*</exclude-pattern>
    <exclude-pattern>src/Utils/ConfigurationLoader.php</exclude-pattern>
</rule>

To exclude a rule entirely, use * as the pattern:

{
  "rule-excludes": {
    "Squiz.WhiteSpace.ScopeClosingBrace": ["*"]
  }
}

Usage

./vendor/bin/linters run rector
./vendor/bin/linters run php-cs-fixer
./vendor/bin/linters run phpstan
./vendor/bin/linters run phpcs
./vendor/bin/linters run phpcbf
./vendor/bin/linters run phpmd
./vendor/bin/linters run composer-unused
./vendor/bin/linters run composer-normalize

Extra arguments can be passed after --:

./vendor/bin/linters run rector -- --dry-run
./vendor/bin/linters run php-cs-fixer -- --dry-run --diff
./vendor/bin/linters run phpstan -- --generate-baseline

Architecture

src/
├── Console/Command/     CLI commands (run, generate)
├── Service/             ToolRunner orchestration
├── CommandBuilder/      Command builders (one per tool)
├── ConfigGenerator/     Config file generators
├── DTO/                 Configuration DTOs
├── Enum/                Tool registry
└── Utils/               ConfigurationLoader, validation

Each tool has:

ConfigGenerator — generates config files (phpstan.neon, phpcs.xml, etc.)
CommandBuilder — builds CLI command with proper arguments

Rector for Laravel

Requires: composer require --dev driftingly/rector-laravel

Baseline

For legacy projects with many existing issues, generate a baseline to ignore them:

PHPStan:

./vendor/bin/linters run phpstan -- --generate-baseline

Then add to config: "baseline": "phpstan-baseline.neon"

PHPMD:

./vendor/bin/linters run phpmd -- --generate-baseline

Then add to config: "baseline": "phpmd.baseline.xml"

Examples

See examples/ for Laravel and Symfony configurations.

devwolk / linters

Maintainers

Details