README

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

Installation

composer require --dev devwolk/linters

Requirements: PHP 8.4+

Supported Tools

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
        },
        "import-names": {
          "import-names": true,
          "import-doc-block-names": false,
          "import-short-classes": false,
          "remove-unused-imports": true
        },
        "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

*except composer-unused and composer-normalize

Rector Import Names

The import-names option controls how Rector handles use import statements:

{
  "extra": {
    "linters": {
      "rector": {
        "paths": ["src"],
        "import-names": {
          "import-names": true,
          "import-doc-block-names": false,
          "import-short-classes": false,
          "remove-unused-imports": true
        }
      }
    }
  }
}

All fields are optional. Omitted fields use their default values. If import-names is not specified at all, all defaults apply.

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.