PHP Null Birleştirme Operatörü: ?? ve ??=

??, solundaki değer varsa ve null değilse onu, değilse sağındaki değeri döndürür: $name = $_GET['name'] ?? 'Guest';. Anahtarı doğrudan okumanın aksine, değişken veya dizi anahtarı eksik olduğunda asla uyarı vermez.

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

İlk çalıştırmada sorgu dizesi yoktur, bu yüzden iki varsayılan da kullanılır. Page sekmesindeki bir bağlantıya tıklayın; betik $_GET dolu olarak yeniden çalışır. O ilk çalıştırmada $_GET["name"] değerini ?? olmadan okumak, normal bir PHP kurulumunda Warning: Undefined array key "name" yazdırırdı. İstek verileri hakkında daha fazlası $_GET ve$_POST sayfasında.

?? kısa bir isset() kontrolüdür

$a ?? $b tam olarak isset($a) ? $a : $b demektir. Değişkenlerde, her derinlikteki dizi anahtarlarında ve nesne özelliklerinde çalışır ve ilk eksik parçada şikâyet etmeden durur.

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

Kontrol, isset fonksiyonunun yaptığıyla aynıdır; bu yüzden null değeriyle var olan bir anahtar da varsayılanı alır.

Birkaç kaynağı denemek için ?? zincirlemek

?? sağdan birleşimlidir ve istediğiniz kadar zincirleyebilirsiniz. PHP atanmış ve null olmayan ilk işleneni döndürür.

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

??= yalnızca null olduğunda atar

$a ??= $b, $b değerini $a içine yalnızca $a atanmamış veya null olduğunda saklar. Varsayılanları doldurmanın ya da bir şeyi bir kez hesaplayıp yeniden kullanmanın en kısa yoludur.

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

??= operatörünün sağ tarafı yalnızca atama gerçekleştiğinde değerlendirilir; computing 4 ifadesinin bir kez görünmesinin nedeni budur.

?? ile ?: (kısa ternary)

?? null için test eder. ?: ise truthy olup olmadığını test eder. 0, "" ve "0" gibi değerlerde farklı yanıtlar verirler:

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

"0" miktarı gerçek bir girdidir: ?? onu korur, ?: onu değiştirir. Tek başına ?: eksik anahtar için uyarı verirdi; bloğun onu ($inputs[$key] ?? null) ?: ... biçiminde sarmasının nedeni budur. Ternary operatörü sayfası ?: operatörünün kendisini anlatır.

Nullsafe operatörü ?->

?->, aynı fikrin PHP 8'de eklenen nesne sürümüdür. Soldaki nesne null ise zincirin tamamı durur ve Call to a member function getAddress() on null gibi bir Error fırlatmak yerine null döndürür. Varsayılan için sona ?? koyun.

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

Kullanıcı 2 var ama adresi yok, kullanıcı 3 ise hiç yok. İkisi de hatasız olarak ?? "unknown" varsayılanına ulaşır.

Sık yapılan hata: ?? operatörünün önceliği düşüktür

??, . ve aritmetik operatörlerden daha gevşek bağlanır. Bu yüzden "Count: " . $count ?? 0 ifadesinde PHP önce asla null olmayan "Count: " . $count stringini oluşturur ve varsayılan hiç kullanılmaz.

<?php
$count = null;

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

?? ifadesi daha büyük bir ifadenin içinde yer aldığında onu her zaman parantez içine alın.