本文详解如何在 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（含字母）→ 拒绝
通过以上修正，自定义规则将严格拦截非法输入，保障数据层质量。Laravel 的验证机制强大而严谨，关键在于理解 validationData()、字段名映射与正则语义的协同关系。
