عامل الدمج مع null في PHP: ?? و??=

يعيد ?? القيمة الموجودة على يساره إذا كانت موجودة وليست null، وإلا القيمة على يمينه: $name = $_GET['name'] ?? 'Guest';. وبخلاف قراءة المفتاح مباشرة، لا يحذّر أبدًا عندما يكون المتغير أو مفتاح المصفوفة مفقودًا.

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

في التشغيل الأول لا توجد سلسلة استعلام، فتُستخدم القيمتان الافتراضيتان. انقر رابطًا في تبويب Page فيُنفَّذ السكربت مرة أخرى مع امتلاء $_GET. وقراءة $_GET["name"] دون ?? في ذلك التشغيل الأول كانت ستطبع Warning: Undefined array key "name" في إعداد PHP عادي. والمزيد عن بيانات الطلب في صفحة $_GET و$_POST.

?? فحص isset() مختصر

$a ?? $b تعني بالضبط isset($a) ? $a : $b. يعمل على المتغيرات، ومفاتيح المصفوفات بأي عمق، وخصائص الكائنات، ويتوقف عند أول جزء مفقود دون اعتراض.

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

الفحص هو نفسه الذي تجريه isset، لذا فالمفتاح الموجود بالقيمة null يأخذ القيمة الافتراضية أيضًا.

سلسلة ?? لتجربة عدة مصادر

?? تجميعي من اليمين، ويمكنك ربط ما شئت منه في سلسلة. تعيد PHP أول معامل معيَّن وليس 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";

??= لا يُسند إلا عند null

يخزّن $a ??= $b القيمة $b في $a فقط عندما تكون $a غير معيَّنة أو null. وهو أقصر طريقة لملء القيم الافتراضية أو لحساب شيء مرة واحدة وإعادة استخدامه.

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

لا يُقيَّم الطرف الأيمن من ??= إلا عندما يحدث الإسناد، ولهذا يظهر computing 4 مرة واحدة.

?? مقابل ?: (العامل الثلاثي المختصر)

يختبر ?? القيمة null. ويختبر ?: الصحة المنطقية. ومع قيم مثل 0 و"" و"0" يعطيان إجابات مختلفة:

<?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" مدخل حقيقي: يحتفظ بها ??، ويستبدلها ?:. وكان ?: وحده سيحذّر من المفتاح المفقود، ولهذا يغلّفه المثال هكذا ($inputs[$key] ?? null) ?: .... تشرح صفحة العامل الثلاثي العامل ?: نفسه.

عامل nullsafe ?->

?-> هو نسخة الكائنات من الفكرة نفسها، وأُضيف في PHP 8. إذا كان الكائن على اليسار null، تتوقف السلسلة كلها وتعيد null بدلًا من إطلاق Error مثل Call to a member function getAddress() on null. ضع ?? في النهاية للحصول على قيمة افتراضية.

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

المستخدم 2 موجود لكن ليس له عنوان، والمستخدم 3 غير موجود أصلًا. كلاهما يصل إلى القيمة الافتراضية ?? "unknown" دون خطأ.

خطأ شائع: أولوية ?? منخفضة

يرتبط ?? بقوة أقل من . والعوامل الحسابية. لذا في "Count: " . $count ?? 0، تبني PHP أولًا النص "Count: " . $count، الذي لا يكون null أبدًا، فلا تُستخدم القيمة الافتراضية أبدًا.

<?php
$count = null;

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

ضع تعبير ?? بين أقواس كلما كان داخل تعبير أكبر.