العامل الثلاثي في PHP: الصيغة المختصرة ?: والتداخل

العامل الثلاثي جملة if/else تتسع في تعبير واحد: condition ? valueIfTrue : valueIfFalse. يعيد إحدى القيمتين، لذا يمكنك إسناده أو طباعته بـ echo أو تمريره إلى دالة.

<?php
$age = 20;

$label = $age >= 18 ? "adult" : "minor";
echo $label, "\n";

// The same thing as an if/else
if ($age >= 18) {
    $label = "adult";
} else {
    $label = "minor";
}
echo $label, "\n";

$items = 1;
echo "You have $items " . ($items === 1 ? "item" : "items") . "\n";

غيّر $age إلى 15 و$items إلى 3 وشغّل الكود مرة أخرى. لاحظ الأقواس حول العامل الثلاثي في السطر الأخير: دونها ستربط . النصوص أولًا ولن تكون النتيجة ما تريد.

العامل الثلاثي في قوالب HTML

العامل الثلاثي هو الطريقة المعتادة لاختيار صنف CSS أو تسمية أو سمة داخل قالب. يقرأ هذا المثال ?stock= من الرابط: شغّله، ثم انقر الروابط في تبويب Page فيُنفَّذ السكربت نفسه مرة أخرى بقيمة مختلفة.

<?php
$stock = (int) ($_GET["stock"] ?? 5);
$inStock = $stock > 0;
?>
<style>
  .ok { color: #0a7; } .out { color: #c33; }
  a { margin-right: 8px; }
</style>
<p class="<?= $inStock ? 'ok' : 'out' ?>">
  <?= $inStock ? "In stock ($stock left)" : "Sold out" ?>
</p>
<button <?= $inStock ? '' : 'disabled' ?>>Add to cart</button>
<p><a href="?stock=0">stock = 0</a><a href="?stock=1">stock = 1</a><a href="?stock=12">stock = 12</a></p>

<?= ... ?> اختصار لـ <?php echo ... ?>، وهذا يبقي الشروط ذات السطر الواحد مقروءة داخل الوسوم.

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

احذف الجزء الأوسط فتحصل على $a ?: $b: يعيد $a عندما تكون $a صحيحة منطقيًا، وإلا $b. وهو مفيد للقيم الافتراضية عندما يجب أن يرجع النص الفارغ أو 0 أيضًا إلى البديل.

<?php
$nickname = "";
$fullName = "Ada Lovelace";

echo $nickname ?: $fullName, "\n";
echo "Grace" ?: "nobody", "\n";
echo 0 ?: "zero is falsy", "\n";

// Chains read left to right
$fromForm = "";
$fromProfile = null;
echo $fromForm ?: $fromProfile ?: "Anonymous", "\n";

القيم الخاطئة منطقيًا هي false و0 و0.0 و"" و"0" و[] وnull. فإذا كانت "0" إجابة حقيقية في بياناتك (حقل كمية، أو رمز PIN)، فسيتخلص منها العامل الثلاثي المختصر.

?: مقابل ??

يتشابهان في الشكل لكنهما يتحققان من أشياء مختلفة. يرجع ?: إلى البديل عندما يكون الطرف الأيسر خاطئًا منطقيًا. أما ?? فلا يرجع إلى البديل إلا عندما يكون الطرف الأيسر null أو غير معيَّن، ولا يحذّر من متغير أو مفتاح مصفوفة مفقود.

<?php
$values = [0, "", "0", null, false, "php"];

foreach ($values as $v) {
    printf("%-7s  ?: gives %-8s  ?? gives %s\n",
        var_export($v, true),
        var_export($v ?: "default", true),
        var_export($v ?? "default", true));
}

$form = ["qty" => "0"];
echo "qty with ??: ", $form["qty"] ?? "1", "\n";
echo "missing key with ??: ", $form["color"] ?? "none", "\n";

استخدم ?? لحالة «قد لا تكون القيمة موجودة» (بيانات الطلب، ومصفوفات الإعدادات، والمفاتيح الاختيارية). واستخدم ?: لحالة «القيمة موجودة لكنها قد تكون فارغة». تشرح صفحة عامل الدمج مع null العاملين ?? و??= بالتفصيل.

العامل الثلاثي المتداخل يحتاج إلى أقواس

كانت PHP 7 تقرأ a ? b : c ? d : e من اليسار إلى اليمين، بخلاف كل اللغات الأخرى تقريبًا، فكانت تنتج نتائج خاطئة. أما PHP 8 فترفض التخمين:

<?php
echo $score > 90 ? "A" : $score > 80 ? "B" : "C";

PHP Fatal error:  Unparenthesized `a ? b : c ? d : e` is not supported. Use either `(a ? b : c) ? d : e` or `a ? b : (c ? d : e)` in /home/index.php on line 2

أضف أقواسًا حول العامل الثلاثي الداخلي فيعمل:

<?php
foreach ([95, 85, 70] as $score) {
    $grade = $score > 90 ? "A" : ($score > 80 ? "B" : "C");
    echo "$score => $grade\n";
}

العامل الثلاثي المختصر هو الاستثناء: $a ?: $b ?: $c مسموح دون أقواس، كما في مثال Elvis أعلاه.

استخدم match(true) عندما يكون هناك أكثر من فرعين

العامل الثلاثي المتداخل بثلاثة أو أربعة مستويات صعب القراءة حتى مع الأقواس. تتحقق match مع true موضوعًا لها من الشروط من الأعلى إلى الأسفل وتعيد أول فرع مطابق:

<?php
function grade(int $score): string
{
    return match (true) {
        $score >= 90 => "A",
        $score >= 80 => "B",
        $score >= 70 => "C",
        default      => "F",
    };
}

foreach ([95, 85, 72, 40] as $s) {
    echo "$s => ", grade($s), "\n";
}

احتفظ بالعامل الثلاثي لنتيجتين في سطر واحد، والجأ إلى match أو سلسلة if/elseif بمجرد أن تحتاج إلى نتيجة ثالثة.