friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

v3.64.0 2024-08-30 23:09 UTC

Requires

• php: ^7.4 || ^8.0
• ext-filter: *
• ext-json: *
• ext-tokenizer: *
• clue/ndjson-react: ^1.0
• composer/semver: ^3.4
• composer/xdebug-handler: ^3.0.3
• fidry/cpu-core-counter: ^1.0
• react/child-process: ^0.6.5
• react/event-loop: ^1.0
• react/promise: ^2.0 || ^3.0
• react/socket: ^1.0
• react/stream: ^1.0
• sebastian/diff: ^4.0 || ^5.0 || ^6.0
• symfony/console: ^5.4 || ^6.0 || ^7.0
• symfony/event-dispatcher: ^5.4 || ^6.0 || ^7.0
• symfony/filesystem: ^5.4 || ^6.0 || ^7.0
• symfony/finder: ^5.4 || ^6.0 || ^7.0
• symfony/options-resolver: ^5.4 || ^6.0 || ^7.0
• symfony/polyfill-mbstring: ^1.28
• symfony/polyfill-php80: ^1.28
• symfony/polyfill-php81: ^1.28
• symfony/process: ^5.4 || ^6.0 || ^7.0
• symfony/stopwatch: ^5.4 || ^6.0 || ^7.0

Requires (Dev)

• facile-it/paraunit: ^1.3 || ^2.3
• infection/infection: ^0.29.5
• justinrainbow/json-schema: ^5.2
• keradus/cli-executor: ^2.1
• mikey179/vfsstream: ^1.6.11
• php-coveralls/php-coveralls: ^2.7
• php-cs-fixer/accessible-object: ^1.1
• php-cs-fixer/phpunit-constraint-isidenticalstring: ^1.5
• php-cs-fixer/phpunit-constraint-xmlmatchesxsd: ^1.5
• phpunit/phpunit: ^9.6.19 || ^10.5.21 || ^11.2
• symfony/var-dumper: ^5.4 || ^6.0 || ^7.0
• symfony/yaml: ^5.4 || ^6.0 || ^7.0

Suggests

• ext-dom: For handling output formats in XML
• ext-mbstring: For handling non-UTF8 characters.

MIT

• Fabien Potencier
• Dariusz Rumiński

• static analysis
• standards
• fixer
• Static code analysis

README

PHP Coding Standards Fixer

The PHP Coding Standards Fixer (PHP CS Fixer) tool fixes your code to follow standards; whether you want to follow PHP coding standards as defined in the PSR-1, PSR-2, etc., or other community driven ones like the Symfony one. You can also define your (team's) style through configuration.

It can modernize your code (like converting the pow function to the ** operator on PHP 5.6) and (micro) optimize it.

If you are already using a linter to identify coding standards problems in your code, you know that fixing them by hand is tedious, especially on large projects. This tool does not only detect them, but also fixes them for you.

Supported PHP Versions

• PHP 7.4
• PHP 8.0
• PHP 8.1
• PHP 8.2
• PHP 8.3

Note Each new PHP version requires a huge effort to support the new syntax. That's why the latest PHP version might not be supported yet. If you need it, please, consider supporting the project in any convenient way, for example with code contribution or reviewing existing PRs. To run PHP CS Fixer on yet unsupported versions "at your own risk" - leverage the PHP_CS_FIXER_IGNORE_ENV.

Documentation

Installation

The recommended way to install PHP CS Fixer is to use Composer in a dedicated composer.json file in your project, for example in the tools/php-cs-fixer directory:

mkdir -p tools/php-cs-fixer
composer require --working-dir=tools/php-cs-fixer friendsofphp/php-cs-fixer

Or using the main composer.json:

composer require --dev friendsofphp/php-cs-fixer

For more details and other installation methods, see installation instructions.

Run with Docker

You can use pre-built Docker images to run php-cs-fixer.

docker run -it --rm -v $(pwd):/code ghcr.io/php-cs-fixer/php-cs-fixer:${FIXER_VERSION:-3-php8.3} fix src

$FIXER_VERSION used in example above is an identifier of a release you want to use, which is based on Fixer and PHP versions combined. There are different tags for each Fixer's SemVer level and PHP version with syntax <php-cs-fixer-version>-php<php-version>. For example:

• 3.57.0-php7.4
• 3.57-php8.0
• 3-php8.3

Usage

Assuming you installed PHP CS Fixer as instructed above, you can run the following command to fix the PHP files in the src directory:

tools/php-cs-fixer/vendor/bin/php-cs-fixer fix src

See usage, list of built-in rules, list of rule sets and configuration file documentation for more details.

If you need to apply code styles that are not supported by the tool, you can create custom rules.

Editor Integration

Dedicated plugins exist for:

• NetBeans
• PhpStorm
• Sublime Text
• Vim
• VS Code

Community

The PHP CS Fixer is maintained on GitHub at https://github.com/PHP-CS-Fixer/PHP-CS-Fixer. Bug reports and ideas about new features are welcome there.

You can reach us in the GitHub Discussions regarding the project, configuration, possible improvements, ideas and questions. Please visit us there!

Contribute

The tool comes with quite a few built-in fixers, but everyone is more than welcome to contribute more of them.