กลุ่มรอคอย Coroutine WaitGroup

WaitGroup เป็นเครื่องมือสำหรับการซิงโครไนซ์ของคอโรทีน มีความคล้ายคลึงกับ Barrier ซึ่งอนุญาตให้รอคอยทุกคอโรทีนให้ทำงานเสร็จก่อนที่จะดำเนินการตามลำดับถัดไป

ความแตกต่างจาก Barrier คือ WaitGroup สามารถควบคุมการเพิ่มหรือลดจำนวนของนักพัฒนาด้วยตนเอง

หมายเหตุ
ระบบจะตรวจจับประเภทของไดรเวอร์โดยอัตโนมัติ รองรับเฉพาะ Swoole/Swow/Fiber เท่านั้น

คำแนะนำ
คุณสมบัตินี้ต้องการ workerman>=5.1.0

<?php
use Workerman\Connection\TcpConnection;
use Workerman\Coroutine\Barrier;
use Workerman\Coroutine;
use Workerman\Events\Swoole;
use Workerman\Protocols\Http\Request;
use Workerman\Worker;
require_once __DIR__ . '/vendor/autoload.php';

// Http Server
$worker = new Worker('http://0.0.0.0:8001');
$worker->eventLoop = Swoole::class; // หรือ Swow::class หรือ Fiber::class
$worker->onMessage = function (TcpConnection $connection, Request $request) {
    $wg = new WaitGroup();
    for ($i=1; $i<5; $i++) {
        $wg->add();
        Coroutine::create(function () use ($wg, $i) {
            try {
            // ทำบางอย่าง
            } finally {
                $wg->done();
            }
        });
    }
    // รอคอยให้คอโรทีนทั้งหมดเสร็จสิ้น หยุดรอหลังจาก 10 วินาที
    $result = $wg->wait(10.0);
    if (!$result) {
        $connection->send('WaitGroup หมดเวลา');
        return;
    }
    $connection->send('ทุกงานเสร็จสิ้น');
};

Worker::runAll();

คำอธิบายอินเทอร์เฟซ

interface WaitGroupInterface
{

    /**
     * เพิ่มจำนวน
     *
     * @param int $delta
     * @return bool
     */
    public function add(int $delta = 1): bool;

    /**
     * ทำให้เสร็จ
     *
     * @return bool
     */
    public function done(): bool;

    /**
     * คืนค่าจำนวน
     *
     * @return int
     */
    public function count(): int;

    /**
     * รอคอยคอโรทีน
     *
     * @param int|float $timeout วินาที
     * @return bool timeout:false สำเร็จ:true
     */
    public function wait(int|float $timeout = -1): bool;
}