本文介绍了如何在 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()->only($parameters): 从请求中获取其他字段的值。 request()->only($parameters) 会返回一个包含指定字段及其对应值的数组。
- array_merge(array_values($otherParameters), [ $value ]): 将当前字段的值与从请求中获取的其他字段的值合并到一个数组中。 array_values 函数用于获取数组的所有值，并创建一个新的索引数组。
- floatval(array_sum(...)): 计算合并后的数组中所有数值的总和，并将其转换为浮点数。
- return ... === $expected: 比较计算得到的总和与期望的总和，如果相等则返回 true，否则返回 false。
使用自定义验证规则
定义了自定义验证规则后，就可以在控制器中使用它了。以下代码展示了如何在 store 方法中使用 sumsTo 规则：
本书是全面讲述PHP与MySQL的经典之作，书中不但全面介绍了两种技术的核心特性，还讲解了如何高效地结合这两种技术构建健壮的数据驱动的应用程序。本书涵盖了两种技术新版本中出现的最新特性，书中大量实际的示例和深入的分析均来自于作者在这方面多年的专业经验，可用于解决开发者在实际中所面临的各种挑战。
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 应用程序的关键组成部分。
