本文介绍了如何在 Laravel 中验证多个数值输入字段的总和是否等于特定值。通过自定义验证规则，可以方便地在表单验证中实现此功能，确保数据的准确性和完整性。文章提供了详细的代码示例和使用方法，帮助开发者快速掌握该技巧。
在 Web 开发中，经常会遇到需要验证多个数值字段总和的情况，例如，在分配百分比时，需要确保所有百分比之和为 100%。Laravel 框架提供了强大的验证功能，但默认情况下并没有直接支持验证多个字段之和的功能。本文将介绍如何通过自定义验证规则来实现这一需求。
自定义验证规则
Laravel 允许开发者通过 Validator::extend() 方法来扩展验证器，添加自定义的验证规则。以下是如何创建一个名为 sumsTo 的自定义验证规则，用于验证多个字段之和是否等于特定值：
<?php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\Validator;
use Illuminate\Http\Request;
class AppServiceProvider extends ServiceProvider
{
/**
* Register any application services.
*
* @return void
*/
public function register()
{
//
}
/**
* Bootstrap any application services.
*
* @return void
*/
public function boot(Request $request)
{
Validator::extend('sumsTo', function ($attribute, $value, $parameters) use ($request) {
$expected = floatval(array_shift($parameters));
$otherParameters = $request->only($parameters);
return floatval(array_sum(array_merge(array_values($otherParameters), [ $value ]))) === $expected;
});
Validator::replacer('sumsTo', function ($message, $attribute, $rule, $parameters) {
return str_replace(':expected', $parameters[0], $message);
});
}
}这段代码需要在你的 AppServiceProvider 的 boot 方法中添加。sumsTo 验证规则接受三个参数：
- $attribute: 当前正在验证的字段的名称。
- $value: 当前正在验证的字段的值。
- $parameters: 传递给验证规则的参数，第一个参数是期望的总和，后面的参数是要参与求和的其他字段的名称。
Validator::replacer用于自定义验证失败的提示信息。
使用自定义验证规则
在定义了自定义验证规则之后，就可以在表单验证中使用它了。以下是一个示例，演示如何验证三个字段 number1、number2 和 number3 的总和是否等于 100：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Models\Mynumber;
use Illuminate\Support\Facades\Validator;
class MyController extends Controller
{
public function store(Request $request)
{
$validator = Validator::make($request->all(), [
'number1' => 'required|numeric|sumsTo:100,number2,number3',
'number2' => 'required|numeric|sumsTo:100,number1,number3',
'number3' => 'required|numeric|sumsTo:100,number1,number2',
]);
if ($validator->fails()) {
return response()->json(['errors' => $validator->errors()], 422);
}
$data = $request->all();
$myDb = new Mynumber();
$myDb->number1 = $data['number1'];
$myDb->number2 = $data['number2'];
$myDb->number3 = $data['number3'];
$myDb->save();
return response()->json(['message' => 'Data saved successfully'], 201);
}
}在上面的代码中，sumsTo:100,number2,number3 表示 number1 字段的值加上 number2 和 number3 字段的值，总和必须等于 100。同样，number2 和 number3 也使用相同的验证规则，以确保所有字段都参与验证。
自定义错误消息
为了提供更友好的用户体验，可以自定义验证失败时的错误消息。在 resources/lang/zh_CN/validation.php 文件（如果没有就新建）中添加以下内容：
<?php
return [
'sums_to' => '字段 :attribute 的值加上其他相关字段的值，总和必须等于 :expected。',
];或者，你也可以在AppServiceProvider中自定义错误消息：
Validator::extend('sumsTo', function ($attribute, $value, $parameters) use ($request) {
$expected = floatval(array_shift($parameters));
$otherParameters = $request->only($parameters);
return floatval(array_sum(array_merge(array_values($otherParameters), [ $value ]))) === $expected;
});
Validator::replacer('sumsTo', function ($message, $attribute, $rule, $parameters) {
return str_replace(':expected', $parameters[0], $message);
});然后在验证规则中使用：
$validator = Validator::make($request->all(), [
'number1' => 'required|numeric|sumsTo:100,number2,number3',
'number2' => 'required|numeric|sumsTo:100,number1,number3',
'number3' => 'required|numeric|sumsTo:100,number1,number2',
],
[
'sumsTo' => '字段 :attribute 的值加上其他相关字段的值，总和必须等于 :expected。',
]);注意事项
- 确保所有参与求和的字段都是数值类型，否则可能会导致验证失败。
- 可以根据实际需求修改验证规则中的参数，例如，可以修改期望的总和值，或者添加更多的字段参与求和。
- 为了提高代码的可读性，可以将自定义验证规则封装成一个独立的类。
总结
通过自定义验证规则，可以方便地在 Laravel 中验证多个数值输入字段的总和是否等于特定值。这种方法不仅可以用于验证百分比之和，还可以应用于其他需要验证多个字段之间关系的场景。掌握这种技巧可以帮助开发者编写更健壮、更可靠的应用程序。
