首先确认PHP版本为7.4及以上，通过phpize、./configure --enable-coroutine编译安装Swoole，配置php.ini加载swoole.so；随后创建测试脚本验证go()函数是否可用，若报错需检查协程编译参数；接着使用Coroutine\Http\Server类搭建HTTP服务并访问指定端口验证运行；最后编写协程客户端并发请求脚本，在run()中执行多请求测试响应时间，确保协程环境正常工作。
如果您尝试在PHP环境中使用Swoole扩展来提升服务性能，但发现协程功能无法正常使用，可能是由于Swoole未正确安装或配置不当。以下是解决此问题的步骤：
一、确认PHP环境并安装Swoole扩展
在使用Swoole之前，必须确保当前PHP环境支持该扩展，并通过正确的方式进行安装。对于生产环境，推荐使用编译安装以获得更高的灵活性和性能控制。
1、执行命令 php -v 检查PHP版本，确保其为7.4及以上版本，因为低版本可能存在兼容性问题。
2、访问官方GitHub仓库或PECL网站下载对应版本的Swoole源码包，解压后进入目录。
立即学习“PHP免费学习笔记（深入）”；
3、运行 phpize 命令生成配置文件，若提示未找到phpize，请先安装php-devel组件。
4、执行 ./configure --enable-coroutine --enable-openssl 配置编译选项，启用协程与SSL支持。
5、依次运行 make && make install 完成编译安装，完成后会在PHP扩展目录生成swoole.so文件。
6、编辑 php.ini 文件，添加 extension=swoole.so 并保存，随后重启Web服务或CLI环境。
二、验证Swoole协程功能是否可用
安装完成后需检测扩展是否成功加载且协程模块可正常调用。可通过编写简单脚本测试基础协程调度能力。
1、创建 test_swoole.php 文件，写入以下代码：
$code =
if (extension_loaded('swoole')) {
echo "Swoole扩展已加载\n";
}
go(function () {
echo "协程任务开始\n";
co::sleep(1);
echo "协程任务结束\n";
});
echo "主线程继续执行\n";
?>;
EOL;
file_put_contents('test.php', $code);
2、执行 php test_swoole.php 查看输出结果，预期应显示扩展加载信息及协程任务顺序执行的日志。
3、若出现“Fatal error: Uncaught Error: Call to undefined function go()”，说明协程函数未注册，需检查是否遗漏 --enable-coroutine 编译参数。
三、使用Swoole协程实现HTTP服务器
通过内置的Coroutine\Http\Server类可以快速搭建高性能异步HTTP服务，适用于微服务或API网关场景。
1、新建 http_server.php 文件，输入以下内容：
use Swoole\Coroutine\Http\Server;
use function Swoole\Coroutine\run;
run(function () {
\$server = new Server('127.0.0.1', 9502);
\$server->handle('/', function (\$request, \$response) {
\$response->end("Hello from Swoole Coroutine Server");
});
\$server->start();
});
?>
2、启动服务：执行 php http_server.php，保持终端运行状态。
3、打开浏览器访问 http://127.0.0.1:9502 ，若返回指定文本则表明协程HTTP服务部署成功。
4、注意端口占用问题，如提示Address already in use，可更换端口号重新绑定。
四、利用协程客户端并发请求
Swoole协程提供了非阻塞IO支持，能够在单线程内同时发起多个网络请求，显著提升数据获取效率。
1、创建 client_test.php 文件，编写如下代码：
use Swoole\Coroutine\Http\Client;
use function Swoole\Coroutine\run;
run(function () {
\$urls = [
'http://httpbin.org/delay/2',
'http://httpbin.org/delay/1'
];
\$clients = [];
foreach (\$urls as \$url) {
\$client = new Client('httpbin.org', 80);
\$client->set(['timeout' => 3]);
\$client->get(parse_url(\$url)['path']);
\$clients[] = \$client;
}
foreach (\$clients as \$k => \$c) {
echo "Response \$k: " . \$c->getStatusCode() . "\n";
\$c->close();
}
});
?>
2、运行脚本并观察响应时间，两个延迟不同的请求应在约2秒内全部完成，体现并发优势。
3、关键点：所有操作必须包裹在 run() 回调中，否则协程上下文将无法建立。
