Laravel 多数值求和验证方法

本文介绍了如何在 Laravel 中验证多个数值输入字段的总和是否等于特定值。通过自定义验证规则，可以方便地在表单验证中实现此功能，确保数据的准确性和完整性。文章提供了详细的代码示例和使用方法，帮助开发者快速掌握该技巧。

在 Web 开发中，经常会遇到需要验证多个数值字段总和的情况，例如，在分配百分比时，需要确保所有百分比之和为 100%。Laravel 框架提供了强大的验证功能，但默认情况下并没有直接支持验证多个字段之和的功能。本文将介绍如何通过自定义验证规则来实现这一需求。

自定义验证规则

Laravel 允许开发者通过 Validator::extend() 方法来扩展验证器，添加自定义的验证规则。以下是如何创建一个名为 sumsTo 的自定义验证规则，用于验证多个字段之和是否等于特定值：

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：

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 文件（如果没有就新建）中添加以下内容：

 '字段 :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 中验证多个数值输入字段的总和是否等于特定值。这种方法不仅可以用于验证百分比之和，还可以应用于其他需要验证多个字段之间关系的场景。掌握这种技巧可以帮助开发者编写更健壮、更可靠的应用程序。