Operador de fusión de null en PHP: ?? y ??=

?? devuelve el valor de su izquierda si existe y no es null; si no, el de su derecha: $name = $_GET['name'] ?? 'Guest';. A diferencia de leer la clave directamente, nunca avisa cuando falta la variable o la clave del array.

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

En la primera ejecución no hay query string, así que se usan los dos valores por defecto. Haz clic en un enlace de la pestaña Página y el script se ejecuta otra vez con $_GET lleno. Leer $_GET["name"] sin ?? en esa primera ejecución imprimiría Warning: Undefined array key "name" en una instalación normal de PHP. Hay más sobre los datos de la petición en la página de $_GET y$_POST.

?? es una comprobación isset() abreviada

$a ?? $b significa exactamente isset($a) ? $a : $b. Funciona con variables, claves de array a cualquier profundidad y propiedades de objetos, y se detiene en la primera pieza que falta sin quejarse.

<?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 comprobación es la misma que hace isset, así que una clave que existe con el valor null también recibe el valor por defecto.

Encadenar ?? para probar varias fuentes

?? es asociativo por la derecha y puedes encadenar tantos como quieras. PHP devuelve el primer operando que esté definido y no sea 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";

??= asigna solo cuando es null

$a ??= $b guarda $b en $a solo cuando $a no está definida o es null. Es la forma más corta de rellenar valores por defecto o de calcular algo una vez y reutilizarlo.

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

El lado derecho de ??= solo se evalúa cuando ocurre la asignación, y por eso computing 4 aparece una sola vez.

?? vs ?: (ternario corto)

?? comprueba si es null. ?: comprueba si es truthy. Con valores como 0, "" y "0" dan respuestas distintas:

<?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 cantidad "0" es una entrada real: ?? la conserva, ?: la sustituye. ?: por sí solo avisaría de la clave que falta, y por eso el bloque lo envuelve como ($inputs[$key] ?? null) ?: .... La página del operador ternario explica el propio ?:.

El operador nullsafe ?->

?-> es la versión para objetos de la misma idea, añadida en PHP 8. Si el objeto de la izquierda es null, toda la cadena se detiene y devuelve null en lugar de lanzar un Error como Call to a member function getAddress() on null. Pon ?? al final para un valor por defecto.

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

El usuario 2 existe pero no tiene dirección, y el usuario 3 no existe en absoluto. Los dos llegan al valor por defecto ?? "unknown" sin ningún error.

Error frecuente: ?? tiene poca precedencia

?? tiene menos prioridad que . y que los operadores aritméticos. Así, en "Count: " . $count ?? 0, PHP construye primero la cadena "Count: " . $count, que nunca es null, y el valor por defecto nunca se usa.

<?php
$count = null;

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

Envuelve la expresión con ?? entre paréntesis siempre que esté dentro de una expresión más grande.