Operator Null Coalescing PHP: ?? dan ??=

?? mengembalikan nilai di sebelah kirinya jika ada dan tidak bernilai null, jika tidak nilai di sebelah kanannya: $name = $_GET['name'] ?? 'Guest';. Tidak seperti membaca key secara langsung, operator ini tidak pernah memberi warning saat variabel atau key array-nya tidak ada.

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

Pada run pertama tidak ada query string, jadi kedua nilai default yang dipakai. Klik sebuah link di tab Halaman, maka script berjalan lagi dengan $_GET yang sudah terisi. Membaca $_GET["name"] tanpa ?? pada run pertama itu akan mencetak Warning: Undefined array key "name" pada pengaturan PHP yang normal. Penjelasan lebih lanjut tentang data request ada di halaman $_GET dan$_POST.

?? adalah pemeriksaan isset() yang singkat

$a ?? $b berarti persis isset($a) ? $a : $b. Operator ini bekerja pada variabel, key array di kedalaman berapa pun, dan property object, serta berhenti di bagian pertama yang tidak ada tanpa mengeluh.

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

Pemeriksaannya sama dengan yang dilakukan isset, jadi key yang ada dengan nilai null juga memakai nilai default.

Merangkai ?? untuk mencoba beberapa sumber

?? bersifat asosiatif kanan dan kamu bisa merangkainya sebanyak yang kamu mau. PHP mengembalikan operand pertama yang sudah diisi dan tidak bernilai 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";

??= hanya mengisi saat null

$a ??= $b menyimpan $b ke $a hanya saat $a belum diisi atau bernilai null. Ini cara paling singkat untuk mengisi nilai default atau menghitung sesuatu sekali lalu memakainya lagi.

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

Sisi kanan ??= hanya dievaluasi saat assignment terjadi, itulah sebabnya computing 4 hanya muncul sekali.

?? vs ?: (ternary singkat)

?? menguji null. ?: menguji truthiness. Dengan nilai seperti 0, "", dan "0", keduanya memberi jawaban yang berbeda:

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

Jumlah "0" adalah input yang sungguhan: ?? mempertahankannya, ?: menggantinya. ?: saja akan memberi warning tentang key yang tidak ada, itulah sebabnya blok ini membungkusnya sebagai ($inputs[$key] ?? null) ?: .... Halaman operator ternary membahas ?: itu sendiri.

Operator nullsafe ?->

?-> adalah versi object dari ide yang sama, ditambahkan di PHP 8. Jika object di sebelah kiri bernilai null, seluruh rantai berhenti dan mengembalikan null alih-alih melempar Error seperti Call to a member function getAddress() on null. Taruh ?? di akhir untuk nilai default.

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

User 2 ada tetapi tidak punya alamat, dan user 3 sama sekali tidak ada. Keduanya sampai ke nilai default ?? "unknown" tanpa error.

Kesalahan umum: ?? punya prioritas rendah

?? mengikat lebih longgar daripada . dan operator aritmetika. Jadi di "Count: " . $count ?? 0, PHP lebih dulu menyusun string "Count: " . $count, yang tidak pernah bernilai null, sehingga nilai default-nya tidak pernah dipakai.

<?php
$count = null;

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

Bungkus ekspresi ?? dengan tanda kurung setiap kali ia berada di dalam ekspresi yang lebih besar.