PHP7.3PHP 项目接入 php-cs-fixerv3，自定义代码格式化规则配置-php教程-PHP中文网

php 7.3 项目可安全接入 php-cs-fixer v3.0.1（唯一兼容版本），需锁定安装、禁用 php 8+ 语法配置、确保 finder 正确过滤、使用标准文件名 .php-cs-fixer.php，并在 vs code 和 ci 中正确配置执行路径与参数。

php7.3php 项目接入 php-cs-fixerv3，自定义代码格式化规则配置

PHP 7.3 项目可以安全接入 php-cs-fixer v3，但需注意 v3 默认最低要求 PHP 7.4 —— 你必须显式降级到 v3.0.x 的最后一个兼容版本（v3.0.1），否则会报 PHP Parse error: syntax error, unexpected token "string" 或类似 fatal error。

确认 php-cs-fixer v3 兼容 PHP 7.3 的可用版本

v3 主线从 v3.1.0 起强制要求 PHP 7.4+（因启用 PHP 7.4 的类型化属性、箭头函数等语法）。但 v3.0.1 仍基于 PHP 7.3 可运行的语法构建，是唯一推荐用于 PHP 7.3 项目的 v3 版本。

安装命令必须锁定版本：composer require --dev friendsofphp/php-cs-fixer:^3.0.1
运行时若提示 Class "PhpCsFixer\Finder" not found，说明装了高版本，删掉 vendor/friendsofphp/php-cs-fixer 后重装
检查实际安装版本：./vendor/bin/php-cs-fixer --version 应输出 3.0.1

.php-cs-fixer.php 配置文件必须用 PHP 7.3 兼容写法

v3 配置文件默认使用 PHP 8+ 语法（如命名参数、联合类型），PHP 7.3 会直接解析失败。配置文件必须回归传统数组写法，且避免任何 PHP 8 特性。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

禁止使用命名参数：❌ ->setRules(['@PSR12' => true, 'array_syntax' => ['syntax' => 'short'])
必须用完整键值数组：✅ ->setRules(['@PSR12' => true, 'array_syntax' => ['syntax' => 'short'])（这行本身没问题，但注意不要混用 PHP 8 语法）
禁止在配置中使用短闭包（fn()）、匹配表达式（match）、空合并赋值（??=）等
Finder 实例必须显式调用 ->name() 或 ->notName() 过滤，v3.0.1 对 ->in() 的路径处理更严格，空数组或无效路径会导致静默跳过

一个安全的 PHP 7.3 兼容配置示例：

<?php // .php-cs-fixer.php
$finder = PhpCsFixer\Finder::create()
    ->in(__DIR__ . '/src')
    ->in(__DIR__ . '/tests')
    ->name('*.php')
;

return PhpCsFixer\Config::create()
    ->setRules([
        '@PSR12' => true,
        'array_syntax' => ['syntax' => 'short'],
        'ordered_imports' => true,
        'single_space_after_construct' => ['constructs' => ['named_argument']],
    ])
    ->setFinder($finder)
    ->setUsingCache(true)
;

VS Code 插件与命令行调用的常见失败点

即使配置正确，VS Code 中格式化仍可能“没反应”或报错，根源常不在规则本身，而在执行环境。

插件必须指向 vendor/bin/php-cs-fixer，而非全局安装的二进制 —— PHP 7.3 项目不应依赖全局 php-cs-fixer
VS Code 的 phpformatter.pharPath 设置对 v3 无效；应改用 phpformatter.executablePath 并填入 ./vendor/bin/php-cs-fixer（注意是相对路径或绝对路径，且有可执行权限）
命令行运行时报 Could not open input file: vendor/bin/php-cs-fixer：确认当前目录是项目根目录，且 vendor/bin 下确实存在该文件（Windows 用户注意是否为 php-cs-fixer.bat）
CI 环境中若用 --dry-run --diff 检查失败，加 --no-ansi 参数可避免 ANSI 控制字符干扰输出解析