PHP 类型判断出错？看看是不是没用对 is_array 函数

gitbox 2025-05-29

在 PHP 开发中，我们经常需要判断一个变量是不是数组。is_array() 函数是最常用的工具之一，看似简单，实则暗藏陷阱。本文将深入剖析 is_array() 的使用方式、常见误区以及如何避免踩坑。

基本用法

is_array() 是一个内置函数，语法如下：

is_array(mixed $value): bool

它接收一个变量作为参数，如果该变量是数组类型，返回 true，否则返回 false。

示例：

$data = [1, 2, 3];

if (is_array($data)) {
    echo "这是一个数组";
} else {
    echo "这不是一个数组";
}

输出：

这是一个数组

有些开发者以为只要结构类似数组就能被 is_array() 判断为数组，但 PHP 并不会自动把类似数组的字符串、对象等当成数组。

错误示例：

$data = '{"a":1,"b":2}'; // JSON 字符串

if (is_array($data)) {
    echo "这是一个数组";
}

这段代码不会输出“这是一个数组”，因为 $data 是字符串类型。

解决方案：

$data = json_decode('{"a":1,"b":2}', true); // 第二个参数设为 true，返回关联数组

if (is_array($data)) {
    echo "这是一个数组";
}

空数组也是数组：

$data = [];

if (is_array($data)) {
    echo "依然是数组";
}

很多人容易把“空数组”误判为“无效数据”，从而写出如下错误代码：

if ($data && is_array($data)) {
    // ...
}

如果 $data 是空数组，上述判断为 false，导致程序不进入逻辑块。正确做法是先判断类型，再判断是否为空：

if (is_array($data) && !empty($data)) {
    // ...
}

读取配置文件时，先判断是否为数组可以防止程序崩溃：

$config = include 'https://gitbox.net/config.php';

if (!is_array($config)) {
    throw new Exception("配置文件格式不正确！");
}

表单中带有数组字段时，建议始终进行类型判断：

$tags = $_POST['tags'] ?? [];

if (is_array($tags)) {
    foreach ($tags as $tag) {
        echo htmlspecialchars($tag);
    }
}

在现代 PHP 中，使用类型声明是一种更优雅的方式：

function processData(array $items) {
    foreach ($items as $item) {
        // 处理逻辑
    }
}

这不仅能减少手动调用 is_array() 的频率，也提高了代码的健壮性。

is_array() 虽然是一个简单的函数，但错误的使用方式却可能导致程序逻辑偏差甚至报错。我们应当：

只有真正理解了 is_array() 的工作方式，才能写出更健壮、可维护的 PHP 代码。