قناة协程通道

تعتبر قناة وسيلة للتواصل بين协程. يمكن لم协程 دفع البيانات إلى القناة في حين يمكن لم协程 الآخر سحب البيانات منها، مما يتيح مزامنة وتشارك البيانات بين协程.

提示
此特性需要 workerman>=5.1.0

注意

• يدعم تلقائيًا Swoole/Swow/Fiber/Select/Event
• عند استخدام Select/Event ، لا يدعم وسيط المهلة pop/push

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

// خادم Http
$worker = new Worker('http://0.0.0.0:8001');
$worker->eventLoop = Swoole::class; // أو Swow::class أو Fiber::class
$worker->onMessage = function (TcpConnection $connection, Request $request) {
    $channel = new Channel(2);
    Coroutine::create(function () use ($channel) {
        $channel->push('Task 1 Done');
    });
    Coroutine::create(function () use ($channel) {
        $channel->push('Task 2 Done');
    });
    $result = [];
    for ($i = 0; $i < 2; $i++) {
        $result[] = $channel->pop();
    }
    $connection->send(json_encode($result)); // الاستجابة: ["Task 1 Done","Task 2 Done"]
};
Worker::runAll();

接口说明

interface ChannelInterface
{
    /**
     * دفع بيانات إلى القناة، يدعم المهلة (بالثواني)، العودة false عند تجاوز المهلة
     */
    public function push(mixed $data, float $timeout = -1): bool;

    /**
     * سحب بيانات من القناة، يدعم المهلة (بالثواني)، العودة false عند تجاوز المهلة
     */
    public function pop(float $timeout = -1): mixed;

    /**
     * الحصول على طول البيانات في القناة
     */
    public function length(): int;

    /**
     * الحصول على سعة القناة
     */
    public function getCapacity(): int;

    /**
     * هل هناك مستهلكين، أي هل هناك协程 في انتظار سحب البيانات
     */
    public function hasConsumers(): bool;

    /**
     * هل هناك منتجين، أي هل هناك协程 في انتظار دفع البيانات إلى القناة
     */
    public function hasProducers(): bool;

    /**
     * إغلاق القناة
     */
    public function close(): void;

}