انتقل إلى محتوى الدرس

Counting Values with fetchColumn قراءة عمود مفرد بـ fetchColumn

تعلّم استعلامات الجلب والفلترة والترتيب عبر PDO في PHP بأسلوب PHP 8 الحديث مع أمثلة عملية وتطبيقات تفاعلية.
1 صفوف تعليمية
PHP
2 مشاهدة

شرح صفوف ومحتوى الفقرة

الصف 1 شرح توضيحي

عندما يحتاج الاستعلام إلى قيمة مفردة واحدة فقط من السجل الأول — مثل حساب عدد الصفوف SELECT COUNT(*) أو مجموع المبيعات SUM(total) — نستخدم الدالة المختصرة $stmt->fetchColumn():

  • إرجاع القيمة مباشرة: تُرجع الدالة قيمة العمود الأول (رقم 0 افتراضياً) مباشرة كقيمة مفردة دون وضعها داخل مصفوفة، أو تُرجع false عند عدم وجود صفوف.
  • اختصار استعلامات الإحصاء: تغنيك عن كتابة اسم مستعار للدالة COUNT(*) وفك مصفوفة النتيجة.
PHP
<?php
$pdo = new PDO("sqlite::memory:");
$pdo->exec("CREATE TABLE orders (status TEXT, total INT)");
$pdo->exec("INSERT INTO orders VALUES ('paid', 100), ('paid', 250)");

$stmt = $pdo->prepare("SELECT SUM(total) FROM orders WHERE status = :st");
$stmt->execute(["st" => "paid"]);
$revenue = (int) $stmt->fetchColumn();
echo "Total Paid Revenue: " . $revenue;