spiral / code-style

v2.4.0 2026-10-10 00:03 UTC

Requires

• php: >=8.2
• php-cs-fixer/shim: ^3.64

Requires (Dev)

• spiral/dumper: ^3.3
• testo/testo: ^0.10.55
• vimeo/psalm: ^6 || ^7

MIT

• Aleksandr Novikov
• Aleksei Gagarin

Published on Packagist.org on 2026-10-10 00:03 UTC

README

This repository contains ruleset for PHP CS Fixer based on PER-2.

Installation and configuration

Install the package via composer:

composer require --dev spiral/code-style

Create a configuration file .php-cs-fixer.dist.php in the root of your project:

<?php declare(strict_types=1);

require_once 'vendor/autoload.php';

return \Spiral\CodeStyle\Builder::create()
    ->include(__DIR__ . '/src')
    ->include(__FILE__)
    ->build();

Feel free to adjust the paths to include/exclude files and directories.

Usage

To more convenient usage, you can add the following commands to the scripts section of the composer.json file:

{
    "scripts": {
        "cs:diff": "php-cs-fixer fix --dry-run -v --diff",
        "cs:fix": "php-cs-fixer fix -v"
    }
}

Now you can run the following commands:

composer cs:diff
composer cs:fix

CI integration

If you want to integrate code style check into CI, add the following step to your GitHub Actions configuration file:

on:
  push:
    branches:
      - '*'

name: Check Code Style

jobs:
  cs-check:
    uses: spiral/gh-actions/.github/workflows/cs.yml@master

If you want GitHub Actions to automatically fix the found errors, add the following step:

on:
  push:
    branches:
      - '*'

name: Fix Code Style

jobs:
  cs-fix:
    permissions:
      contents: write
    uses: spiral/gh-actions/.github/workflows/cs-fix.yml@master