Composer如何集成PHP代码美化工具_安装php-cs-fixer【质量管理】-composer-PHP中文网

php-cs-fixer 不推荐全局安装，应本地安装为开发依赖；通过项目根目录的 .php-cs-fixer.php 配置文件复用官方预设（如 laravel、symfony、psr12）自动适配编码规范。

composer如何集成php代码美化工具_安装php-cs-fixer【质量管理】

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 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 流水线必须用后者，避免偷偷改源码；本地开发可两者都配。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

在 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"
}