Laravel 自定义手机号验证规则的正确实现方法-php教程-PHP中文网

Laravel 自定义手机号验证规则的正确实现方法

本文详解如何在 laravel 中创建符合特定格式（如 010-1234-5678）的自定义手机号验证规则，修正正则表达式错误、字段映射问题及请求预处理逻辑，确保验证真正生效。

本文详解如何在 laravel 中创建符合特定格式（如 010-1234-5678）的自定义手机号验证规则，修正正则表达式错误、字段映射问题及请求预处理逻辑，确保验证真正生效。

在 Laravel 中实现符合业务规范的手机号验证（如中国常用固话格式 010-1234-5678），需兼顾格式匹配与前缀约束（仅允许 010, 020, ..., 090），但直接套用正则或误用请求生命周期易导致验证“静默失效”——即规则未触发、非法数据仍进入数据库。以下是完整、可落地的解决方案。

✅ 正确的正则表达式：精准匹配 0XX-XXXX-XXXX

原始代码中存在两处关键错误：

正则写成 \[0-9]{4}-... —— 方括号被错误转义，\[ 匹配字面量 [，而非数字字符类；
格式误设为 4-4-3，而需求明确为 3-4-4（如 010-1234-5678）；
前三位限定逻辑缺失：010/020/.../090 可简洁表达为 0[1-9]0（0 + 1~9 + 0），避免冗长枚举。

✅ 正确正则应为：

$pattern = '/^0[1-9]0-\d{4}-\d{4}$/';

其中：

^ 和 $ 确保完整匹配（防 abc010-1234-5678xyz 误通过）；
\d 等价于 [0-9]，更简洁；
0[1-9]0 精确覆盖 010, 020, ..., 090，排除 000 或 100。

✅ 修复请求预处理：确保字段名与验证目标一致

问题核心在于 validationData() 中合并的字段名为 'tel_number'，但 rules() 中却验证 'mob_number'：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

// ❌ 错误：合并到 'tel_number'，但规则检查 'mob_number'
$this->merge(['tel_number' => ...]);
'required', new MobileNumber() // → $attribute = 'mob_number'，$value = null

MobileNumber::passes() 接收的是 mob_number 字段值，而 tel_number 从未被规则引用，故验证永不执行。

✅ 正确做法：统一字段名。假设前端提交三段输入 tel_number_1, tel_number_2, tel_number_3，应在 validationData() 中合并至待验证字段名：

// app/Http/Requests/UserRequest.php
public function validationData()
{
    $merged = $this->tel_number_1 . '-' . $this->tel_number_2 . '-' . $this->tel_number_3;
    return array_merge($this->all(), ['mob_number' => $merged]);
}

同时，rules() 中保持验证 mob_number：

public function rules()
{
    return [
        // 其他规则...
        'mob_number' => ['required', new MobileNumber()],
    ];
}

✅ 完整自定义规则实现（App/Rules/MobileNumber.php）

<?php namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;

class MobileNumber implements Rule
{
    public function passes($attribute, $value): bool
    {
        // 严格匹配 0XX-XXXX-XXXX 格式，且首位为 0，第二位 1-9，第三位为 0
        return (bool) preg_match('/^0[1-9]0-\d{4}-\d{4}$/', $value);
    }

    public function message(): string
    {
        return 'The :attribute must be in format 0XX-XXXX-XXXX (e.g., 010-1234-5678) and start with 010, 020, ..., or 090.';
    }
}

⚠️ 关键注意事项

不要依赖 validationData() 修改原始请求：它仅影响验证时的 $this->all() 数据，不修改原始输入。若后续逻辑需使用拼接后的号码，建议在 store()/update() 方法中处理。
前端一致性：确保表单字段名（tel_number_1, tel_number_2, tel_number_3）与 UserRequest 中读取的属性名完全一致（包括大小写和下划线）。
测试边界用例：
- ✅ 010-1234-5678 → 通过
- ❌ 000-1234-5678（前缀非法）→ 拒绝
- ❌ 010-123-45678（位数错误）→ 拒绝
- ❌ abc-1234-5678（含字母）→ 拒绝