array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.empty.php', 1 => 'empty', 2 => '检查变量是否为空', ), 'up' => array ( 0 => 'ref.var.php', 1 => '变量处理函数', ), 'prev' => array ( 0 => 'function.doubleval.php', 1 => 'doubleval', ), 'next' => array ( 0 => 'function.floatval.php', 1 => 'floatval', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/var/functions/empty.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

empty

(PHP 4, PHP 5, PHP 7, PHP 8)

empty — 检查变量是否为空

说明

empty(mixed $var): bool

判断变量是否为空。如果变量不存在或其值等于 false，则认为变量为空。empty() 不会在变量不存在时产生警告。

参数

var

待检查的变量

变量不存在时不会产生警告。这意味着 empty() 本质上等同于 !isset($var) || $var == false。这也适用于嵌套结构，例如多维数组或链式属性。

返回值

当 var 不存在、值为空、等于 0、为 false 时，返回 true，参阅 转换为 boolean。否则返回 false。

示例

示例 #1 简单的 empty() 与 isset() 的比较。

<?php
$var = 0;

// 因为 $var 为空，所以计算结果为 true
if (empty($var)) {
echo '$var is either 0, empty, or not set at all';
}

// 因为 $var 已赋值，所以计算结果为 true
if (isset($var)) {
echo '$var is set even though it is empty';
}
?>

示例 #2 在字符串偏移量上使用 empty()

<?php
$expected_array_got_string = 'somestring';
var_dump(empty($expected_array_got_string['some_key']));
var_dump(empty($expected_array_got_string[0]));
var_dump(empty($expected_array_got_string['0']));
var_dump(empty($expected_array_got_string['0.5']));
var_dump(empty($expected_array_got_string['0 Mostel']));
?>

以上示例会输出：

bool(true)
bool(false)
bool(false)
bool(true)
bool(true)

示例 #3 多维数组上使用 empty()

<?php
$multidimensional = [
'some' => [
'deep' => [
'nested' => 'value'
]
]
];

if (!empty($multidimensional['some']['some']['nested'])) {
$someVariable = $multidimensional['some']['deep']['nested'];
}

var_dump(empty($multidimensional['some-undefined-key']));
var_dump(empty($multidimensional['some']['deep']['unknown']));
var_dump(empty($multidimensional['some']['deep']['nested']));
?>

以上示例会输出：

bool(true)
bool(true)
bool(false)

注释

注意: 因为是语言构造器而不是函数，不能被 可变函数 或者 命名参数 调用。

注意:

当对一个不可见的对象属性使用 empty() 时，如果存在 __isset() 方法，它将会被调用。

参见