isset($v)は「変数が存在し、かつnullでないか」を警告なしで判定する(空文字""や"0"はtrue)。empty($v)は未定義・null・""・[]に加え、数値の0や文字列の"0"もtrue(空)と判定するためフォーム検証では要注意。- 実務では配列キーの取得に Null合体演算子
??を使い、空文字判定は=== ''、NULL判定は=== nullで厳密比較するのが最も安全。
1. 発生する症状・やりたいこと(前提条件)
フォーム入力値($_POST / $_GET)やAPIのJSONレスポンスを判定する際、empty() と isset() の挙動差によって以下のような意図しないバグや警告が発生します。
- お問い合わせや検索フォームで「0(0個・0円・選択肢ID=0)」を入力したのに「未入力エラー」として弾かれてしまう
is_null($data['key'])で未定義の配列キーをチェックすると、PHP 8.x でWarning: Undefined array keyが発生する- 半角・全角スペースだけの入力(
" ")がempty()をすり抜けてDBに保存されてしまう
// PHPのゆるい空判定(empty / isset)による代表的な事故例
$zero = "0"; var_dump(empty($zero)); // bool(true) ← 文字列の "0" が「空」扱いになる!
$blank = ""; var_dump(isset($blank)); // bool(true) ← 空文字 "" でも isset は true になる!
$sp = " "; var_dump(empty($sp)); // bool(false) ← スペースのみは「入力あり」と判定される!
2. ❌ やりがちなNGコード vs ⭕ 実務で使える正解コード
最初に、必須パラメータのチェックで empty() や is_null() をそのまま使ってしまう危険な例と、PHP 8.3 / 8.4 の型安全な実装を比較します。
<?php
// 1. 数量に "0" が送られた場合も empty() が true になりエラー扱いになる
if (empty($_POST['quantity'])) {
throw new InvalidArgumentException('数量を入力してください');
}
// 2. キーが存在しない場合、is_null() は Warning: Undefined array key を出す
if (is_null($_POST['memo'])) {
$memo = '';
}
empty() は文字列 "0" や整数 0 を空とみなすため、0を含む数値項目やフラグ項目のバリデーションを破壊します。また、関数である is_null() は未定義キーを渡した時点でPHP 8のWarningが発生します。
<?php
declare(strict_types=1);
/**
* 文字列入力が実質的に空(null・空文字・空白のみ)か判定する
* ※ "0" は有効な入力(false)として安全に通過させる
*/
function isBlankString(?string $value): bool
{
if ($value === null) {
return true;
}
// PHP 8.4以降は mb_trim($value) === '' でも可
return preg_replace('/\A[\p{C}\p{Z}]++|[\p{C}\p{Z}]++\z/u', '', $value) === '';
}
// 1. 配列キーの安全な取り出しには Null合体演算子(??)を使う(Warningが出ない)
$rawQuantity = is_scalar($_POST['quantity'] ?? null) ? (string)$_POST['quantity'] : null;
if (isBlankString($rawQuantity)) {
throw new InvalidArgumentException('数量を入力してください');
}
$quantity = (int)$rawQuantity; // "0" もエラーにならず 0 として通過する
// 2. 未定義キーの初期値代入は is_null() ではなく ?? を使う
$memo = is_string($_POST['memo'] ?? null) ? $_POST['memo'] : '';
// 3. 空配列かどうかの判定は empty() ではなく $items === [] で明示する
$items = is_array($_POST['items'] ?? null) ? $_POST['items'] : [];
if ($items === []) {
// 配列が空のときの処理
}
3. 仕様・使い分けの比較早見表
変数の状態(型・値)ごとに、isset()・empty()・is_null()・厳密比較(===)が返す真偽値の一覧表です。
| 変数の値 / 状態 | isset($v) |
empty($v) |
is_null($v) |
$v === null |
$v === '' |
|---|---|---|---|---|---|
| 未定義変数 / 未定義キー | false |
true |
true ※警告発生 |
true ※警告発生 |
false ※警告発生 |
null |
false |
true |
true |
true |
false |
""(空文字列) |
true |
true |
false |
false |
true |
"0"(文字列のゼロ) |
true |
true ⚠️要注意 |
false |
false |
false |
0 / 0.0(数値のゼロ) |
true |
true ⚠️要注意 |
false |
false |
false |
false(真偽値) |
true |
true |
false |
false |
false |
[](空配列) |
true |
true |
false |
false |
false |
" "(空白文字のみ) |
true |
false ⚠️素通り |
false |
false |
false |
4. 実務でハマりやすい3つの注意点
$row = ['deleted_at' => null]; のように「キーは存在するが値が null」の連想配列に対して、isset($row['deleted_at']) は false を返します。値に null が入る可能性があるDBレコード等で「キー自体の有無」を調べたい場合は array_key_exists('deleted_at', $row) を使用してください。
is_null() は関数呼び出しであるのに対し、$v === null は言語の比較演算子であるためオーバーヘッドがなく高速です。静的解析ツール(PHPStan / Psalm)やコーディング規約(PSR-12 / PER Coding Style)との相性も良いため、確定済みの変数には $v === null を使うのが現代の標準です。
Eloquentモデルや遅延ロードオブジェクトのプロパティに対して isset($model->prop) や empty($model->prop) を呼ぶと、そのクラスに __isset() が実装されているかどうかに結果が左右されます。オブジェクトのプロパティやメソッド戻り値は一旦変数に受けてから === null で判定する方が安全です。
5. よくある質問(FAQ)
Q. isset() と Null合体演算子(??)はどう使い分ければいいですか?
「値を取り出して初期値を設定したいとき」は $name = $_POST['name'] ?? ''; のように Null合体演算子(??)を使います。?? は内部的に isset() と同じ判定を行うため、未定義キーでも Warning を出さずに1行で安全に代入できます。条件分岐(if文)で存在チェックだけを行いたい場合に isset() を使います。
Q. isset($a, $b, $c) のように複数の変数をまとめて渡すとどうなりますか?
isset() に複数の引数を渡すと、左から順番に評価され、すべての引数が存在し null でない場合のみ true を返します。1つでも未定義または null があればその時点で評価を打ち切って false になるため、isset($req['user'], $req['user']['id']) のように複数キーの同時チェックに便利です。
Q. Laravelの blank() / filled() ヘルパー関数は empty() と何が違いますか?
Laravelの blank() は、PHP標準の empty() の弱点を補う設計になっています。具体的には、数値の 0 や文字列の "0"、false は「空ではない(blank("0") === false)」と正しく判定し、逆にスペースだけの文字列 " " はトリムして「空である(blank(" ") === true)」と判定してくれます。