lmc / coding-standard
Coding standard used in Alma Career Czechia (LMC) projects
Installs: 192 873
Dependents: 24
Suggesters: 0
Security: 0
Stars: 14
Watchers: 10
Forks: 8
Open Issues: 3
Requires
- php: ^8.0
- friendsofphp/php-cs-fixer: ^3.47.1
- slevomat/coding-standard: ^8.6
- squizlabs/php_codesniffer: ^3.9
- symplify/easy-coding-standard: ^12.2.0
Requires (Dev)
- ergebnis/composer-normalize: ^2.42.0
- nikic/php-parser: <5.0
- php-parallel-lint/php-parallel-lint: ^1.4.0
- phpstan/extension-installer: ^1.3.1
- phpstan/phpstan: ^1.11.1
- phpstan/phpstan-phpunit: ^1.4.0
- phpunit/phpunit: ^9.6.19
This package is auto-updated.
Last update: 2024-10-23 11:22:32 UTC
README
PHP coding standard used in Alma Career Czechia (formerly LMC) products.
The standard is based on PSR-12 and partially PER 2.0 and adds various checks to make sure the code is readable, follows the same conventions, and does not contain common mistakes.
We use EasyCodingStandard to define and execute checks created for both PHP-CS-Fixer and PHP_CodeSniffer.
Installation
composer require --dev lmc/coding-standard
Usage
- Create
ecs.php
file in the root directory of your project and import the code-style rules:
<?php declare(strict_types=1); use Symplify\EasyCodingStandard\Config\ECSConfig; return ECSConfig::configure() ->withPaths([__DIR__ . '/src', __DIR__ . '/tests']) // optionally add 'config' or other directories with PHP files ->withRootFiles() // to also check ecs.php and all other php files in the root directory ->withSets( [ __DIR__ . '/vendor/lmc/coding-standard/ecs.php', ] );
- Run the check command
vendor/bin/ecs check
- Optionally we recommend adding this to
scripts
section of yourcomposer.json
:
"scripts": { "analyze": [ "vendor/bin/ecs check --ansi", "[... other scripts, like PHPStan etc.]" ], "fix": [ "...", "vendor/bin/ecs check --ansi --fix" ], }
Now you will be able to run the fix using composer analyze
and execute automatic fixes with composer fix
.
Add custom checks or override default settings
On top of the default code-style rules, you are free to add any rules from PHP-CS-Fixer or PHP_CodeSniffer. If needed, you can also override any default settings.
Below find examples of some more opinionated checks you may want to add depending on your needs:
<?php declare(strict_types=1); use PHP_CodeSniffer\Standards\Generic\Sniffs\Files\LineLengthSniff; use PhpCsFixer\Fixer\PhpUnit\PhpUnitTestAnnotationFixer; use Symplify\EasyCodingStandard\Config\ECSConfig; return ECSConfig::configure() /* (...) */ ->withSets( [ __DIR__ . '/vendor/lmc/coding-standard/ecs.php', ] ) ->withRules( [ // PHPUnit attributes must be used over their respective PHPDoc-based annotations. (Use with PHPUnit 10+.) PhpUnitAttributesFixer::class, // Single-line comments must have proper spacing (one space after `//`). SingleLineCommentSpacingFixer::class, // Convert multiline string to heredoc or nowdoc. MultilineStringToHeredocFixer::class, ] ) // Enforce line-length to 120 characters. ->withConfiguredRule(LineLengthSniff::class, ['absoluteLineLimit' => 120]) // Tests must have @test annotation. ->withConfiguredRule(PhpUnitTestAnnotationFixer::class, ['style' => 'annotation']) // Specify elements separation. ->withConfiguredRule(ClassAttributesSeparationFixer::class, ['elements' => ['const' => 'none', 'method' => 'one', 'property' => 'none']]) /* (...) */
See EasyCodingStandard docs for more configuration options.
Exclude (skip) checks or files
You can configure your ecs.php
file to entirely skip some files, disable specific checks, or suppress specific errors.
<?php declare(strict_types=1); use PHP_CodeSniffer\Standards\Generic\Sniffs\PHP\ForbiddenFunctionsSniff; use PHP_CodeSniffer\Standards\Squiz\Sniffs\Arrays\ArrayDeclarationSniff; use Symplify\EasyCodingStandard\Config\ECSConfig; return ECSConfig::configure() /* (...) */ ->withSkip( [ // Ignore specific check only in specific files ForbiddenFunctionsSniff::class => [__DIR__ . '/src-tests/bootstrap.php'], // Disable check entirely ArrayDeclarationSniff::class, // Skip one file __DIR__ . '/file/to/be/skipped.php', // Skip entire directory __DIR__ . '/ignored/directory/*', ] ) /* (...) */
See EasyCodingStandard docs for more configuration options.
IDE integration
For integration with PHPStorm and other IDEs, follow instructions in EasyCodingStandard README.
Changelog
For the latest changes, see CHANGELOG.md file. This library follows Semantic Versioning.
License
This library is open-source software licensed under the MIT license.