PHP 8.1 的 curl 扩展默认已内置但不自动加载，需确认系统依赖、修正对应 php.ini 中 extension=curl、核对 extension_dir 及 curl.so 路径，并分别验证 CLI 与 FPM/Web 环境；正确验证方式为 php -r "var_dump(function_exists('curl_init'));" 输出 bool(true)。

PHP 8.1 的 curl 扩展默认不自动加载，但绝大多数编译版本已内置支持；你不需要下载或编译 curl.so，只需确认系统依赖就绪、配置指向正确、CLI/FPM 环境分别生效即可。

确认 PHP 8.1 实际加载的 php.ini 路径

phpenv、Homebrew、Windows phpEnv、Docker 等环境都可能有多个 php.ini，改错文件等于白做。必须先运行：

php --ini

看 “Loaded Configuration File” 输出的路径——90% 的情况不是你直觉认为的那个文件。

phpenv 用户：路径通常是 /phpenv/versions/8.1.28/etc/php.ini（版本号需匹配）

Homebrew 用户：常见为 /usr/local/etc/php/8.1/php.ini

Windows phpEnv：极大概率是 phpenv\php\php.ini-development 或 php.ini-production

Docker（trae 或自定义镜像）：/usr/local/etc/php/conf.d/docker-php-ext-curl.ini 可能根本不存在，需手动创建或重建镜像

启用 extension=curl 并检查 extension_dir

打开上一步确认的真实 php.ini，搜索 extension=curl 或 extension=php_curl.dll（Windows）：

Linux/macOS：取消注释 ;extension=curl → 改为 extension=curl

Windows：改为 extension=php_curl.dll（PHP 8.1+ 不再接受 php_curl.dll 以外的写法）

必须核对 extension_dir 值是否真实存在且含目标文件：

— Linux/macOS：运行 php -i | grep extension_dir，然后 ls {输出路径}/curl.so

— Windows：确认 phpenv\php\ext\php_curl.dll 存在，且 extension_dir = "ext" 指向该目录

验证 curl 是否真正可用（别信 php -m）

php -m | grep curl 在 PHP 8.1+ 的 phpenv/Homebrew 环境中大概率无输出——因为 curl 是内置模块，不是动态扩展。正确验证方式是：

函数存在性：php -r "var_dump(function_exists('curl_init'));" → 必须输出 bool(true)

底层支持：php -i | grep -i "curl support\|libcurl version" → 应见 cURL support => enabled

HTTPS 可用性（关键！）：php -r "$ch = curl_init('https://httpbin.org/get'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); echo curl_exec($ch); curl_close($ch);" → 若报 SSL 错误或空响应，说明缺证书或 OpenSSL DLL

Windows 用户若 HTTPS 失败，必须检查 phpenv\php\ 根目录下是否存在 libeay32.dll 和 ssleay32.dll；macOS 用户需确保 brew install curl openssl@3 已执行且 PHP 编译时链接了它们。

CLI 和 Web（FPM/Apache）必须分开验证

改完 CLI 的 php.ini，不代表 Web 请求就能用 curl——FPM 或 Apache mod_php 加载的是另一份配置：

FPM 用户：运行 phpenv fpm status 确认服务在用哪个版本，再查其 www.conf 中的 php_admin_value[php_ini]，或默认 fallback 到 /phpenv/versions/8.1.28/etc/php-fpm.d/www.conf 关联的 ini

Apache 用户：phpinfo() 页面里的 “Loaded Configuration File” 才是 Web 环境实际加载的路径

trae/Docker 用户：trae exec php php --ini 和 trae exec php php -r "..." 测试 CLI；浏览器访问 info.php 测试 Web

最常被忽略的一点：FPM 配置改完后，必须执行 phpenv fpm restart 8.1.28（或对应命令），否则永远不生效。

Tags: PHP8.1如何开启curl扩展 PHP8.1开启curl扩展

分享到：