在PHP开发中,对数组是否为空的准确判断是保障程序健壮性的关键环节。当数据源不可靠(如用户输入、外部接口响应、数据库查询结果)时,若未正确识别“空数组”情形,极易引发逻辑错误、notice/warning级别错误,甚至导致系统崩溃或安全漏洞。
所谓“空数组”,在PHP语义中有三类典型表现:
[]或array()定义的数组,元素个数为0,例如$arr = [];isset($arr)为falsenull、空字符串或0,如[null, '', 0]值得注意的是,PHP中“空”的定义具有多重性:空字符串""、数字00、字符串0"0"、false、null、空数组[]在弱类型比较下均被视为“空”,这极大增加了判断的复杂性。
在Web开发中,数组常作为数据传输载体(如$_GET、$_POST、$_REQUEST、API返回的JSON解码结果)。例如,当用户提交表单未选择任何选项时,$_POST['hobbies']可能为空数组;当数据库查询无结果时,fetch_all()返回的也是空数组——此时若直接遍历将导致逻辑异常。
因此,掌握多种判断策略、理解其底层机制与性能差异、结合业务场景精准选用,是高级PHP工程师的必备素养。
PHP提供多种判断数组是否为空的函数与表达式,各具特点。以下逐项剖析其原理、返回规则、性能表现及典型用例:
empty()用于检测变量是否为空。对于数组,其返回true当且仅当数组长度为0,即无任何元素(包括键值均为null的元素)。例如:
<?php
$a = [];
$b = [null];
$c = [0];
$d = ['' => ''];
echo empty($a) ? '空' : '非空'; // 输出:空
echo empty($b) ? '空' : '非空'; // 输出:非空
echo empty($c) ? '空' : '非空'; // 输出:非空
echo empty($d) ? '空' : '非空'; // 输出:非空
?>
⚠️ 注意:当数组元素为数字0(如[0])或字符串"0"(如['0'])时,empty()返回false,但!empty([0])为true,这与部分开发者直觉不符,易引发逻辑漏洞。
通过count()获取数组元素个数,再判断是否为0。此方法语义明确,适用于所有PHP版本:
<?php
$arr = [];
if (count($arr) === 0) {
echo '数组为空';
}
?>
性能方面,count()在PHP内部已对数组进行优化,时间复杂度为O(1),无须遍历。但若传入非数组类型(如null、标量),会触发warning,建议配合is_array()使用:
<?php
if (is_array($data) && count($data) === 0) {
// 确保是数组且为空
}
?>
为避免“变量未定义”或“非数组类型”引发错误,推荐组合使用:
<?php
function is_empty_array($var) {
return is_array($var) && empty($var);
}
?>
该函数可安全处理任意输入,是框架级工具函数的常见实现方式。
当需要判断数组是否“全为空值”(如元素均为null、空字符串、0),可先用array_filter()过滤掉“假值”,再判断结果:
<?php
$arr1 = [null, '', 0, false];
$arr2 = [null, 'hello', 0];
echo empty(array_filter($arr1)) ? '逻辑空' : '非逻辑空'; // 逻辑空
echo empty(array_filter($arr2)) ? '逻辑空' : '非逻辑空'; // 非逻辑空
?>
注意:array_filter()默认过滤掉所有“假值”(falsy values),包括0、"0"、false、null、空字符串。若需保留0或"0",可传入自定义回调函数。
PHP 5.4+支持数组字面量比较,用严格等于号可精确判断是否为“空数组”:
<?php
$arr = [];
var_dump($arr === []); // true
var_dump([] === []); // true
var_dump([null] === []); // false
?>
此方法性能最优(无函数调用开销),但仅适用于明确知道变量为数组的场景,若变量可能为null或标量,会返回false而非true,需谨慎使用。
弱比较$arr == []在大多数情况下与count($arr) === 0等效,但存在细微差异:
['a' => 1, 'a' => 2]),PHP会保留后者,实际count为1,但== []返回false| 方法 | 语法示例 | 返回true条件 | 是否需is_array防护 | 性能(相对) | 典型适用场景 |
|---|---|---|---|---|---|
empty() |
empty($arr) |
数组长度为0 | 是(防未定义变量) | 高 | 通用判断,快速检测 |
count() === 0 |
count($arr) === 0 |
数组长度为0 | 是(防非数组) | 高 | 需明确计数场景 |
is_array() + empty() |
is_array($v) && empty($v) |
变量是数组且长度为0 | 否(已双重防护) | 中 | 防御性编程,函数参数校验 |
array_filter() + empty() |
empty(array_filter($arr)) |
过滤后无元素(全假值) | 是 | 低(需遍历) | 判断“逻辑空”(如表单全空提交) |
=== [] |
$arr === [] |
严格等于空数组字面量 | 否(但非数组时恒false) | 极高 | 已知类型为数组的精确比较 |
💡 性能实测参考(10万次循环,PHP 8.2):
empty():约0.008秒count() === 0:约0.009秒is_array() && empty():约0.012秒array_filter() + empty():约0.045秒(含过滤开销)=== []:约0.006秒结论:常规场景推荐empty();需严格类型控制用=== [];业务需识别“全空值”时用array_filter()组合。
在项目中统一定义空数组判断逻辑,避免散落各处的重复代码:
<?php
function is_business_empty_array($var) {
if (!is_array($var)) return false;
if (empty($var)) return true;
// 过滤掉所有假值后是否为空
return empty(array_filter($var, function($v) {
return $v !== '' && $v !== 0 && $v !== '0' && $v !== false && $v !== null;
}));
}
?>
此函数可处理用户提交的“看似提交实则全空”的表单(如复选框未选),避免后续处理中出现空数组遍历异常。
当API返回JSON{},用json_decode($json)默认得到stdClass对象而非数组。此时需转为数组再判断:
<?php
$json = '{}';
$data = json_decode($json, true); // 第二参数true转为关联数组
if (is_array($data) && empty($data)) {
echo '空响应数据';
}
?>
遍历前务必先判断空,避免“非法数组”导致错误:
<?php
if (is_array($items) && count($items) > 0) {
foreach ($items as $item) {
// 安全处理
}
} else {
// 处理无数据情况
}
?>
当需判断“数组是否为空或仅含键为0的单元素”时,可结合array_key_first():
<?php
function is_truly_empty($arr) {
return !is_array($arr) || count($arr) === 0 ||
(count($arr) === 1 && array_key_first($arr) === 0 && $arr[0] === null);
}
?>
此函数适用于特殊业务场景,如处理数据库查询返回的单行结果数组。
以下代码可能引发意外:
<?php
$arr = ['' => 'value']; // 键为空字符串
echo count($arr); // 输出1,非空数组!
echo empty($arr) ? '空' : '非空'; // 非空
?>
当JSON解码含空键名的对象(如{"":"value"})时,此情况更隐蔽。务必用var_dump($arr)或print_r($arr)调试!
在验证用户输入时,$_GET['id'] = '0'会被empty()视为false,但业务上可能认为“未传ID”:
<?php
$id = $_GET['id'] ?? '';
// 错误做法:empty($id) → '0'不为空
// 正确做法:$id === '' || $id === '0' ? '无有效ID' : $id;
?>
建议对ID类字段使用ctype_digit()或filter_var($id, FILTER_VALIDATE_INT)校验。
PHP 7.1+允许在函数参数中用empty(),但PHP 7.0及以下版本会报错:
<?php
// 旧版本PHP会报:Fatal error: Can't use function return value in write context
function test($arr) {
if (empty($arr)) { ... } // 安全
}
?>
兼容性建议:先将参数赋值给变量再判断:
<?php
function test($arr) {
$data = $arr ?? [];
if (empty($data)) { ... }
}
?>
以下数组:$arr = ['a' => null];用empty($arr)返回false(非空),但isset($arr['a'])返回false:
<?php
$arr = ['a' => null];
echo count($arr); // 1
echo empty($arr) ? '空' : '非空'; // 非空
echo isset($arr['a']) ? '存在' : '不存在'; // 不存在
?>
解决方案:用array_key_exists('a', $arr)判断键是否存在(不受值影响)。
HTML表单中,若用户未选择任何复选框,$_POST['tags']不会存在该键;若存在但为空数组(如通过JS模拟提交),需统一处理:
<?php
$tags = $_POST['tags'] ?? [];
// 确保是数组且非空
if (is_array($tags) && count($tags) > 0) {
// 处理标签列表
foreach ($tags as $tag) {
$tag = trim($tag);
if ($tag !== '') {
$clean_tags[] = htmlspecialchars($tag);
}
}
} else {
$clean_tags = []; // 无标签
}
?>
使用PDO查询,当无结果时fetchAll()返回空数组:
<?php
$stmt = $pdo->prepare("SELECT * FROM users WHERE status=:status");
$stmt->execute(['status' => 'active']);
$users = $stmt->fetchAll(PDO::FETCH_ASSOC);
if (empty($users)) {
// 无活跃用户
echo '暂无活跃用户';
} else {
// 处理用户列表
foreach ($users as $user) {
// ...
}
}
?>
处理第三方API返回的JSON,需考虑多种空值情形:
<?php
$response = file_get_contents('https://api.example.com/users');
$data = json_decode($response, true);
// 多层空值防护
if (json_last_error() === JSON_ERROR_NONE &&
is_array($data) &&
array_key_exists('data', $data) &&
is_array($data['data']) &&
!empty($data['data'])) {
$users = $data['data'];
// 安全处理
} else {
// 记录日志或返回默认值
error_log('API响应格式异常:' . $response);
$users = [];
}
?>
A1:能,但仅当对象实现__isset()或为stdClass且无公共属性时有效。例如:
<?php
$obj = new stdClass();
echo empty($obj) ? '空' : '非空'; // 空
$obj2 = new stdClass();
$obj2->a = null;
echo empty($obj2) ? '空' : '非空'; // 非空(因属性存在)
?>
建议对对象用get_object_vars($obj)转为数组再判断。
A2:用array_filter()过滤掉假值后判断是否为空:
<?php
function assoc_array_all_empty($arr) {
if (!is_array($arr)) return false;
return empty(array_filter($arr, function($v) {
return $v !== '' && $v !== 0 && $v !== '0' && $v !== false && $v !== null;
}));
}
var_dump(assoc_array_all_empty(['a' => null, 'b' => ''])); // true
var_dump(assoc_array_all_empty(['a' => null, 'b' => 0])); // true
var_dump(assoc_array_all_empty(['a' => null, 'b' => 1])); // false
?>
A3:主要差异在类型系统增强。PHP 8.0+中:
empty() [0]不再触发warning(旧版本在严格模式下可能触发)建议使用is_countable()(PHP 7.3+)确保变量可计数:
<?php
if (is_countable($data) && count($data) === 0) { ... }
?>
A4:因为[null]包含一个元素(值为null),数组长度为1。PHP中“空”指元素个数为0,与元素值无关。
<?php
var_dump([null]); // array(1) { [0]=> NULL }
var_dump(count([null])); // int(1)
?>
若需判断“是否全为null”,需遍历检查:
<?php
function is_all_null($arr) {
return is_array($arr) && count($arr) > 0 &&
count(array_filter($arr, function($v) { return $v !== null; })) === 0;
}
?>