本教程详细介绍了如何在Laravel框架中创建和应用自定义验证规则，以解决对包含逗号或小数点等非数字字符的字符串进行数字位数限制的复杂场景。文章通过一个实际案例，演示了如何利用filter_var提取纯数字，并结合strlen精确计算其位数，从而实现比内置规则更灵活、更专业的验证逻辑。
引言：处理复杂数字字符串的挑战
在Web开发中，我们经常需要验证用户输入，特别是涉及到金额、数量等数字类型的数据。然而，用户输入可能包含格式化的字符，如货币符号、千位分隔符（逗号）、小数点等。例如，一个价格输入框可能接收“1,234.56”或“12345678.00”。
传统的Laravel验证规则，如numeric、max或min，通常针对纯数字或数值大小进行验证。当我们需要对字符串中纯数字的位数进行精确限制时（例如，要求价格的整数部分不能超过10位），这些内置规则就显得力不从心了。例如，如果用户输入“12345678901”，即使它是一个有效的数字，但其纯数字位数超过了10位，就应该被视为无效。此时，Laravel的自定义验证规则便成为解决此类复杂场景的理想方案。
Laravel 自定义验证规则：解决方案核心
Laravel允许开发者创建自定义验证规则，以封装复杂的验证逻辑。这不仅提高了代码的可重用性，也使得验证逻辑更加清晰和易于维护。对于我们遇到的问题——从一个可能包含非数字字符的字符串中，提取纯数字并验证其位数——自定义规则提供了完美的抽象层。
步骤一：创建自定义验证规则类
首先，我们需要使用Artisan命令来生成一个新的验证规则类。例如，我们可以创建一个名为MaxDigits的规则，用于限制字符串中纯数字的最大位数。
php artisan make:rule MaxDigits
执行此命令后，Laravel会在 app/Rules 目录下创建一个名为 MaxDigits.php 的文件。
步骤二：实现验证逻辑
打开 app/Rules/MaxDigits.php 文件，我们将在此文件中定义验证通过的条件以及验证失败时的错误消息。为了实现灵活的位数限制，我们将允许在实例化规则时传入最大位数。
<?php
namespace App\Rules;
use Illuminate\Contracts\Validation\Rule;
class MaxDigits implements Rule
{
protected $maxLength;
/**
* 创建一个新的规则实例。
*
* @param int $maxLength 允许的最大数字位数。
* @return void
*/
public function __construct(int $maxLength)
{
$this->maxLength = $maxLength;
}
/**
* 判断验证规则是否通过。
*
* @param string $attribute 正在验证的字段名。
* @param mixed $value 正在验证的字段值。
* @return bool
*/
public function passes($attribute, $value)
{
// 使用 filter_var 提取字符串中的纯数字。
// FILTER_SANITIZE_NUMBER_INT 会移除所有非数字字符（除了 +/- 符号）。
// 这样可以确保我们只计算数字的位数，忽略逗号、点等。
$numericString = filter_var($value, FILTER_SANITIZE_NUMBER_INT);
// 检查 filter_var 的结果。如果输入为空或没有数字，它可能返回空字符串或 false。
// 在这种情况下，我们将其视为0位数字。
if (!is_string($numericString) || $numericString === '') {
$digitCount = 0;
} else {
// 计算提取出的纯数字字符串的长度。
// 直接使用 strlen 即可，因为 filter_var 已经返回了字符串。
$digitCount = strlen($numericString);
}
// 验证通过的条件是：提取出的数字位数小于或等于允许的最大位数。
return $digitCount <= $this->maxLength;
}
/**
* 获取验证错误消息。
*
* @return string
*/
public function message()
{
// 返回自定义的错误消息，其中包含动态的最大位数。
return '字段 :attribute 的纯数字位数不能超过 ' . $this->maxLength . ' 位。';
}
}
代码解析：
- __construct(int $maxLength) 方法： 构造函数允许我们在实例化规则时传入一个整数 $maxLength，这样可以使规则更加通用，适用于不同的位数限制场景。
-
passes($attribute, $value) 方法： 这是验证逻辑的核心。
- filter_var($value, FILTER_SANITIZE_NUMBER_INT)：这个PHP内置函数是关键。它会从 $value 字符串中移除所有非数字字符，只保留数字（以及可选的正负号）。例如，输入“123,456.78”会变成“12345678”。
- if (!is_string($numericString) || $numericString === ''): 这一步处理了输入值经过 filter_var 处理后可能为空或非字符串的情况（例如，如果原始输入完全没有数字）。在这种情况下，我们认为其数字位数为0。
- strlen($numericString)：计算净化后纯数字字符串的长度，即为纯数字的位数。
- return $digitCount <= $this->maxLength;：如果计算出的数字位数小于或等于构造函数中设置的 $maxLength，则验证通过，返回 true；否则返回 false。
- message() 方法： 返回当验证失败时显示的错误消息。我们在这里使用了:attribute占位符，它会被实际的字段名替换，并且动态地插入了 $this->maxLength，使错误消息更具描述性。
步骤三：在控制器中应用规则
完成自定义规则类的实现后，就可以在你的表单请求或控制器中使用它了。
假设你的表单有一个名为 price 的字段，并且你希望其纯数字位数不能超过10位。
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Rules\MaxDigits; // 导入自定义规则类
class ProductController extends Controller
{
public function store(Request $request)
{
$request->validate([
'price' => ['required', new MaxDigits(10)], // 应用自定义规则，最大位数为10
// 其他验证规则...
], [
// 自定义错误消息（可选，如果规则类中已定义则可省略）
'price.required' => '价格字段不能为空。',
// 'price.' . MaxDigits::class => '价格的纯数字位数不能超过10位。' // 也可以在这里覆盖规则中定义的错误消息
]);
// 验证通过，处理业务逻辑
// ...
return redirect()->back()->with('success', '产品添加成功！');
}
}
在上述示例中，我们通过 new MaxDigits(10) 实例化了自定义规则，并将其作为验证规则数组的一个元素传递给 validate 方法。现在，如果用户输入“12345678901”，验证将失败，并显示我们定义的错误消息。
注意事项与最佳实践
- 动态最大长度的优势： 通过在构造函数中传入 $maxLength，MaxDigits 规则变得高度可复用。你可以在不同的字段或不同的场景中，使用相同的规则类，但设置不同的位数限制。
-
错误消息的定制：
- 你可以在 message() 方法中定义规则的默认错误消息。
- 在控制器或表单请求中，你也可以通过验证器的第二个参数（错误消息数组）来覆盖或提供更具体的错误消息。例如：'price.' . MaxDigits::class => '您的价格输入过长，请确保纯数字不超过10位。'
-
filter_var 的行为：
- FILTER_SANITIZE_NUMBER_INT 会移除所有非数字字符，但会保留字符串开头的加号（+）或减号（-）。如果你的场景不需要处理负数或明确的正数符号，这通常不是问题，因为 strlen 仍会计算这些符号。如果需要严格只计算数字，可以进一步使用 preg_replace('/[^0-9]/', '', $value)。然而，对于价格这类场景，filter_var 通常足够。
- 如果输入字符串为 "-123.45"，filter_var 会返回 "-12345"，strlen 会得到 6。这通常是符合预期的，因为它计算的是有效数字（包括符号）的字符数。如果严格要求只计算数字字符，可以先 str_replace(['+', '-'], '', $numericString)。
- PHP_INT_MAX 限制： 在 passes 方法中，我们特意避免了将 filter_var 的结果强制转换为 (int)。这是因为如果提取出的数字非常大，超出了PHP整数类型的最大值 (PHP_INT_MAX)，它可能会被转换为浮点数或截断，导致 strlen((string)$int) 的结果不准确。直接对 filter_var 返回的字符串进行 strlen 操作是最安全和准确的方式。
总结
通过创建自定义Laravel验证规则，我们能够优雅地解决那些内置规则难以处理的复杂验证需求。本教程演示了如何针对包含非数字字符的字符串，精确地验证其纯数字的位数，这对于处理价格、编号等格式化输入尤其有用。掌握自定义验证规则的创建和应用，将极大地提升你在Laravel项目中处理复杂数据验证的能力。
