Workerman 是一个高性能的 PHP 异步网络框架，广泛应用于实时通信、游戏服务器、API 网关等场景。从 Workerman 4.x 版本开始，它原生支持协程（Coroutine），利用 Swoole 或 Swow 的协程能力，使得开发者可以编写同步风格的代码，同时享受异步性能的好处。

以下是 Workerman 协程的使用教程：

1.安装 Workerman

首先，确保你已经安装了 Workerman 和 Swoole 或 Swow 扩展。

composer require workerman/workerman

如果需要使用 Swoole 协程：

pecl install swoole

如果需要使用 Swow 协程：

pecl install swow

2.启动协程支持

在 Workerman 中，协程默认是关闭的，需要手动开启。

Worker::setEventLoopClass(\Workerman\Events\Swoole::class); // 使用 Swoole 事件循环
// 或者
Worker::setEventLoopClass(\Workerman\Events\Swow::class); // 使用 Swow 事件循环

3.协程的基本使用

在 Workerman 中，协程的使用非常简单。以下是一个简单的示例：

onMessage = function($connection, $data) {
    // 启动一个协程
    go(function() use ($connection) {
        // 模拟耗时操作
        Timer::sleep(2); // 协程睡眠 2 秒
        $connection->send("Hello, World!");
    });
};

Worker::runAll();

4.协程的并发执行

协程的亮点之一是并发执行任务。以下是一个并发请求的示例：

onMessage = function($connection, $data) {
    run(function() use ($connection) {
        // 并发执行多个任务
        go(function() {
            Timer::sleep(1);
            echo "Task 1 done\n";
        });

        go(function() {
            Timer::sleep(2);
            echo "Task 2 done\n";
        });

        // 等待所有任务完成
        Timer::sleep(2);
        $connection->send("All tasks completed!");
    });
};

Worker::runAll();

5.协程的数据库操作

在协程中，数据库操作是异步的，不会阻塞事件循环。以下是使用协程操作 MySQL 的示例：

onMessage = function($connection, $data) {
    run(function() use ($connection) {
        // 创建 MySQL 协程客户端
        $mysql = new MySQL();
        $mysql->connect([
            'host' => '127.0.0.1',
            'port' => 3306,
            'user' => 'root',
            'password' => 'password',
            'database' => 'test',
        ]);

        // 执行查询
        $result = $mysql->query('SELECT * FROM users');
        $connection->send(json_encode($result));
    });
};

Worker::runAll();

6.协程的注意事项

协程中尽量避免阻塞操作，否则会失去异步的优势。
协程的生命周期由 run 函数控制，确保所有协程在 run 内部运行。
在协程中，全局变量和静态变量是共享的，需要注意线程安全问题。

7.总结

Workerman 的协程能力可以让开发者以同步的方式编写异步代码，极大地简化了开发复杂度。通过结合 Swoole 或 Swow，Workerman 能够实现高性能的网络服务。

Workerman 协程使用