Operatore di null coalescing PHP: ?? e ??=

?? restituisce il valore alla sua sinistra se esiste e non è null, altrimenti il valore alla sua destra: $name = $_GET['name'] ?? 'Guest';. A differenza della lettura diretta della chiave, non dà mai warning quando la variabile o la chiave dell'array mancano.

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

Alla prima esecuzione non c'è query string, quindi vengono usati entrambi i valori predefiniti. Clicca un link nella scheda Page e lo script gira di nuovo con $_GET compilato. Leggere $_GET["name"] senza ?? in quella prima esecuzione stamperebbe Warning: Undefined array key "name" su una normale installazione di PHP. Altro sui dati della richiesta nella pagina su $_GET e$_POST.

?? è un controllo isset() abbreviato

$a ?? $b significa esattamente isset($a) ? $a : $b. Funziona su variabili, chiavi di array a qualsiasi profondità e proprietà di oggetti, e si ferma al primo pezzo mancante senza lamentarsi.

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

Il controllo è lo stesso che fa isset, quindi anche una chiave che esiste con valore null prende il valore predefinito.

Concatenare ?? per provare più sorgenti

?? è associativo a destra e puoi concatenarne quanti ne vuoi. PHP restituisce il primo operando impostato e non 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";

??= assegna solo quando il valore è null

$a ??= $b salva $b in $a solo quando $a non è impostata o è null. È il modo più breve per compilare i valori predefiniti o per calcolare qualcosa una volta sola e riusarlo.

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

Il lato destro di ??= viene valutato solo quando l'assegnazione avviene, ed è per questo che computing 4 compare una sola volta.

?? vs ?: (ternario breve)

?? verifica null. ?: verifica la truthiness. Con valori come 0, "" e "0" danno risposte diverse:

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

Una quantità di "0" è un input reale: ?? lo mantiene, ?: lo sostituisce. ?: da solo darebbe un warning per la chiave mancante, ed è per questo che il blocco lo avvolge come ($inputs[$key] ?? null) ?: .... La pagina sull'operatore ternario tratta ?: in sé.

L'operatore nullsafe ?->

?-> è la versione per gli oggetti della stessa idea, aggiunta in PHP 8. Se l'oggetto a sinistra è null, l'intera catena si ferma e restituisce null invece di lanciare un Error come Call to a member function getAddress() on null. Metti ?? alla fine per un valore predefinito.

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

L'utente 2 esiste ma non ha un indirizzo, e l'utente 3 non esiste affatto. Entrambi arrivano al valore predefinito ?? "unknown" senza errori.

Errore comune: ?? ha precedenza bassa

?? lega meno di . e degli operatori aritmetici. Quindi in "Count: " . $count ?? 0, PHP prima costruisce la stringa "Count: " . $count, che non è mai null, e il valore predefinito non viene mai usato.

<?php
$count = null;

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

Racchiudi l'espressione con ?? tra parentesi ogni volta che si trova dentro un'espressione più grande.