能用 composer require 安装的是协程环境下的封装库或协程友好客户端(如 topthink/think-swoole、hyperf/http-client、webman/openai 等),而非 Swoole、Swow 等 C 扩展本身;后者须通过 PECL、源码编译或系统包管理器安装。

不能直接用 composer require 安装协程扩展本身,比如 swoole、swow 或 php_thread.so —— 这些是 PHP 的 C 扩展,必须通过 pecl、源码编译或系统包管理器安装,再由 PHP 加载。
哪些能用 composer require?
真正能用 composer require 安装的,是「协程环境下的封装库」或「协程友好的客户端」,它们不提供协程能力,但依赖并适配已启用的协程运行时:
-
topthink/think-swoole:ThinkPHP 的 Swoole 封装,需先装好swoole扩展 -
hyperf/http-client:Hyperf 自带的协程 HTTP 客户端,不兼容guzzlehttp/guzzle -
workerman/workerman:^5.0:Workerman 5.0 原生支持协程,但需额外配置eventLoop -
webman/openai:专为 Webman 协程环境写的 OpenAI 客户端,依赖Workerman\Events\Fiber::class等驱动 -
workbunny/webman-coroutine:提供Utils/Channel、Utils/WaitGroup等统一协程工具,兼容 Swoole/Fiber/Swow
require 之后为什么还是不协程?
常见错误是只装了封装库,却没启用底层协程运行时:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- Swoole 扩展未启用:
php -m | grep swoole返回空,说明没装或没在php.ini中开启 - Webman 没配
eventLoop:config/process.php里对应进程的'eventLoop' => \Workerman\Events\Swoole::class缺失或为空 - Hyperf 没开协程组件:虽然
hyperf/redis已require,但若swoole扩展未加载,它会自动降级为阻塞式 Predis - Laravel +
swooletw/laravel-swoole:即使composer require成功,若SWOOLE_HTTP_HOST配置错或端口被占,服务根本起不来
怎么验证协程真在跑?
别只看 composer require 是否成功,得进代码里测行为:
- 在控制器或回调里写
go(function () { sleep(1); });,如果报Call to undefined function go(),说明 Swoole 扩展没生效 - 用
hyperf/redis时,执行$redis->get('key')后立刻echo 'done';,若输出在 Redis 返回前就出现,说明协程调度正常;否则大概率退化成同步阻塞 - Webman 下启两个端口(一个配
Fiber::class,一个不配),用ab -n 100 -c 50 http://localhost:8686/对比响应时间,差 3 倍以上基本可确认协程生效
最常被忽略的一点:协程不是“装了就能用”,而是“装对了 + 配对了 + 用对了”三者缺一不可。尤其要注意封装库和底层扩展的版本匹配 —— 比如 topthink/think-swoole 要求 Swoole >= 4.8,而 workerman/workerman:^5.0 则完全不依赖 Swoole。选错组合,composer require 再多次也没用。










