https://github.com/php-cs-fixer/php-cs-fixer
A tool to automatically fix PHP Coding Standards issues
https://github.com/php-cs-fixer/php-cs-fixer
code-standards code-style php static-analysis
Last synced: about 2 months ago
JSON representation
A tool to automatically fix PHP Coding Standards issues
- Host: GitHub
- URL: https://github.com/php-cs-fixer/php-cs-fixer
- Owner: PHP-CS-Fixer
- License: mit
- Created: 2012-05-16T06:42:23.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2025-09-04T14:05:28.000Z (about 2 months ago)
- Last Synced: 2025-09-04T23:15:11.183Z (about 2 months ago)
- Topics: code-standards, code-style, php, static-analysis
- Language: PHP
- Homepage: https://cs.symfony.com
- Size: 36.3 MB
- Stars: 13,314
- Watchers: 204
- Forks: 1,618
- Open Issues: 91
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# PHP Coding Standards Fixer
The PHP Coding Standards Fixer (PHP CS Fixer) fixes your code to follow the standards.
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 not only detects them, but also fixes them for you.
PHP CS Fixer has built-in rule sets, whether you want to follow PHP coding standards as defined by [PHP-FIG's PER Coding Style](https://www.php-fig.org/per/coding-style/),
a wide community like the [Symfony](https://symfony.com/doc/current/contributing/code/standards.html),
or [our opinionated one](./doc/ruleSets/PhpCsFixer.rst).
You can also define your (team's) style through the [configuration file](./doc/config.rst).
PHP CS Fixer can not only unify the style of your code, but also help to modernize your codebase towards
newer PHP (e.g. [`@PHP85Migration`](./doc/ruleSets/PHP85Migration.rst)) and newer PHPUnit (e.g. [`@PHPUnit91Migration:risky`](./doc/ruleSets/PHPUnit91MigrationRisky.rst)).
## Supported PHP Versions
* PHP 7.4 - PHP 8.4
> [!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 contributions or reviewing existing PRs. To run PHP CS Fixer on yet
> unsupported versions "at your own risk" - use `--allow-unsupported-php-version=yes` option.
## Documentation
### Installation
The recommended way to install PHP CS Fixer is to use [Composer](https://getcomposer.org/download/):
```sh
composer require --dev friendsofphp/php-cs-fixer
## or when facing conflicts in dependencies:
composer require --dev php-cs-fixer/shim
```
For more details and other installation methods (also with Docker or behind CI), see
[installation instructions](./doc/installation.rst).
### 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:
```sh
./vendor/bin/php-cs-fixer fix src
```
See [usage](./doc/usage.rst), list of [built-in rules](./doc/rules/index.rst), list of [rule sets](./doc/ruleSets/index.rst)
and [configuration file](./doc/config.rst) documentation for more details.
If you need to apply code styles that are not supported by the tool, you can
[create custom rules](./doc/custom_rules.rst).
## Editor Integration
Native support exists for:
* [PhpStorm](https://www.jetbrains.com/help/phpstorm/using-php-cs-fixer.html)
Community plugins exist for:
* [NetBeans](https://plugins.netbeans.apache.org/catalogue/?id=36)
* [Sublime Text](https://github.com/benmatselby/sublime-phpcs)
* [Vim](https://github.com/stephpy/vim-php-cs-fixer)
* [VS Code](https://github.com/junstyle/vscode-php-cs-fixer)
## Community
The PHP CS Fixer is maintained on GitHub at .
Contributions, bug reports and ideas about new features are welcome there.
You can reach us in the [GitHub Discussions](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/discussions/) regarding the
project, configuration, possible improvements, ideas and questions.
## Contribute
The tool comes with quite a few built-in fixers, but everyone is more than
welcome to [contribute](./CONTRIBUTING.md) more of them.