php-cs

开始

最近在看 PHP 之道，看到 代码风格指南 章节的 php-cs-fixer。

php-cs-fixer 是能够自动帮你修证代码风格，不仅仅是格式化。

如果只需要代码保存时自动格式化的，PhpStorm 可以开启这个：

之前看别人发的项目，很多都是没有格式化的，至少以上 PhpStorm 保存时自动格式化也没有开启吧。

接下来开始讲下，开启保存自动 php-cs-fixer 修正代码的方法。

环境

• PhpStorm
• PHP 8

安装 php-cs-fixer

这边使用全局安装

composer global require friendsofphp/php-cs-fixer

参见 https://cs.symfony.com/doc/installation.html

在项目根路径下，新建文件：.php-cs-fixer.php，内容如下：

<?phpuse PhpCsFixerConfig;use PhpCsFixerFinder;$rules = [
    '@PHP80Migration' => true,

    'ordered_imports' => [
        'sort_algorithm' => 'alpha',
    ],
    'class_attributes_separation' => [
        'elements' => [
            'const' => 'one',
            'method' => 'one',
            'property' => 'one',
        ],
    ],];$finder = Finder::create()
    ->in([
        __DIR__.'/app',
        __DIR__.'/config',
        __DIR__.'/database',
        __DIR__.'/resources',
        __DIR__.'/routes',
        __DIR__.'/tests',
    ])
    ->name('*.php')
    ->notName('*.blade.php')
    ->ignoreDotFiles(true)
    ->ignoreVCS(true);return (new Config())
    ->setFinder($finder)
    ->setRules($rules)
    ->setRiskyAllowed(true)
    ->setUsingCache(true);

然后在 PhpStorm 设置

• 名称：php-cs-fixer（自己喜欢的即可）
• 文件类型：PHP
• 程序：php-cs-fixer
• 参数：fix $FileDir$/$FileName$ -vvv –diff
• 要刷新的输出路径：$FileDir$/$FileName$
• 工作目录：$ProjectFileDir$
• 自动保存编辑的文件以触发观察程序：去掉默认的勾选
• 显示控制台：改为始终

讲下可能需要讲的

• 参数：
  • 这边使用了调试模式 -vvv，显示的东西比较多，后面觉得烦可以去掉
  • –diff 能够显示修改了什么，见文章下的《开启控制台显示后》
• 要刷新的输出路径：这个抄来的，目前效果还要验证
• 自动保存编辑的文件以触发观察程序：就是说，只要我们输入什么，它自动保存，不需要 command + s 进行保存就可以触发 php-cs-fixer。个人比较习惯手动保存，请根据喜好进行设置。
• 显示控制台：配合 –diff，显示修改了什么东西

效果举例

当我们进行保存时，它就会自动修正代码，在这里是修正为 PHP 7 以上的风格。

在控制台就显示以下：

开启控制台显示后

/Users/dogeow/.composer/vendor/bin/php-cs-fixer fix /Users/dogeow/PhpstormProjects/antic-api/routes/console.php -vvv --diff
Cannot load Xdebug - it was already loaded
PHP CS Fixer 3.3.2 Trinacria by Fabien Potencier and Dariusz Ruminski
Runtime: PHP 8.0.8
Loaded config default from "/Users/dogeow/PhpstormProjects/antic-api/.php-cs-fixer.php".
Using cache file ".php-cs-fixer.cache".
Paths from configuration file have been overridden by paths provided as command arguments.
F                                                                   1 / 1 (100%)
Legend: ?-unknown, I-invalid file syntax (file ignored), S-skipped (cached or empty file), .-no changes, F-fixed, E-error
   1) routes/console.php (assign_null_coalescing_to_coalesce_equal)
      ---------- begin diff ----------
--- /Users/dogeow/PhpstormProjects/antic-api/routes/console.php
+++ /Users/dogeow/PhpstormProjects/antic-api/routes/console.php
@@ -90,5 +90,5 @@
 });

 Artisan::command('test', function () {
-    $taskTag['name'] = $taskTag['name'] ?? 'url';
+    $taskTag['name'] ??= 'url';
 });

      ----------- end diff -----------


Fixed all files in 0.024 seconds, 14.000 MB memory used

进程已结束，退出代码为 0

当然也可以手动在命令行执行来批量修正整个app 目录。或者使用 git 的，提交前自动修正等。

推荐学习：《PHP视频教程》