変数操作 関数
PHP マニュアル

empty

変数が空であるかどうかを検査する

説明

bool empty(mixed $var)

変数が空であるかどうかを検査します。 変数が空であるとみなされるのは、変数が存在しない場合や 変数の値が false に等しい場合です。 empty は、変数が存在しない場合でも警告を発生させません。 このことは、多次元配列やチェインされたプロパティのような、 ネストされたデータ構造であっても当てはまります。

パラメータ

var

チェックする変数

変数が存在しなくても警告は発生しません。 つまり、empty は本質的に !isset($var) || $var == false と同じことを簡潔に記述しているだけです。

戻り値

var が存在しない、 または空や0の値が設定されている場合、 つまり boolean のコンテキストで 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() が宣言されていればそれをコールします。

参考