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）：
立即学习“PHP免费学习笔记（深入）”；
CurlShip Directory Submission
下载
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
- 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（或对应命令），否则永远不生效。
