? Laravel 自定义验证规则的验证逻辑复用与验证错误的本地化 – 一场轻松诙谐的技术讲座

大家好！? 欢迎来到今天的 Laravel 技术讲座！今天我们要聊的是一个超级实用的话题：自定义验证规则的逻辑复用 和 验证错误的本地化。听起来是不是有点复杂？别担心，我会用通俗易懂的语言和生动的例子来讲解，保证让你听得明白、用得顺手！?

? 第一章：为什么要自定义验证规则？

在 Laravel 中，默认的验证规则（如 required、email、min 等）已经非常强大了。但有时候，我们的需求会超出这些默认规则的范围。比如：

验证一个字段是否是有效的 ISBN 编号。
验证某个日期是否在一个特定的时间范围内。
验证用户输入的密码是否符合公司的安全策略。

这些问题，Laravel 默认的规则可能无法直接解决。这时候，就需要我们自己动手，丰衣足食！?

? 第二章：如何创建自定义验证规则？

Laravel 提供了多种方式来创建自定义验证规则。以下是三种最常见的方法：

方法 1：使用闭包（Closure）

最简单的方式就是直接在验证逻辑中使用匿名函数（闭包）。例如：

use IlluminateSupportFacadesValidator;

$validator = Validator::make($request->all(), [
    'isbn' => [
        'required',
        function ($attribute, $value, $fail) {
            if (!preg_match('/^d{3}-d{10}$/', $value)) {
                $fail($attribute . ' 格式不正确！');
            }
        },
    ],
]);

这种方式适合简单的场景，但如果规则变得复杂，代码可能会变得难以维护。所以，接下来我们看看更优雅的解决方案。

方法 2：使用 Rule 对象

Laravel 提供了一个专门用于定义复杂规则的类：IlluminateValidationRule。我们可以创建一个继承自 Rule 的类来封装验证逻辑。

创建规则类

运行以下命令生成规则类：

php artisan make:rule ValidIsbn

这会在 AppRules 目录下生成一个 ValidIsbn.php 文件。编辑这个文件：

namespace AppRules;

use IlluminateContractsValidationRule;

class ValidIsbn implements Rule
{
    public function passes($attribute, $value)
    {
        return preg_match('/^d{3}-d{10}$/', $value);
    }

    public function message()
    {
        return ':attribute 格式不正确！';
    }
}

使用规则类

然后在验证时直接使用这个规则类：

use AppRulesValidIsbn;

$validator = Validator::make($request->all(), [
    'isbn' => ['required', new ValidIsbn()],
]);

这种方式将验证逻辑封装到了单独的类中，使代码更加清晰和可复用。?

方法 3：扩展 Validator 类

如果你有一个项目需要频繁使用某些自定义规则，可以考虑通过扩展 Validator 类来实现全局可用的规则。

定义扩展规则

在服务提供者（如 AppServiceProvider）中注册扩展规则：

use IlluminateSupportFacadesValidator;

public function boot()
{
    Validator::extend('valid_isbn', function ($attribute, $value, $parameters, $validator) {
        return preg_match('/^d{3}-d{10}$/', $value);
    });
}

使用扩展规则

然后就可以像使用默认规则一样使用它了：

$validator = Validator::make($request->all(), [
    'isbn' => 'required|valid_isbn',
]);

这种方式非常适合需要在多个地方复用的规则。?

? 第三章：验证错误的本地化

虽然我们已经有了强大的自定义验证规则，但如果错误信息还是英文的，用户体验可能会大打折扣。因此，我们需要对错误信息进行本地化。

1. 修改语言文件

Laravel 的语言文件位于 resources/lang 目录下。默认情况下，英语语言文件在 en/validation.php 中。我们可以为其他语言创建类似的文件。

例如，创建一个中文语言文件 resources/lang/zh/validation.php：

return [
    'custom' => [
        'isbn' => [
            'valid_isbn' => 'ISBN 格式不正确，请检查后重新输入。',
        ],
    ],
];

2. 设置语言

在 config/app.php 中设置默认语言为中文：

'locale' => 'zh',

或者在运行时动态切换语言：

app()->setLocale('zh');

3. 测试效果

现在，如果验证失败，返回的错误信息将是中文的！?

? 第四章：总结与最佳实践

通过今天的讲座，我们学习了如何在 Laravel 中创建自定义验证规则，并将其逻辑复用，同时实现了验证错误的本地化。以下是几个关键点的总结：

闭包适合简单场景，但不适合复杂的逻辑。
Rule 对象是封装复杂验证逻辑的最佳选择。
扩展 Validator适用于需要全局复用的规则。
本地化可以提升用户体验，确保错误信息以用户熟悉的语言显示。

最后，附上一个表格对比三种方法的特点：

方法	简单性	可复用性	推荐场景
闭包	★★★★☆	★☆☆☆☆	简单的一次性规则
Rule 对象	★★☆☆☆	★★★★☆	复杂且需要复用的规则
扩展 Validator	★☆☆☆☆	★★★★☆	全局复用的通用规则

希望今天的讲座对你有所帮助！如果有任何问题，欢迎随时提问！✨