الألياف (PHP 8.1)

جزء من قسم Object Oriented Programming في رحلة PHP على Coddy — الدرس 60 من 91.

تُعدّ Fibers إحدى ميزات PHP 8.1 التي تُمكّن من تنفيذ الكود المترابط القابل للمقاطعة. وعلى عكس الدوال العادية التي تعمل من البداية إلى النهاية، يمكن للـ fiber أن يوقف نفسه مؤقتًا في منتصف التنفيذ ويستأنف لاحقًا، مع الحفاظ على حالته between عمليات الإيقاف المؤقت.

قم بإنشاء Fiber عن طريق إمرار callable إلى class الخاص بـ Fiber، ثم ابدأه باستخدام start():

<?php
$fiber = new Fiber(function(): void {
    echo "Step 1\n";
    Fiber::suspend();
    echo "Step 2\n";
});

$fiber->start();
echo "Between steps\n";
$fiber->resume();

المخرجات:

Step 1
Between steps
Step 2

يعمل الـ fiber حتى يصل إلى Fiber::suspend()، ثم يعود التحكم إلى الكود الرئيسي. الاستدعاء resume() يواصل التنفيذ من حيث توقف.

يمكن لألياف `Fiber` أيضاً تمرير القيم عند التعليق والاستئناف:

<?php
$fiber = new Fiber(function(): string {
    $value = Fiber::suspend("paused");
    return "Received: $value";
});

$suspended = $fiber->start();
echo "$suspended\n";

$result = $fiber->resume("hello");
echo $result;

المخرجات:

paused
Received: hello

تُعد الـ Fibers هي الأساس لأطر عمل PHP غير المتزامنة (asynchronous). وعلى الرغم من أنك لن تستخدمها بشكل مباشر في معظم التطبيقات، فإن فهمها يساعدك عند التعامل مع المكتبات غير المتزامنة التي تدير العمليات المتزامنة مثل طلبات HTTP أو استعلامات قواعد البيانات دون تعطيل التنفيذ (non-blocking).

التحدي

سهل

دعنا نبني جدول مهام يوضح كيفية قيام الفايبرز (fibers) بـ إيقاف واستئناف التنفيذ مؤقتًا مع التمرير لـ data بين الـ fiber والكود الرئيسي. ستنشئ نظامًا يمكن إيقاف المهام فيه مؤقتًا، مما يسمح لـ أعمال أخرى بـ الحدوث في هذه الأثناء (between).

ستقوم بتنظيم الكود الخاص بك عبر ملفين:

TaskRunner.php — أنشئ class باسم TaskRunner يغلف وظائف الـ fiber لتشغيل المهام. يجب أن يقوم الـ class بـ:
- امتلاك خاصية private لتخزين كائن Fiber
- قبول اسم المهمة (سلسلة نصية) في الـ constructor الخاص به باستخدام ترقية الـ constructor
- امتلاك دالة createTask(callable $task) تقوم بـ إنشاء Fiber جديد مع الـ callable الـ given وتخزينه
- امتلاك دالة start() تقوم بـ بدء الـ fiber وإعادة أي قيمة يقوم الـ fiber بـ تعليق التنفيذ بها (أو القيمة المرجعة النهائية)
- امتلاك دالة continue(mixed $value) تقوم بـ resume للـ fiber مع الـ value الـ given وإعادة قيمة التعليق التالية (أو القيمة المرجعة النهائية)
- امتلاك دالة isFinished(): bool ترجع ما إذا كان الـ fiber قد انتهى (isTerminated)
main.php — قم بـ تضمين ملف TaskRunner. ستتلقى إدخالين (inputs): اسم المهمة ورسالة (message) لـ إرسالها إلى الـ fiber.
أنشئ TaskRunner مع اسم المهمة الـ given، ثم استخدم createTask() لـ define مهمة تقوم بـ:
1. تعليق التنفيذ في الـ first مع السلسلة النصية "Waiting for input"
2. استلام قيمة عند عمل resumed لها
3. إعادة "Completed: [received value]"
ابدأ المهمة و قم بـ print ما ترجعه عندما تتوقف مؤقتًا لأول مرة (first). ثم قم بـ print لـ "Processing..." لإظهار العمل الـ happening بين إيقافات الـ fiber المؤقتة (pauses). أخيرًا، قم بـ continue للـ fiber عن طريق passing مدخل الرسالة (message)، وقم بـ print للنتيجة (result) النهائية.

يوضح هذا التحدي كيف تمكّن الفايبرز من تعدد المهام التعاوني — تتوقف مهمتك مؤقتًا (pauses) عند نقطة مناسبة، ويفعل الكود الرئيسي أعمالاً أخرى، ثم يقوم بـ resumed للمهمة ببيانات جديدة. يحافظ الـ fiber على حالته طوال الوقت، ليستأنف من حيث توقف تمامًا.

جرّب بنفسك

<?php

require_once 'TaskRunner.php';

// اقرأ المدخلات
$taskName = trim(fgets(STDIN));
$message = trim(fgets(STDIN));

// TODO: أنشئ TaskRunner باسم المهمة المعطى

// TODO: استخدم createTask() لتعريف مهمة تقوم بـ:
// 1. First suspends with the string "Waiting for input"
// 2. تستقبل قيمة عند الاستئناف
// 3. تُرجع "Completed: [received value]"

// TODO: ابدأ المهمة واطبع ما تُرجعه عند أول تعليق

// TODO: اطبع "Processing..." لإظهار العمل الجاري بين توقفات الـ fiber

// TODO: تابع الـ fiber بتمرير مدخل الرسالة

// TODO: اطبع النتيجة النهائية

?>