不推荐全局安装 PHP CS Fixer。因易引发多项目版本冲突、CI/CD 和团队协作难统一；应优先本地安装（composer require --dev friendsofphp/php-cs-fixer），路径明确、版本锁定。

直接用 Composer 全局安装 PHP CS Fixer 是否推荐？

不推荐。全局安装看似方便，但实际项目中极易引发版本冲突——比如 A 项目要求 php-cs-fixer v3.12，B 项目依赖 v3.50，全局只有一个可执行文件，无法隔离。CI/CD 流水线或团队协作时更难保证一致性。

实操建议：

• 优先使用项目本地安装：composer require --dev friendsofphp/php-cs-fixer
• 安装后二进制文件位于 vendor/bin/php-cs-fixer，直接调用即可，路径明确、版本锁定
• 若坚持全局安装，请用 composer global require friendsofphp/php-cs-fixer，并确保 ~/.composer/vendor/bin（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows）已加入 PATH
• 全局安装后务必运行 composer global update 保持更新，否则容易因旧版 bug 导致修复行为异常（如 v2.x 对 PHP 8.1+ 的某些语法支持不全）

安装后运行 php-cs-fixer 报 “command not found” 怎么办？

这是 PATH 未生效或安装路径未被识别的典型表现，和 Composer 本身是否装好无关。

排查与解决步骤：

立即学习“PHP免费学习笔记（深入）”；

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 确认安装位置：执行 composer config --global bin-dir 查看全局 bin 目录；项目内则检查 vendor/bin/ 下是否存在 php-cs-fixer 文件（Linux/macOS 是可执行脚本，Windows 是 php-cs-fixer.bat）
• 检查 PATH：运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），确认输出中包含上述 bin 路径
• Shell 配置未重载：添加 PATH 后，需重启终端或执行 source ~/.zshrc（或 ~/.bashrc）才生效
• Windows 用户注意：CMD 不读取 PowerShell 的 $PROFILE，需在系统环境变量中手动添加，且要重启 CMD 或 VS Code 终端

如何让 PHP CS Fixer 适配 Laravel / Symfony / PSR-12 等不同规范？

核心不是靠安装方式决定，而是靠运行时指定配置。安装完只是拿到工具，规则由 --rules 或配置文件驱动。

常用做法：

• PSR-12：运行 ./vendor/bin/php-cs-fixer fix --rules=@PSR12
• Laravel：官方推荐用 --rules=@Laravel（v3.15+ 支持），或自定义规则集（如禁用 no_unused_imports 避免误删 Facade 别名）
• Symfony：对应 @Symfony 规则集，但注意它默认启用 strict_param，可能与老项目不兼容
• 永久配置：在项目根目录加 .php-cs-fixer.php，返回数组配置，例如：

  <?php
  return (new PhpCsFixer\Config())
      ->setRules([
          '@PSR12' => true,
          'array_syntax' => ['syntax' => 'short'],
      ])
      ->setFinder(PhpCsFixer\Finder::create()->in(['src', 'tests']));
  

为什么 php-cs-fixer 在 Git Hook 中自动运行时总失败？

常见原因是 Hook 脚本执行环境缺失 Composer 的 autoloader 或 PATH，尤其在 pre-commit 中调用时，当前工作目录可能不是项目根，导致 vendor/bin/php-cs-fixer 找不到或加载失败。

可靠写法（以 Husky + simple-git-hooks 为例）：

• 不要写 php-cs-fixer fix，而写完整路径：./vendor/bin/php-cs-fixer --config=.php-cs-fixer.php --dry-run --diff
• 加上 --dry-run --diff 防止 Hook 意外改写暂存区；失败时再人工介入
• 确保 Git Hook 脚本开头有 cd "$(git rev-parse --show-toplevel)"，回到仓库根目录
• 避免在 Windows 上用 Git Bash 运行 .bat 文件——改用 php vendor/friendsofphp/php-cs-fixer/php-cs-fixer 直接调用 PHP 解释器

PHP CS Fixer 的“安装”只是起点，真正影响落地效果的是规则选型、执行上下文和集成方式。最容易被忽略的是：不同 PHP 版本下某些规则的行为差异（比如 declare_strict_types 在 PHP 7.0 和 8.0+ 的处理逻辑不同），上线前务必在目标运行环境中验证 fix 结果。