本教程详细介绍了如何在Laravel框架中创建和使用自定义验证规则，以解决需要精确限制字符串中纯数字部分长度的特定场景。针对包含非数字字符（如逗号或点）的输入，标准验证规则无法满足需求时，自定义规则提供了一种灵活且强大的解决方案。文章将指导读者从规则生成、逻辑实现到最终应用的全过程，并提供代码示例。
解决特定数字长度验证挑战
在Web开发中，我们经常需要对用户输入进行验证。对于价格或其他数值字段，用户输入可能包含数字、小数点或逗号。Laravel框架提供了丰富的内置验证规则，如 numeric、max 和 min。然而，当我们需要验证字符串中纯数字部分的长度，而忽略其他非数字字符时，这些内置规则可能无法直接满足需求。例如，一个价格输入 12345678.00 包含 10 个数字，但总长度为 11。如果我们的业务逻辑要求纯数字部分不能超过 10 位，传统的 max:10 规则会因为 . 而失败，而 numeric 规则则不关心纯数字部分的长度。
为了应对此类特定场景，Laravel 提供了创建自定义验证规则的能力，这使得我们可以根据复杂的业务逻辑来定制验证行为。
创建自定义验证规则
在 Laravel 中，创建自定义验证规则的最佳实践是使用 Artisan 命令生成一个规则类。
1. 生成规则类
首先，打开终端并运行以下 Artisan 命令来生成一个新的验证规则类：
php artisan make:rule StrDigitLengthChecker
这个命令会在 app/Rules 目录下创建一个名为 StrDigitLengthChecker.php 的文件。
2. 实现规则逻辑
打开 app/Rules/StrDigitLengthChecker.php 文件。这个类实现了 Illuminate\Contracts\Validation\Rule 接口，要求我们实现 passes 和 message 两个方法。
- passes($attribute, $value) 方法用于定义验证逻辑。如果验证通过，该方法应返回 true；否则返回 false。
- message() 方法用于返回验证失败时显示的错误消息。
根据我们的需求，我们需要从输入值中提取纯数字，然后计算其长度，并判断是否符合预设的最大长度。假设我们要求纯数字部分的长度不能超过 10 位。
maxLength = $maxLength;
}
/**
* 确定验证规则是否通过。
*
* @param string $attribute
* @param mixed $value
* @return bool
*/
public function passes($attribute, $value)
{
// 使用 filter_var 过滤掉非数字字符，只保留整数部分
// FILTER_SANITIZE_NUMBER_INT 会移除所有非数字字符，包括点和逗号
$pureDigits = filter_var($value, FILTER_SANITIZE_NUMBER_INT);
// 计算纯数字的长度
$digitLength = strlen($pureDigits);
// 判断纯数字长度是否小于或等于允许的最大长度
return $digitLength <= $this->maxLength;
}
/**
* 获取验证错误消息。
*
* @return string
*/
public function message()
{
return '输入中的数字部分不能超过 :max_length 位。';
}
/**
* 获取验证错误消息的占位符替换值。
*
* @return array
*/
public function replacers()
{
return [
':max_length' => $this->maxLength,
];
}
}代码解释：
- 构造函数 __construct: 我们添加了一个构造函数，允许在实例化规则时传入 maxLength，使其更加灵活。默认设置为 10。
-
passes 方法:
- filter_var($value, FILTER_SANITIZE_NUMBER_INT) 是关键。它会从 $value 中移除所有非数字字符（包括小数点和逗号），只留下纯粹的数字字符串。例如，"12345678.00" 会变成 "1234567800"，"1,234.56" 会变成 "123456"。
- strlen($pureDigits) 计算提取出的纯数字字符串的长度。
- return $digitLength maxLength; 判断这个长度是否在允许的范围内。
- message 方法: 定义了验证失败时返回的错误消息。这里使用了 :max_length 占位符，可以通过 replacers 方法进行动态替换。
- replacers 方法 (可选但推荐): 这个方法允许你为错误消息中的自定义占位符提供替换值，使得错误消息更加动态和用户友好。
在控制器或表单请求中使用自定义规则
创建并实现了自定义规则后，就可以在你的控制器或表单请求中使用它了。
1. 导入规则类
在使用规则之前，确保在你的控制器或表单请求文件的顶部导入 StrDigitLengthChecker 类：
use App\Rules\StrDigitLengthChecker;
2. 应用规则
现在，你可以在验证规则数组中像使用内置规则一样使用你的自定义规则。
示例：在控制器中使用
validate([
'price' => ['required', 'string', new StrDigitLengthChecker(10)], // 应用自定义规则，限制纯数字10位
// 其他验证规则...
], [
'price.required' => '价格字段不能为空。',
'price.string' => '价格必须是字符串格式。',
// 如果需要自定义自定义规则的错误消息，可以在这里覆盖
// 'price.' . StrDigitLengthChecker::class => '自定义规则的错误消息',
]);
// 验证通过，处理业务逻辑...
// ...
return redirect()->back()->with('success', '产品价格已保存。');
}
}示例：在表单请求中使用 (推荐)
对于更复杂的验证逻辑，建议使用表单请求（Form Request）。
首先，生成一个表单请求：
php artisan make:request StoreProductRequest
然后，在 app/Http/Requests/StoreProductRequest.php 文件中定义规则：
*/
public function rules()
{
return [
'price' => ['required', 'string', new StrDigitLengthChecker(10)],
// 其他验证规则...
];
}
/**
* 获取已定义验证规则的错误消息。
*
* @return array
*/
public function messages()
{
return [
'price.required' => '产品价格是必填项。',
'price.string' => '产品价格必须是文本格式。',
// 如果需要为自定义规则提供特定的错误消息，可以在这里定义
// 'price.' . StrDigitLengthChecker::class => '价格中的数字部分长度不能超过 :max_length 位。',
];
}
}最后，在控制器中使用这个表单请求：
back()->with('success', '产品价格已保存。');
}
}注意事项与总结
- 灵活性： 自定义验证规则是 Laravel 框架中一个非常强大的特性，它允许你根据任何复杂的业务逻辑来定制验证过程，极大地提高了验证的灵活性。
- 错误消息： 确保为自定义规则提供清晰、用户友好的错误消息。通过在 message() 方法中返回字符串或使用 replacers() 方法，可以实现动态的错误提示。
- 测试： 建议为你的自定义验证规则编写单元测试，以确保其在各种输入情况下都能正常工作，覆盖正常情况、边界情况以及错误情况。
- 代码复用： 一旦创建了自定义规则，就可以在应用程序的任何地方复用它，避免代码重复。
通过本文的指导，您应该已经掌握了在 Laravel 中创建和使用自定义验证规则来精确限制字符串中纯数字长度的方法。这种方法不仅解决了特定场景下的验证难题，也展示了 Laravel 框架在可扩展性方面的优势。
