PHPのisset()：変数や配列のキーが存在するか判定する

isset($var)は、変数が存在してその値がnullでなければtrueを返します。未定義の変数、unsetされた変数、nullが入った変数にはfalseを返し、警告は決して出しません。

<?php
$name = "Ada";
$age = 0;
$nickname = null;

var_dump(isset($name));       // exists, not null
var_dump(isset($age));        // 0 is still set
var_dump(isset($nickname));   // null counts as not set
var_dump(isset($undefined));  // never assigned

unset($name);
var_dump(isset($name));       // removed with unset()

isset()が見るのは、何かがそこにあるかどうかだけです。0、""、[]のように設定されているが空の値でもtrueを返します。「設定されていて空でない」を確かめたいなら、emptyを否定して使います。

issetで配列のキーが存在するか確認する

isset()がいちばん使われるのはここです。存在しないキーを読むと、通常のPHPの設定ではWarning: Undefined array keyが表示されますが、先にisset()で確認すれば表示されません。ネストしたキーにも使え、最初に欠けている階層で静かに止まります。

<?php
$user = [
    "name" => "Grace",
    "email" => "grace@example.com",
    "address" => ["city" => "Arlington"],
    "phone" => null,
];

var_dump(isset($user["email"]));
var_dump(isset($user["website"]));
var_dump(isset($user["address"]["city"]));
var_dump(isset($user["address"]["zip"]));
var_dump(isset($user["company"]["name"]));  // parent key missing too
var_dump(isset($user["phone"]));            // key exists, value is null

if (isset($user["email"])) {
    echo "Send mail to {$user['email']}\n";
}

値か既定値が欲しいだけなら、$user["website"] ?? "none"が同じ確認を1ステップで行います。null合体演算子を参照してください。

複数の変数をissetで確認する

複数の引数を渡すと、isset()はすべてが設定されていてnullでないときだけtrueを返します。必須の項目がすべて届いたかを確かめる短い方法です。

<?php
$data = ["first" => "Ada", "last" => "Lovelace", "email" => null];

var_dump(isset($data["first"], $data["last"]));
var_dump(isset($data["first"], $data["email"]));

$required = ["first", "last", "email"];
$missing = array_filter($required, fn($key) => !isset($data[$key]));
echo "Missing: " . implode(", ", $missing) . "\n";

文字列とオブジェクトに対するisset

文字列では、isset($str[5])はオフセット5に文字があるかを確認するので、手早い長さのチェックになります。オブジェクトではプロパティを確認します。privateなデータを持つクラスで__isset()メソッドが定義されていれば、isset()はそれを呼び出します。

<?php
$code = "AB12";
var_dump(isset($code[3]));   // 4th character exists
var_dump(isset($code[4]));   // there is no 5th

class Profile
{
    public ?string $bio = null;
    public string $name = "Linus";
    private array $extra = ["twitter" => "@linus"];

    public function __isset(string $key): bool
    {
        return isset($this->extra[$key]);
    }
}

$p = new Profile();
var_dump(isset($p->name));
var_dump(isset($p->bio));       // null
var_dump(isset($p->twitter));   // answered by __isset()
var_dump(isset($p->github));

issetとemptyとis_nullの比較

表で$xの値を選ぶと、3つのチェックと素の(bool)キャストを比べられます。すべてのセルはPHP 8.3で計算したものです。

覚えておきたいパターンです。

• isset()がfalseになるのは、nullと存在しないものだけです。
• empty()はそれらに加え、falseと評価されるすべての値でもtrueになります：false、0、0.0、""、"0"、[]。
• is_null()は、存在する変数ではisset()の反対の結果になりますが、変数が未定義だと警告を出します。代わりにisset()か=== nullを使いましょう。

フォームが送信されたか確認する

フォームの項目が届いたかを調べるには、isset()を使うのが定番です。このブロックを実行し、名前を入力してSendを押すと、$_POSTに値が入った状態で同じスクリプトがもう一度実行されます。

<?php
$message = "";
if (isset($_POST["name"])) {
    $name = trim($_POST["name"]);
    $message = $name === ""
        ? "<p style='color:#c33'>Please type a name.</p>"
        : "<p>Hello, " . htmlspecialchars($name) . "</p>";
}
?>
<form method="post">
  <label>Name <input name="name"></label>
  <label><input type="checkbox" name="news" value="1"> Newsletter</label>
  <button>Send</button>
</form>
<?= $message ?>
<?php if (isset($_POST["name"])): ?>
  <p>Newsletter: <?= isset($_POST["news"]) ? "yes" : "no" ?></p>
<?php endif; ?>

空のテキスト欄も""として送信されるので、送信後は必ずisset($_POST["name"])がtrueになります。チェックを入れていないチェックボックスはまったく送信されないので、チェックボックスにはisset()がまさに適したテストです。空でない値を必須にするには、このブロックのようにtrimした文字列を確認します。バリデーション付きの完全なフォームはフォームのページで作ります。

issetとarray_key_existsの違い

2つは、値がnullのキー以外ではすべて同じ答えを返します。isset()はそれを存在しないものとして扱い、array_key_exists()は扱いません。

<?php
$settings = ["timeout" => 30, "proxy" => null];

foreach (["timeout", "proxy", "retries"] as $key) {
    printf("%-8s isset: %-5s  array_key_exists: %s\n",
        $key,
        var_export(isset($settings[$key]), true),
        var_export(array_key_exists($key, $settings), true));
}

データの中で「nullに設定されている」が「設定されていない」と別の意味を持つなら、array_key_exists()を使います。そうでなければisset()のほうが短く、関数呼び出しではなく言語構造なので少し速くもあります。

よくあるミス：式に対してissetを使う

isset()が受け付けるのは、変数、配列の要素、プロパティだけです。関数の結果や定数を渡すとコンパイルエラーになります。

<?php
if (isset(trim($input))) {}

PHP Fatal error:  Cannot use isset() on the result of an expression (you can use "null !== expression" instead) in /home/index.php on line 2

先に結果を変数に入れるか、値そのものを判定します。メッセージが示すとおりnull !== $exprと書くか、文字列ならtrim($input) !== ""と書きます。