在swoole协程中需使用swoole\coroutine\http\client替代原生curl，1. 因curl阻塞会破坏协程非阻塞特性；2. 推荐swoole\coroutine\http\client支持同步写法但底层异步；3. 必须在co\run中使用且不可调用curl_exec等函数；4. 该客户端支持get/post、https、超时等完整功能，可封装兼容curl逻辑的工具类实现平滑迁移。
在Swoole协程环境中，传统的cURL函数无法直接使用，因为PHP的原生cURL是同步阻塞的，会破坏协程的非阻塞特性。Swoole提供了自己的HTTP客户端组件来替代cURL，实现协程化的HTTP请求。
使用 Swoole\Http\Client
Swoole 提供了 Swoole\Http\Client 类，可以在协程中发起非阻塞的HTTP请求，功能上类似于cURL，但完全适配协程调度。
示例：发送一个GET请求
Co\run(function () {
$client = new Swoole\Http\Client('httpbin.org', 80);
$client->set(['timeout' => 3]);
$client->get('/get', function ($client) {
if ($client->statusCode == 200) {
echo "Response: {$client->body}\n";
} else {
echo "Request failed with status: {$client->statusCode}\n";
}
$client->close();
});
});
示例：发送POST请求
Co\run(function () {
$client = new Swoole\Http\Client('httpbin.org', 80);
$client->set(['timeout' => 3]);
$data = ['name' => 'swoole', 'version' => '5.0'];
$client->post('/post', $data, function ($client) {
if ($client->statusCode == 200) {
echo "POST Response: {$client->body}\n";
}
$client->close();
});
});
使用 Swoole\Coroutine\Http\Client（推荐）
在协程环境下更推荐使用 Swoole\Coroutine\Http\Client，它支持同步写法但底层是非阻塞的，使用更简单直观。
示例：协程风格的同步调用
Co\run(function () {
$client = new Swoole\Coroutine\Http\Client('httpbin.org', 80);
// 设置通用参数
$client->set([
'timeout' => 5,
]);
// GET 请求
$client->get('/');
if ($client->statusCode == 200) {
echo "Body length: " . strlen($client->body) . "\n";
}
// POST 请求
$client->post('/post', ['user' => 'test']);
var_dump($client->body);
$client->close();
});
关键注意事项
- 不能使用 PHP 原生 curl_exec() 等函数，否则会阻塞整个EventLoop
- 必须在 Co\run() 或协程环境中使用 Swoole 的协程客户端
- 建议统一使用 Swoole\Coroutine\Http\Client，语法简洁且不易出错
- 支持 HTTPS、Header设置、Cookie、超时控制等常见需求
- 若需兼容 cURL 接口逻辑，可封装一个协程安全的HTTP工具类替代原cURL调用
基本上就这些。只要避免使用原生cURL函数，改用 Swoole 提供的协程HTTP客户端，就能在协程环境下安全高效地发起HTTP请求。
