Оператор объединения с null в PHP: ?? и ??=

?? возвращает значение слева, если оно существует и не равно 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, и скрипт выполнится снова с заполненным $_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 сохраняет $b в $a, только когда $a не задано или равно null. Это самый короткий способ заполнить значения по умолчанию или вычислить что-то один раз и переиспользовать.

<?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 появляется один раз.

?? и ?: (короткий тернарный)

?? проверяет на null. ?: проверяет на истинность. Для значений вроде 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, вся цепочка останавливается и возвращает null, а не выбрасывает Error вроде Call to a member function getAddress() on 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

Оборачивайте выражение с ?? в скобки всякий раз, когда оно стоит внутри более крупного выражения.