Operator null coalescing w PHP: ?? i ??=

?? zwraca wartość po lewej, jeśli istnieje i nie jest null, w przeciwnym razie wartość po prawej: $name = $_GET['name'] ?? 'Guest';. W przeciwieństwie do bezpośredniego odczytu klucza nigdy nie ostrzega, gdy brakuje zmiennej albo klucza tablicy.

<?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>';

Przy pierwszym uruchomieniu nie ma query stringa, więc użyte są obie wartości domyślne. Kliknij link na karcie Page, a skrypt wykona się ponownie z wypełnionym $_GET. Odczyt $_GET["name"] bez ?? przy tym pierwszym uruchomieniu wypisałby w zwykłej konfiguracji PHP Warning: Undefined array key "name". Więcej o danych żądania jest na stronie o $_GET i$_POST.

?? to krótkie sprawdzenie isset()

$a ?? $b oznacza dokładnie isset($a) ? $a : $b. Działa na zmiennych, kluczach tablic na dowolnej głębokości i właściwościach obiektów i zatrzymuje się bez skargi na pierwszym brakującym elemencie.

<?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);

To samo sprawdzenie wykonuje isset, więc klucz, który istnieje z wartością null, też dostaje wartość domyślną.

Łańcuch ?? do sprawdzenia kilku źródeł

?? jest prawostronnie łączny i możesz połączyć dowolnie wiele operatorów. PHP zwraca pierwszy operand, który jest ustawiony i nie jest 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";

??= przypisuje tylko przy null

$a ??= $b zapisuje $b w $a tylko wtedy, gdy $a nie jest ustawione albo ma wartość null. To najkrótszy sposób na uzupełnienie wartości domyślnych albo jednorazowe obliczenie czegoś i ponowne użycie.

<?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";
}

Prawa strona ??= jest obliczana tylko wtedy, gdy przypisanie następuje, dlatego computing 4 pojawia się raz.

?? vs ?: (skrócony operator trójargumentowy)

?? sprawdza null. ?: sprawdza prawdziwość. Przy wartościach takich jak 0, "" i "0" dają różne odpowiedzi:

<?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));
}

Ilość "0" to prawdziwe dane wejściowe: ?? ją zachowuje, ?: zastępuje. Samo ?: ostrzegłoby o brakującym kluczu, dlatego blok zapisuje je jako ($inputs[$key] ?? null) ?: .... Sam ?: opisuje strona o operatorze trójargumentowym.

Operator nullsafe ?->

?-> to wersja tego samego pomysłu dla obiektów, dodana w PHP 8. Jeśli obiekt po lewej to null, cały łańcuch się zatrzymuje i zwraca null zamiast rzucać Error w rodzaju Call to a member function getAddress() on null. Na końcu dodaj ??, aby mieć wartość domyślną.

<?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";
}

Użytkownik 2 istnieje, ale nie ma adresu, a użytkownik 3 w ogóle nie istnieje. Obaj docierają do wartości domyślnej ?? "unknown" bez błędu.

Częsty błąd: ?? ma niski priorytet

?? wiąże słabiej niż . i operatory arytmetyczne. Dlatego w "Count: " . $count ?? 0 PHP najpierw buduje łańcuch "Count: " . $count, który nigdy nie jest null, a wartość domyślna nigdy nie zostaje użyta.

<?php
$count = null;

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

Obejmij wyrażenie z ?? nawiasami, gdy tylko stoi w większym wyrażeniu.