使用 filter_input_array 结合 FILTER_VALIDATE_INT 进行整数输入验证的详细步骤是什么？

gitbox 2025-06-13

在PHP开发过程中，获取和验证用户输入是一项非常重要的任务。特别是当我们需要验证整数输入时，使用PHP内置的过滤函数不仅简洁且高效。本文将详细介绍如何使用filter_input_array函数配合FILTER_VALIDATE_INT过滤器，完成整数输入的验证。

一、什么是 filter_input_array 和 FILTER_VALIDATE_INT？

filter_input_array：这是PHP中用于一次性过滤多个输入变量的函数。它允许我们定义一个过滤规则数组，针对不同输入项应用不同的过滤规则。
FILTER_VALIDATE_INT：这是PHP中用于验证输入是否为有效整数的过滤器。如果输入值是有效整数，则返回该整数，否则返回false。

结合这两个功能，可以批量验证多个整型输入，代码简洁且易于维护。

二、使用 filter_input_array 结合 FILTER_VALIDATE_INT 的详细步骤

1. 定义需要验证的输入变量名及其过滤规则

首先，需要准备一个关联数组，数组的键是输入变量名（例如GET或POST参数名），值是FILTER_VALIDATE_INT，代表对该输入项应用整数验证。

<?php
$filters = [
    'age' => FILTER_VALIDATE_INT,
    'id'  => FILTER_VALIDATE_INT,
    'score' => [
        'filter' => FILTER_VALIDATE_INT,
        'options' => [
            'min_range' => 0,    // 设置最小值限制（可选）
            'max_range' => 100,  // 设置最大值限制（可选）
        ]
    ]
];
?>

2. 调用 filter_input_array 函数获取过滤结果

使用filter_input_array函数，传入输入类型（如INPUT_GET、INPUT_POST），以及上面定义的过滤规则数组。

<?php
$input = filter_input_array(INPUT_GET, $filters);
?>

这里$input将是一个数组，键对应输入变量名，值为验证后的整数值，若验证失败，则对应值为false。

3. 判断输入是否合法

通过遍历或直接判断$input中各个元素，确定是否所有的输入都通过了整数验证。

<?php
if ($input !== null && $input !== false) {
    foreach ($input as $key => $value) {
        if ($value === false) {
            echo "参数 {$key} 非法，必须是整数。<br>";
        } else {
            echo "参数 {$key} 验证通过，值为：{$value}<br>";
        }
    }
} else {
    echo "没有获取到输入或输入格式错误。";
}
?>

4. 结合实际使用的完整示例

假设页面接收GET请求参数age、id和score，其中score要求是0到100之间的整数，完整代码如下：

<?php
// 过滤规则数组
$filters = [
    'age' => FILTER_VALIDATE_INT,
    'id'  => FILTER_VALIDATE_INT,
    'score' => [
        'filter' => FILTER_VALIDATE_INT,
        'options' => ['min_range' => 0, 'max_range' => 100]
    ]
];

// 获取并验证输入
$input = filter_input_array(INPUT_GET, $filters);

if ($input !== null && $input !== false) {
    foreach ($input as $key => $value) {
        if ($value === false) {
            echo "参数 {$key} 非法，必须是指定范围内的整数。<br>";
        } else {
            echo "参数 {$key} 验证通过，值为：{$value}<br>";
        }
    }
} else {
    echo "未接收到有效输入。";
}
?>

三、总结

使用filter_input_array结合FILTER_VALIDATE_INT可以非常方便地批量验证整数输入，代码简洁且易读。配合options参数还能实现范围限制，满足多种场景需求。建议在获取用户输入时尽量使用PHP自带的过滤器，以提升代码的安全性和稳定性。

filter_input_array