phpenv 下 curl 扩展默认不以动态扩展形式启用，而是编译时内置支持；需确保系统已安装 libcurl 开发包并启用 --with-curl 编译选项，成功后 curl_init() 可直接调用，无需 php.ini 配置。
phpenv 下 curl 扩展默认是否启用
绝大多数通过 phpenv 安装的 PHP 版本（尤其是 7.4+ 和 8.x）在编译时已内置 curl 支持，但**不自动加载扩展**——它依赖系统级 libcurl 库，而非独立的 curl.so 文件。这意味着你通常不需要手动编译或复制 curl.so，但必须确保底层系统已安装 libcurl 开发包，且 PHP 编译时启用了 --with-curl。
Linux/macOS 上用 phpenv 安装 PHP 时启用 curl
如果你是用 phpenv install 新装 PHP，curl 是否可用取决于构建环境：
- Ubuntu/Debian：安装前先运行
sudo apt install libcurl4-openssl-dev pkg-config - CentOS/RHEL/Rocky：运行
sudo dnf install libcurl-devel openssl-devel - macOS（Homebrew）：确保已装
curl和openssl@3，执行brew install curl openssl@3 - 安装命令中可显式指定 curl 路径（极少需要）：
CONFIGURE_OPTS="--with-curl=/usr" phpenv install 8.2.12
注意：phpenv 不会修改任何 php.ini，也不生成 curl.ini；只要编译成功，curl_init() 就能直接调用，无需额外 extension 配置。
验证 curl 是否真正可用
别只看 php -m | grep curl ——这个命令在 phpenv 环境下大概率无输出，因为 curl 是「内置模块」，不是动态加载的扩展。正确验证方式是：
基于5000余部现行法律法规进行的高质量专业合同审查，一键输出审查意见书，并附有参考法条原文，满足专业溯源核查要求。由accurLex知法提供技术支持。 Use when users ask for 合同审查, 审查意见书, 合同风险分析, 条款审查,知法,accurLex or 站在甲方/乙方角度审查合同 through accurLex direct API. China law only, plaintext only, review mode limited to 审查意见书.
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -r "var_dump(function_exists('curl_init'));"→ 输出bool(true)即可用 - 检查
php -i | grep -i curl，应看到类似cURL support => enabled、libcurl version => x.x.x - 写个最小测试：
<?php $ch = curl_init('https://httpbin.org/get'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); echo curl_exec($ch); curl_close($ch); ?>若返回 JSON，说明完全就绪
如果报错 Call to undefined function curl_init()，说明 PHP 编译时漏了 curl 依赖，需重装（不是改 php.ini 能解决的）。
常见失败场景与绕过思路
以下情况容易误判为“没开启”，实则是环境链路断裂：
- 系统升级后更新了 OpenSSL，但旧版 PHP 编译链接的是老库路径 → 重装该 PHP 版本（
phpenv uninstall 8.1.22 && phpenv install 8.1.22） - 使用
phpenv global切换版本后，CLI 和 Web SAPI（如 php-fpm）用的不是同一个 PHP → 分别验证：php -v和phpinfo()页面里的版本号、Loaded Configuration File - 宝塔/Nginx + php-fpm 场景下，即使 CLI 可用，Web 端仍报错 → 检查 php-fpm 对应的
php.ini（非 CLI 的那个），确认其disable_functions里没禁掉curl_init
最易被忽略的一点：phpenv 管理的是 CLI 和 fpm 的二进制，但 Web 服务器可能调用的是系统自带 PHP 或其他路径的 php-fpm，务必用 which php 和 ps aux | grep php-fpm 确认实际进程所用 PHP 路径。
