缺少libcurl开发头文件导致configure报错，需安装对应系统开发包并正确配置环境变量、链接参数及运行时hook。
configure阶段报错找不到curl/curl.h
这说明系统缺 libcurl 开发头文件，不是 Swoole 代码问题，也不是 PHP 版本不匹配。configure 会静默跳过 --enable-swoole-curl，后续编译或运行时才暴露问题。
- Ubuntu/Debian：运行
sudo apt install libcurl4-openssl-dev - CentOS/RHEL 8+：
sudo dnf install libcurl-devel - macOS（M2）：
brew install curl，再补环境变量：export CPPFLAGS="-I$(brew --prefix curl)/include"和export LDFLAGS="-L$(brew --prefix curl)/lib" - 验证是否生效：
./configure --with-php-config=$(which php-config) --enable-swoole-curl 2>&1 | grep -i curl，看到checking for cURL support才算成功
make时报ld: warning: -undefined suppress is deprecated
这是 macOS（尤其 M2）常见链接警告，虽不中断编译，但可能掩盖真实链接失败。它源于 linker 对动态符号解析的默认行为变更。
CurlShip Directory Submission
下载
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
- 解决方法是在 configure 前加：
LDFLAGS="-Wl,-undefined,dynamic_lookup" - 完整命令示例：
LDFLAGS="-Wl,-undefined,dynamic_lookup" ./configure --with-php-config=/usr/local/bin/php-config --enable-swoole-curl - 别忽略这个警告——如果后续
php --ri swoole显示cURL => disabled，大概率就是链接没生效
装完扩展后curl仍不生效
即使编译通过、swoole.so 已安装，协程 cURL 还是同步阻塞甚至卡死，核心原因是运行时没启用 hook。
-
--enable-swoole-curl只让 Swoole 编译进 cURL 协程支持能力，不自动启用 - 必须在 PHP 代码中显式调用：
Runtime::enableCoroutine(SWOOLE_HOOK_NATIVE_CURL) - 注意：该调用需在所有 cURL 请求之前执行，且仅对当前协程有效；若用
SWOOLE_HOOK_ALL，则无需单独指定 - 验证方式：
php -r "echo swoole_version();"确认版本 ≥ 4.8.0，再跑一段协程 cURL 代码看是否真异步
宝塔面板或PECL安装环境下libcurl缺失
宝塔自带的 PHP 环境常缺开发依赖，PECL 安装也依赖底层 libcurl 开发包，不能只靠 pecl install swoole 一步到位。
- 先检查：
php-config --extension-dir对应目录是否存在swoole.so；若不存在，说明 PECL 编译失败 - 宝塔用户务必先执行：
yum install -y gcc gcc-c++ autoconf libtool make openssl-devel libcurl-devel（CentOS）或对应 apt/dnf 命令 - PECL 安装前确认：
curl-config --version有输出，否则pecl install swoole会跳过 cURL 支持 - 装完仍报
Class 'Swoole\Runtime' not found？可能是 CLI 和 FPM 的 php.ini 没统一加extension=swoole
