Opérateur de fusion null en PHP : ?? et ??=

?? renvoie la valeur à sa gauche si elle existe et ne vaut pas null, sinon la valeur à sa droite : $name = $_GET['name'] ?? 'Guest';. Contrairement à une lecture directe de la clé, il n'affiche jamais de warning quand la variable ou la clé de tableau manque.

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

À la première exécution, il n'y a pas de query string, donc les deux valeurs par défaut sont utilisées. Cliquez sur un lien de l'onglet Page et le script s'exécute à nouveau avec $_GET rempli. Lire $_GET["name"] sans ?? lors de cette première exécution afficherait Warning: Undefined array key "name" sur une configuration PHP normale. Les données de requête sont détaillées sur la page $_GET et$_POST.

?? est un raccourci de isset()

$a ?? $b signifie exactement isset($a) ? $a : $b. Il fonctionne sur les variables, les clés de tableau à n'importe quelle profondeur et les propriétés d'objet, et il s'arrête sans se plaindre au premier élément manquant.

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

La vérification est la même que celle de isset, donc une clé qui existe avec la valeur null prend aussi la valeur par défaut.

Enchaîner des ?? pour essayer plusieurs sources

?? est associatif à droite et vous pouvez en enchaîner autant que vous voulez. PHP renvoie le premier opérande défini et différent de 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";

??= n'affecte que si la valeur est null

$a ??= $b stocke $b dans $a seulement si $a n'est pas défini ou vaut null. C'est la façon la plus courte de remplir des valeurs par défaut ou de calculer quelque chose une seule fois pour le réutiliser.

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

Le côté droit de ??= n'est évalué que quand l'affectation a lieu, c'est pourquoi computing 4 n'apparaît qu'une fois.

?? ou ?: (ternaire court)

?? teste null. ?: teste si la valeur est évaluée à vrai. Avec des valeurs comme 0, "" et "0", ils donnent des réponses différentes :

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

Une quantité de "0" est une vraie saisie : ?? la garde, ?: la remplace. ?: seul afficherait un warning pour la clé manquante, c'est pourquoi le bloc l'écrit ($inputs[$key] ?? null) ?: .... La page sur l'opérateur ternaire traite de ?: lui-même.

L'opérateur nullsafe ?->

?-> est la version objet de la même idée, ajoutée en PHP 8. Si l'objet de gauche vaut null, toute la chaîne s'arrête et renvoie null au lieu de lever une Error comme Call to a member function getAddress() on null. Ajoutez ?? à la fin pour une valeur par défaut.

<?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'utilisateur 2 existe mais n'a pas d'adresse, et l'utilisateur 3 n'existe pas du tout. Les deux arrivent à la valeur par défaut ?? "unknown" sans erreur.

Erreur fréquente : ?? a une faible priorité

?? est moins prioritaire que . et les opérateurs arithmétiques. Dans "Count: " . $count ?? 0, PHP construit donc d'abord la chaîne "Count: " . $count, qui ne vaut jamais null, et la valeur par défaut n'est jamais utilisée.

<?php
$count = null;

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

Entourez l'expression ?? de parenthèses chaque fois qu'elle se trouve dans une expression plus grande.