spiral/code-style

Code style and static analysis tools rulesets collection

Fund package maintenance!
spiral

Installs: 236 870

Dependents: 25

Suggesters: 0

Security: 0

Stars: 3

Watchers: 9

Forks: 1

v2.2.0 2024-10-23 14:13 UTC

This package is auto-updated.

Last update: 2024-10-23 14:16:35 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

PHP Latest Version on Packagist License Total Downloads

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