php-cs-fixer 不推荐全局安装，应本地安装为开发依赖；通过项目根目录的 .php-cs-fixer.php 配置文件复用官方预设（如 laravel、symfony、psr12）自动适配编码规范。
php-cs-fixer 能不能直接用 Composer 全局安装
能，但不推荐。全局安装后，php-cs-fixer 二进制文件会落在系统 PATH 里，看似方便，实际容易引发版本冲突——不同项目依赖的规则集（如 PSR-12、Symfony）可能要求不同版本的 php-cs-fixer，全局一个可执行文件无法隔离。
更稳妥的做法是：每个项目本地安装为开发依赖，再通过 Composer 脚本或直接调用 vendor/bin/php-cs-fixer 执行。
- 运行
composer require --dev friendsofphp/php-cs-fixer - 安装后，可执行文件位于
vendor/bin/php-cs-fixer（Linux/macOS）或vendor\bin\php-cs-fixer.bat（Windows） - 确认可用：
./vendor/bin/php-cs-fixer --version
怎么让 php-cs-fixer 自动适配项目编码规范
靠配置文件，不是靠命令行参数硬写。项目根目录下放 .php-cs-fixer.php 或 .php-cs-fixer.dist.php，内容返回一个 PhpCsFixer\Config 实例。
别手写全部规则——优先复用官方预设，比如 Laravel 项目用 laravel，Symfony 项目用 symfony，通用现代 PHP 用 psr12：
立即学习“PHP免费学习笔记（深入）”；
<?php
return (new PhpCsFixer\Config())
->setRules([
'@psr12' => true,
'array_syntax' => ['syntax' => 'short'],
'no_unused_imports' => true,
])
->setFinder(PhpCsFixer\Finder::create()
->in(['src', 'tests'])
->name('*.php')
->notName('*.blade.php')
)
;
-
setFinder()必须显式指定扫描路径，否则默认只处理当前目录下的.php文件 - 如果用了
@psr12，就别再单独开indentation_type这类底层规则，否则可能冲突 -
.php-cs-fixer.dist.php更适合提交到 Git，.php-cs-fixer.php可用于本地覆盖（.gitignore 掉）
如何在 Composer 脚本中一键格式化 + 校验失败退出
把格式化和校验拆成两个命令：一个是「改代码」，一个是「只检查不改」。CI 流水线必须用后者，避免偷偷改源码；本地开发可两者都配。
在 composer.json 的 scripts 段加上：
"scripts": {
"cs-fix": "php-cs-fixer fix --config=.php-cs-fixer.php",
"cs-check": "php-cs-fixer fix --config=.php-cs-fixer.php --dry-run --diff"
}
-
--dry-run表示不保存修改，配合--diff会输出差异并以非零状态码退出（有违规时） - 执行
composer run cs-check后，返回值为 0 代表全合规；非 0 则 CI 应中断 - 注意：不要在
post-autoloader-dump这类钩子里自动跑cs-fix，会干扰依赖安装流程
PHP 8.2+ 项目用 php-cs-fixer 会报错吗
看版本。v3.14.0 之前不识别 readonly 类属性、enum 构造函数等 PHP 8.2+ 语法，会直接解析失败并报 ParseError 或跳过文件。
解决方案很直接：
- 升级到
friendsofphp/php-cs-fixer:^3.14或更高（截至 2024 年主流是 ^3.17） - 检查
composer show friendsofphp/php-cs-fixer输出的版本号是否 ≥ 3.14 - 若仍报错，加
--using-cache=no临时绕过缓存解析问题（极少数情况）
另外，php-cs-fixer 本身不校验类型语法正确性，它只管格式。所以即使 PHP 版本够新，也要确保 php -l 能过，否则它连文件都读不进来。
