如何解决Laravel巴西数据验证难题，使用laravellegends/pt-br-validator让你的表单更智能-composer-PHP中文网

如何解决Laravel巴西数据验证难题，使用laravellegends/pt-br-validator让你的表单更智能

WBOY

发布： 2025-08-20 11:14:23

原创

407人浏览过

最近在开发一个面向巴西市场的电商平台时，我遇到了一个非常具体的痛点：用户注册、地址填写以及订单信息中，包含了大量巴西特有的数据格式，例如CPF（个人税务号）、CNPJ（企业税务号）、带DDD的手机号码、邮政编码（CEP）以及车牌号等。

laravel作为我最喜欢的php框架，其强大的验证系统确实能解决大部分问题。然而，对于这些巴西本地化的特殊格式，laravel内置的

numeric

登录后复制

、

min

登录后复制

、

max

登录后复制

等通用规则就显得力不从心了。我发现自己不得不为每一个这类字段编写复杂的正则表达式，或者创建自定义的验证器类。

这不仅让我的验证代码变得冗长且难以阅读，更重要的是，这些手写的规则极易出错。一个细微的正则错误就可能导致用户数据无法正确录入，或者在数据库中存储了不符合规范的数据，从而影响后续的业务逻辑。每次遇到这种需求，我都感觉开发效率直线下降，并且对未来的维护感到担忧。我迫切需要一个既能简化开发，又能保证数据准确性的“银弹”。

Composer在线学习地址：学习地址

幸好，Composer 生态系统里总有惊喜！

就在我一筹莫展之际，我通过Composer的强大生态系统，发现了

laravellegends/pt-br-validator

登录后复制

这个宝藏库。它简直是为我的困境量身定制的！

laravellegends/pt-br-validator

登录后复制

是一个专门为Laravel框架提供巴西本地化验证规则的库。它内置了CPF、CNPJ、手机号、固定电话、CEP、车牌号等多种巴西常用格式的验证逻辑，并且支持最新版本的Laravel。这意味着我不再需要自己去研究那些复杂的数学校验规则或者正则表达式，一切都已封装妥当，开箱即用。

如何使用

laravellegends/pt-br-validator

登录后复制

解决问题

使用这个库来解决我的巴西数据验证难题，过程非常简单和直观。

第一步：安装

通过Composer，你可以轻松地将它添加到你的Laravel项目中。只需在项目根目录运行以下命令：

<pre class="brush:php;toolbar:false;">composer require laravellegends/pt-br-validator

登录后复制

对于Laravel 5.2及以上版本，得益于Laravel的包自动发现机制，你通常不需要手动注册

Service Provider

登录后复制

。但如果你使用的是更老的版本（例如5.1），你可能需要在

config/app.php

登录后复制

中手动添加：

表单大师AI

一款基于自然语言处理技术的智能在线表单创建工具，可以帮助用户快速、高效地生成各类专业表单。

查看详情

<pre class="brush:php;toolbar:false;">'providers' => [
    // ... 其他包
    LaravelLegends\PtBrValidator\ValidatorProvider::class
]

登录后复制

第二步：应用验证规则

安装完成后，你就可以像使用Laravel内置规则一样，在你的表单请求（Form Request）或者控制器中应用这些新的巴西验证规则了。

例如，如果你需要验证一个CPF字段和一个带DDD的手机号码：

<pre class="brush:php;toolbar:false;">use Illuminate\Http\Request;
use Illuminate\Support\Facades\Validator;

class UserController extends Controller
{
    public function store(Request $request)
    {
        $validator = Validator::make($request->all(), [
            'cpf' => 'required|cpf', // 验证CPF是否有效
            'celular' => 'required|celular_com_ddd', // 验证带DDD的手机号码
            'cep' => 'required|formato_cep', // 验证CEP格式
            'cnpj' => 'nullable|cnpj', // 验证CNPJ，允许为空
            'placa_veiculo' => 'nullable|formato_placa_de_veiculo', // 验证车牌格式
        ]);

        if ($validator->fails()) {
            return redirect('register')
                        ->withErrors($validator)
                        ->withInput();
        }

        // 数据有效，继续处理
        // ...
    }
}

登录后复制

或者，如果你更喜欢使用Form Request：

<pre class="brush:php;toolbar:false;">// app/Http/Requests/RegisterUserRequest.php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class RegisterUserRequest extends FormRequest
{
    public function rules()
    {
        return [
            'cpf' => ['required', 'cpf'],
            'celular' => ['required', 'celular_com_ddd'],
            // 更多巴西特有规则...
        ];
    }

    // 你也可以在这里自定义验证失败时的消息
    public function messages()
    {
        return [
            'cpf.cpf' => '请输入有效的CPF号码。',
            'celular.celular_com_ddd' => '手机号码格式不正确，请包含DDD。',
        ];
    }
}

登录后复制

第三步：自定义验证消息（可选）

laravellegends/pt-br-validator

登录后复制

为每条规则都提供了默认的错误消息，但你也可以根据项目需求进行自定义，这与Laravel原生验证消息的自定义方式完全一致。

<pre class="brush:php;toolbar:false;">Validator::make($data, $rules, [
    'cpf.cpf' => '抱歉，您输入的CPF无效。',
    'celular_com_ddd' => '手机号码格式应为 (XX)9XXXX-XXXX 或 (XX)9XXX-XXXX。'
]);

登录后复制