dykyi-roman/awesome-claude-code/ci-tools-knowledge

# phpstan.neon — targets PHPStan 2.x (level 0-10, 10 = max)
includes:
    - vendor/phpstan/phpstan-strict-rules/rules.neon
    - vendor/phpstan/phpstan-deprecation-rules/rules.neon
    - vendor/phpstan/phpstan-phpunit/extension.neon
    - phpstan-baseline.neon
 
parameters:
    level: 8
    paths:
        - src
        - tests
    excludePaths:
        - src/Infrastructure/Legacy/*
        - tests/Fixtures/*
 
    # PHP version
    phpVersion: 80400
 
    # Strict rules (iterable/generics checks come from `level` in 2.x, not from parameters)
    checkUninitializedProperties: true
    treatPhpDocTypesAsCertain: true
    reportUnmatchedIgnoredErrors: true
 
    # Custom rules
    ignoreErrors:
        - '#Call to an undefined method [a-zA-Z0-9\\_]+::getId\(\)#'
 
    # Type aliases
    typeAliases:
        UserId: 'string'
 
    # Parallel processing
    parallel:
        maximumNumberOfProcesses: 4

# Generate baseline (for existing projects)
vendor/bin/phpstan analyse --generate-baseline
 
# Analyze with baseline
vendor/bin/phpstan analyse
 
# CI command
vendor/bin/phpstan analyse --no-progress --error-format=checkstyle > phpstan-report.xml

<!-- psalm.xml -->
<?xml version="1.0"?>
<psalm
    errorLevel="2"
    resolveFromConfigFile="true"
    findUnusedBaselineEntry="true"
    findUnusedCode="true"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="https://getpsalm.org/schema/config"
    xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
>
    <projectFiles>
        <directory name="src"/>
        <ignoreFiles>
            <directory name="vendor"/>
            <directory name="src/Infrastructure/Legacy"/>
        </ignoreFiles>
    </projectFiles>
 
    <issueHandlers>
        <MixedAssignment errorLevel="suppress"/>
        <PropertyNotSetInConstructor>
            <errorLevel type="suppress">
                <directory name="src/Infrastructure/Doctrine"/>
            </errorLevel>
        </PropertyNotSetInConstructor>
    </issueHandlers>
 
    <plugins>
        <pluginClass class="Psalm\PhpUnitPlugin\Plugin"/>
        <pluginClass class="Psalm\SymfonyPsalmPlugin\Plugin"/>
    </plugins>
</psalm>

# Full analysis
vendor/bin/psalm
 
# Generate baseline
vendor/bin/psalm --set-baseline=psalm-baseline.xml
 
# Security analysis
vendor/bin/psalm --taint-analysis
 
# CI output
vendor/bin/psalm --output-format=checkstyle > psalm-report.xml

<?php
// .php-cs-fixer.dist.php
 
declare(strict_types=1);
 
use PhpCsFixer\Config;
use PhpCsFixer\Finder;
 
$finder = Finder::create()
    ->in([
        __DIR__ . '/src',
        __DIR__ . '/tests',
    ])
    ->exclude([
        'var',
        'vendor',
    ]);
 
return (new Config())
    ->setRiskyAllowed(true)
    ->setRules([
        '@PER-CS2.0' => true,
        '@PER-CS2.0:risky' => true,
        '@PHP84Migration' => true,
        '@PHP80Migration:risky' => true,
        '@PHPUnit100Migration:risky' => true,
 
        // Strict rules
        'declare_strict_types' => true,
        'strict_param' => true,
        'strict_comparison' => true,
 
        // Modern PHP
        'array_syntax' => ['syntax' => 'short'],
        'modernize_strpos' => true,
        'no_alias_functions' => true,
        'void_return' => true,
 
        // Clean code
        'no_unused_imports' => true,
        'ordered_imports' => ['imports_order' => ['class', 'function', 'const']],
        'single_line_throw' => false,
        'trailing_comma_in_multiline' => true,
 
        // DocBlocks
        'no_superfluous_phpdoc_tags' => true,
        'phpdoc_align' => false,
        'phpdoc_separation' => true,
    ])
    ->setFinder($finder)
    ->setCacheFile('.php-cs-fixer.cache');

# Check (dry run)
vendor/bin/php-cs-fixer fix --dry-run --diff
 
# Fix
vendor/bin/php-cs-fixer fix
 
# CI check
vendor/bin/php-cs-fixer fix --dry-run --format=checkstyle > cs-report.xml

# deptrac.yaml
deptrac:
  paths:
    - ./src
 
  layers:
    - name: Domain
      collectors:
        - type: directory
          value: src/Domain/.*
 
    - name: Application
      collectors:
        - type: directory
          value: src/Application/.*
 
    - name: Infrastructure
      collectors:
        - type: directory
          value: src/Infrastructure/.*
 
    - name: Presentation
      collectors:
        - type: directory
          value: src/(Api|Web|Console)/.*
 
  ruleset:
    Domain: []  # Domain depends on nothing
 
    Application:
      - Domain
 
    Infrastructure:
      - Domain
      - Application
 
    Presentation:
      - Application
      - Domain
 
  skip_violations:
    # Temporary violations during migration
    App\Infrastructure\Legacy\*:
      - App\Domain\*

# Analyze
vendor/bin/deptrac analyse
 
# With baseline
vendor/bin/deptrac analyse --baseline=deptrac-baseline.yaml
 
# CI output
vendor/bin/deptrac analyse --formatter=junit --output=deptrac-report.xml

<?php
// rector.php
 
declare(strict_types=1);
 
use Rector\Config\RectorConfig;
use Rector\Set\ValueObject\LevelSetList;
use Rector\Set\ValueObject\SetList;
use Rector\PHPUnit\Set\PHPUnitSetList;
 
return RectorConfig::configure()
    ->withPaths([
        __DIR__ . '/src',
        __DIR__ . '/tests',
    ])
    ->withSkip([
        __DIR__ . '/src/Infrastructure/Legacy',
    ])
    ->withPhpSets(php84: true)
    ->withSets([
        SetList::CODE_QUALITY,
        SetList::DEAD_CODE,
        SetList::TYPE_DECLARATION,
        PHPUnitSetList::PHPUNIT_100,
    ])
    ->withPreparedSets(
        deadCode: true,
        codeQuality: true,
        typeDeclarations: true,
        privatization: true,
        earlyReturn: true,
    );

# Preview changes (dry run)
vendor/bin/rector process --dry-run
 
# Apply changes
vendor/bin/rector process
 
# Single file
vendor/bin/rector process src/Domain/Order.php

<!-- phpunit.xml -->
<phpunit>
    <coverage>
        <report>
            <clover outputFile="coverage.xml"/>
            <html outputDirectory="coverage-html"/>
            <text outputFile="coverage.txt"/>
        </report>
        <include>
            <directory suffix=".php">src</directory>
        </include>
        <exclude>
            <directory>src/Infrastructure/Legacy</directory>
        </exclude>
    </coverage>
</phpunit>

# GitHub Actions with PCOV
- uses: shivammathur/setup-php@v2
  with:
    php-version: '8.4'
    coverage: pcov
 
- run: vendor/bin/phpunit --coverage-clover coverage.xml
 
- uses: codecov/codecov-action@v4
  with:
    files: coverage.xml

{
    "$schema": "vendor/infection/infection/resources/schema.json",
    "source": {
        "directories": ["src"]
    },
    "logs": {
        "text": "infection.log",
        "html": "infection.html"
    },
    "mutators": {
        "@default": true
    },
    "minMsi": 80,
    "minCoveredMsi": 90
}

# Run with coverage
vendor/bin/infection --threads=4
 
# CI mode
vendor/bin/infection --min-msi=80 --min-covered-msi=90 --threads=max

lint:
  parallel:
    matrix:
      - TOOL: [phpstan, psalm, cs-fixer, deptrac]
  script:
    - case $TOOL in
        phpstan) vendor/bin/phpstan analyse ;;
        psalm) vendor/bin/psalm ;;
        cs-fixer) vendor/bin/php-cs-fixer fix --dry-run ;;
        deptrac) vendor/bin/deptrac analyse ;;
      esac