本文介绍了如何在 Laravel 中自定义验证规则，以确保多个输入字段的数值之和等于特定值。通过扩展 Laravel 的验证器，可以轻松实现自定义验证逻辑，并将其应用于表单提交或其他需要数值验证的场景。
在 Web 开发中，经常需要验证用户输入的数据是否符合特定的业务规则。例如，在处理财务数据时，可能需要确保多个输入字段的数值之和等于预期的总数。 Laravel 提供了强大的验证机制，但对于这种自定义的验证需求，我们需要扩展其功能。
自定义验证规则
Laravel 允许我们通过 Validator::extend 方法自定义验证规则。该方法接受两个参数：规则的名称和一个闭包函数，该闭包函数定义了验证逻辑。
以下代码展示了如何创建一个名为 sumsTo 的自定义验证规则，该规则用于验证多个字段的数值之和是否等于指定的值：
use Illuminate\Support\Facades\Validator;
use Illuminate\Http\Request;
Validator::extend('sumsTo', function ($attribute, $value, $parameters) {
$expected = floatval(array_shift($parameters));
$otherParameters = request()->only($parameters);
return floatval(array_sum(array_merge(array_values($otherParameters), [ $value ]))) === $expected;
});代码解释:
- Validator::extend('sumsTo', ...): 这行代码注册了一个名为 sumsTo 的自定义验证规则。
- $attribute: 当前正在验证的字段的名称。
- $value: 当前正在验证的字段的值。
- $parameters: 传递给验证规则的参数数组。 在我们的例子中，第一个参数是期望的总和，其余参数是要参与求和的其他字段的名称。
- $expected = floatval(array_shift($parameters)): 从参数数组中取出期望的总和，并将其转换为浮点数。 array_shift 函数会移除数组的第一个元素并返回它。
- $otherParameters = request()-youjiankuohaophpcnonly($parameters): 从请求中获取其他字段的值。 request()->only($parameters) 会返回一个包含指定字段及其对应值的数组。
- array_merge(array_values($otherParameters), [ $value ]): 将当前字段的值与从请求中获取的其他字段的值合并到一个数组中。 array_values 函数用于获取数组的所有值，并创建一个新的索引数组。
- floatval(array_sum(...)): 计算合并后的数组中所有数值的总和，并将其转换为浮点数。
- return ... === $expected: 比较计算得到的总和与期望的总和，如果相等则返回 true，否则返回 false。
使用自定义验证规则
定义了自定义验证规则后，就可以在控制器中使用它了。以下代码展示了如何在 store 方法中使用 sumsTo 规则：
public function store(Request $request) {
$data = $request->validate([
'number1' => 'required|numeric|sumsTo:100,number2,number3',
'number2' => 'required|numeric|sumsTo:100,number1,number3',
'number3' => 'required|numeric|sumsTo:100,number1,number2',
]);
$myDb = new Mynumber();
$myDb->number1 = $data['number1'];
$myDb->number2 = $data['number2'];
$myDb->number3 = $data['number3'];
$myDb->save();
}代码解释:
- 'number1' => 'required|numeric|sumsTo:100,number2,number3': 这行代码指定了 number1 字段的验证规则。 它要求该字段必须存在 (required)，必须是数值 (numeric)，并且与其他字段 (number2 和 number3) 的数值之和必须等于 100 (sumsTo:100,number2,number3)。
- 类似地，number2 和 number3 字段也使用了相同的验证规则，以确保所有三个字段的数值之和都等于 100。
自定义错误消息
默认情况下，Laravel 会为自定义验证规则生成通用的错误消息。为了提供更友好的用户体验，我们可以自定义错误消息。
可以通过在 resources/lang/zh_CN/validation.php (或其他语言文件) 中添加以下内容来定义自定义错误消息：
'sums_to' => 'The sum of :attribute and other specified fields must be :expected.',
然后在验证规则中使用 :attribute 和 :expected 占位符，它们会被替换为实际的字段名称和期望的总和。
注意事项
- 确保传递给 sumsTo 规则的参数数量正确。第一个参数必须是期望的总和，其余参数必须是要参与求和的其他字段的名称。
- 自定义验证规则应该在服务提供者中注册，例如 AppServiceProvider。
- 如果需要更复杂的验证逻辑，可以考虑创建一个自定义验证器类。
总结
通过自定义验证规则，我们可以轻松地扩展 Laravel 的验证机制，以满足各种自定义的验证需求。 sumsTo 规则只是一个简单的示例，你可以根据自己的实际需求创建更复杂的验证规则。 记住，良好的数据验证是构建安全可靠的 Web 应用程序的关键组成部分。
