PHPのnull合体演算子：??と??=の使い方

??は、左側の値が存在してnullでなければその値を、そうでなければ右側の値を返します：$name = $_GET['name'] ?? 'Guest';。キーを直接読む場合と違い、変数や配列キーが存在しなくても警告を出しません。

<?php
$name = $_GET["name"] ?? "Guest";
$lang = $_GET["lang"] ?? "en";

echo "<p>Hello, " . htmlspecialchars($name) . " (language: " . htmlspecialchars($lang) . ")</p>";
echo '<p><a href="?name=Ada">?name=Ada</a> | <a href="?name=Linus&lang=fi">?name=Linus&amp;lang=fi</a> | <a href="?">no query</a></p>';

最初の実行ではクエリ文字列がないので、どちらも既定値が使われます。PageタブのリンクをクリックするとURLの値が$_GETに入った状態でスクリプトがもう一度実行されます。その最初の実行で??なしに$_GET["name"]を読むと、通常のPHPの設定ではWarning: Undefined array key "name"が表示されます。リクエストのデータについては$_GETと$_POSTのページで詳しく説明しています。

??はisset()チェックの短縮形

$a ?? $bはisset($a) ? $a : $bとまったく同じ意味です。変数、任意の深さの配列キー、オブジェクトのプロパティに使え、欠けている最初の部分で文句を言わずに止まります。

<?php
$config = [
    "db" => ["host" => "localhost", "port" => null],
];

// The long way
$host = isset($config["db"]["host"]) ? $config["db"]["host"] : "127.0.0.1";

// The same with ??
$host = $config["db"]["host"] ?? "127.0.0.1";
$port = $config["db"]["port"] ?? 3306;        // null, so default
$user = $config["db"]["user"] ?? "root";      // missing key
$cache = $config["cache"]["ttl"] ?? 60;       // missing parent key too
$debug = $undefinedVariable ?? false;         // missing variable

var_dump($host, $port, $user, $cache, $debug);

この確認はissetと同じものなので、存在していても値がnullのキーは既定値になります。

??を連鎖させて複数の候補を試す

??は右結合で、いくつでも連鎖させられます。PHPは、設定されていてnullでない最初のオペランドを返します。

<?php
$fromQuery = null;
$fromCookie = null;
$fromProfile = "fr";

$lang = $fromQuery ?? $fromCookie ?? $fromProfile ?? "en";
echo $lang, "\n";

$settings = ["theme" => null];
$theme = $settings["theme"] ?? $settings["defaultTheme"] ?? "light";
echo $theme, "\n";

??=はnullのときだけ代入する

$a ??= $bは、$aが未設定かnullのときだけ$bを$aに格納します。既定値を埋めたり、何かを一度だけ計算して使い回したりするいちばん短い方法です。

<?php
$options = ["color" => "red", "size" => null];

$options["color"] ??= "blue";   // already set, unchanged
$options["size"] ??= "M";       // null, so assigned
$options["qty"] ??= 1;          // missing, so assigned
print_r($options);

// Compute once, reuse afterwards
function slowSquare(int $n): int {
    echo "computing $n\n";
    return $n * $n;
}
$cache = [];
foreach ([4, 4, 7, 4] as $n) {
    $cache[$n] ??= slowSquare($n);
    echo "$n squared is {$cache[$n]}\n";
}

??=の右辺は代入が行われるときだけ評価されるので、computing 4は1回しか表示されません。

??と?:（省略形の三項演算子）の違い

??はnullかどうかを、?:はtrueと評価されるかどうかを調べます。0、""、"0"のような値では答えが変わります。

<?php
$inputs = ["qty" => "0", "note" => "", "coupon" => null];

foreach (["qty", "note", "coupon", "missing"] as $key) {
    $viaCoalesce = $inputs[$key] ?? "default";
    $viaElvis = ($inputs[$key] ?? null) ?: "default";
    printf("%-8s ?? => %-10s ?: => %s\n",
        $key, var_export($viaCoalesce, true), var_export($viaElvis, true));
}

"0"という数量は正当な入力です。??はそれを残し、?:は置き換えます。?:だけでは存在しないキーについて警告が出るので、このブロックでは($inputs[$key] ?? null) ?: ...のように包んでいます。?:自体については三項演算子のページで扱っています。

nullsafe演算子?->

?->は同じ考え方のオブジェクト版で、PHP 8で追加されました。左側のオブジェクトがnullなら連鎖全体がそこで止まり、Call to a member function getAddress() on nullのようなErrorを投げる代わりにnullを返します。既定値には最後に??を付けます。

<?php
class Address {
    public function __construct(public string $city) {}
}

class User {
    public function __construct(public ?Address $address = null) {}
    public function getAddress(): ?Address { return $this->address; }
}

function findUser(int $id): ?User {
    return match ($id) {
        1 => new User(new Address("Paris")),
        2 => new User(),
        default => null,
    };
}

foreach ([1, 2, 3] as $id) {
    $city = findUser($id)?->getAddress()?->city ?? "unknown";
    echo "user $id: $city\n";
}

ユーザー2は存在しますが住所がなく、ユーザー3はそもそも存在しません。どちらもエラーなしで?? "unknown"の既定値にたどり着きます。

よくあるミス：??は優先順位が低い

??は.や算術演算子より結びつきが弱いです。そのため"Count: " . $count ?? 0では、PHPはまず"Count: " . $countという文字列を作り、それは決してnullにならないので、既定値は使われません。

<?php
$count = null;

echo "Count: " . $count ?? 0, "\n";     // the ?? applies to the whole string
echo "Count: " . ($count ?? 0), "\n";   // what was meant

??の式がより大きな式の中にあるときは、必ず括弧で囲みましょう。