Laravel Pint如何格式化代码实现自动修复规范

Laravel Pint是Laravel官方推出的PHP代码风格自动修复工具，基于PHP-CS-Fixer开发，默认遵循Laravel项目的代码规范，能够快速扫描项目中的PHP文件并自动修复不符合规范的代码格式，减少开发者手动调整代码风格的时间，保障团队代码风格统一。

Laravel Pint的安装方法

如果是Laravel 9及以上版本的项目，Laravel Pint已经默认集成在项目中，无需额外安装。如果是更早版本的Laravel项目或者独立的PHP项目，可以通过Composer进行安装。

全局安装命令如下：

composer global require laravel/pint

如果是项目内安装，在项目根目录执行以下命令：

composer require laravel/pint --dev

基础使用方式

安装完成后，可以直接通过命令行执行格式化操作。如果是全局安装，在项目根目录执行：

pint

如果是项目内安装，执行：

./vendor/bin/pint

执行后工具会自动扫描当前目录下的所有PHP文件，按照默认规则修复代码格式，执行完成后会输出修复的文件数量。

常用执行参数

• --test：仅检查代码是否符合规范，不执行修复操作，适合在CI流程中使用
• --dirty：仅格式化已修改的文件，适合提交代码前的快速检查
• --config：指定自定义配置文件的路径

自定义格式化规则

Laravel Pint默认使用laravel预设规则，如果需要调整规则，可以在项目根目录创建pint.json配置文件，自定义格式化规则。

以下是一个自定义配置示例：

{
    "preset": "laravel",
    "rules": {
        "array_syntax": {
            "syntax": "short"
        },
        "ordered_imports": true,
        "no_unused_imports": true,
        "single_quote": true
    }
}

上述配置中，preset指定基础预设规则，rules中可以覆盖或新增具体的格式化规则，比如强制使用短数组语法、自动排序导入语句、移除未使用的导入、使用单引号包裹字符串等。

实际使用示例

假设我们有一个不符合规范的PHP文件app/Service/TestService.php，内容如下：

<?php

namespace AppService;

use AppModelUser;
use IlluminateSupportFacadesDB;

class TestService
{
    public function getUserList($page = 1, $pageSize = 10)
    {
        $query = DB::table("users")->where("status", 1);
        return $query->paginate($pageSize, ["*"], "page", $page);
    }
}

执行./vendor/bin/pint命令后，文件会被自动修复为符合规范的格式：

<?php

namespace AppService;

use AppModelUser;
use IlluminateSupportFacadesDB;

class TestService
{
    public function getUserList($page = 1, $pageSize = 10)
    {
        $query = DB::table('users')->where('status', 1);

        return $query->paginate($pageSize, ['*'], 'page', $page);
    }
}

可以看到，双引号被自动替换为单引号，方法内的语句之间增加了空行，符合Laravel的代码风格规范。

常见问题解决

如果执行格式化时提示权限不足，需要检查项目文件的读写权限，确保当前用户有修改PHP文件的权限。如果自定义规则不生效，需要检查pint.json的语法是否正确，以及文件路径是否在项目根目录。

在CI流程中集成Laravel Pint时，可以使用--test参数，如果代码不符合规范则终止流程，示例命令如下：

./vendor/bin/pint --test

Laravel_PintPHP代码规范代码自动修复代码格式化修改时间：2026-07-07 23:27:21