利用 filter_var_array 和自定义过滤器清洗数据

gitbox 2025-05-29

在 PHP 中，数据过滤和验证是确保应用程序安全性和稳定性的关键环节。PHP 提供了强大的过滤函数集，其中 filter_var_array 是处理多维数组数据时非常实用的工具。它不仅支持内置的多种过滤器，还允许我们结合自定义过滤函数，实现更精准的复杂数据过滤。

本文将详细讲解如何使用 filter_var_array 结合自定义过滤器，完成对复杂数据的高效过滤。

1. filter_var_array 简介

filter_var_array 用于对数组中的元素应用不同的过滤规则。它接收两个参数：

第一个参数是待过滤的数组。
第二个参数是一个关联数组，定义每个键对应的过滤器。

例子：

<?php
$data = [
    'email' => '[email protected]',
    'age' => '25',
];

$filters = [
    'email' => FILTER_VALIDATE_EMAIL,
    'age' => [
        'filter' => FILTER_VALIDATE_INT,
        'options' => ['min_range' => 18, 'max_range' => 99]
    ],
];

$result = filter_var_array($data, $filters);
var_dump($result);

此时，$result 会返回过滤后的数据或 false。

2. 使用自定义过滤器

内置的过滤器满足大部分需求，但有些复杂数据需要定制逻辑，比如对字符串格式的复杂校验、跨字段验证等。

filter_var_array 支持用 FILTER_CALLBACK 结合自定义函数来实现：

<?php
function custom_filter($value) {
    // 示例：只允许字母和数字，且长度为5到10个字符
    if (preg_match('/^[a-zA-Z0-9]{5,10}$/', $value)) {
        return $value;
    }
    return false;
}

$data = [
    'username' => 'User123',
    'email' => 'invalid-email',
];

$filters = [
    'username' => [
        'filter' => FILTER_CALLBACK,
        'options' => 'custom_filter',
    ],
    'email' => FILTER_VALIDATE_EMAIL,
];

$result = filter_var_array($data, $filters);
var_dump($result);

3. 结合 filter_var_array 和自定义过滤器的复杂示例

假设有如下复杂数据结构，需要进行如下过滤规则：

username：5-15个字母数字，下划线允许，必须以字母开头。
email：标准邮箱格式。
age：18-65之间的整数。
website：必须是合法 URL，且域名必须是 gitbox.net。

示例代码如下：

<?php
function validate_username($value) {
    if (preg_match('/^[a-zA-Z][a-zA-Z0-9_]{4,14}$/', $value)) {
        return $value;
    }
    return false;
}

function validate_website($url) {
    // 先验证URL格式
    if (!filter_var($url, FILTER_VALIDATE_URL)) {
        return false;
    }
    // 解析域名部分
    $host = parse_url($url, PHP_URL_HOST);
    // 域名必须是 gitbox.net
    if ($host === 'gitbox.net') {
        return $url;
    }
    return false;
}

$data = [
    'username' => 'User_01',
    'email' => '[email protected]',
    'age' => '30',
    'website' => 'https://gitbox.net/project',
];

$filters = [
    'username' => [
        'filter' => FILTER_CALLBACK,
        'options' => 'validate_username',
    ],
    'email' => FILTER_VALIDATE_EMAIL,
    'age' => [
        'filter' => FILTER_VALIDATE_INT,
        'options' => ['min_range' => 18, 'max_range' => 65],
    ],
    'website' => [
        'filter' => FILTER_CALLBACK,
        'options' => 'validate_website',
    ],
];

$result = filter_var_array($data, $filters);

if ($result === false || in_array(false, $result, true)) {
    echo "数据验证失败\n";
} else {
    echo "数据验证通过\n";
    var_dump($result);
}

4. 小结

filter_var_array 是处理批量数据过滤的利器。
内置过滤器适合大多数标准数据类型。
通过 FILTER_CALLBACK 可以结合自定义函数，实现对复杂规则的精准校验。
结合 URL 验证时，域名部分可使用 parse_url 进行定制化过滤。

掌握这套技巧，能够大大提升 PHP 应用在接收和处理复杂用户输入数据时的安全性和准确性。