如何解决PHP 8.1安装时提示“cURL >= 7.15.5 required”_升级系统curl库-php教程-PHP中文网

php 8.1 编译需 libcurl ≥ 7.15.5 开发库，先用 pkg-config --modversion libcurl 验证版本，缺失则安装 libcurl4-openssl-dev，避免手动编译导致 abi 冲突。

如何解决php 8.1安装时提示“curl >= 7.15.5 required”_升级系统<a style= curl库">

PHP 8.1 编译时提示 cURL >= 7.15.5 required，说明当前系统中 libcurl 开发库版本过低（或未安装），而 PHP 的 curl 扩展编译阶段需要满足最低版本要求的 libcurl 头文件和链接库。这不是 PHP 自身的问题，而是构建依赖缺失。

别急着升级，先验证实际版本：

运行 curl --version 显示的是命令行 curl 工具版本，不等于开发库版本
真正要看的是开发包提供的头文件版本：运行 pkg-config --modversion libcurl
如果报错 Package libcurl was not found，说明 libcurl 开发包根本没装
在 Ubuntu/Debian 上，curl 命令和 libcurl 开发库是两个包：curl 和 libcurl4-openssl-dev（或 libcurl4-gnutls-dev）

系统仓库中的 libcurl4-openssl-dev 通常已满足 PHP 8.1 要求（Ubuntu 20.04+ 默认含 curl 7.68+），但旧系统或最小化安装可能缺包：

向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。

下载

执行 sudo apt update && sudo apt install libcurl4-openssl-dev
如果提示版本仍不足（如 Ubuntu 18.04 默认是 7.58），可添加 Ondřej Surý 的 PPA 获取更新版：sudo add-apt-repository ppa:ondrej/php && sudo apt update，再重装 libcurl4-openssl-dev
不要手动下载源码编译安装 curl 后再指向 --with-curl=/path——这极易导致 PHP 运行时与系统其他组件（如 apt、wget）使用的 libcurl ABI 不一致，引发诡异崩溃

即使装了开发包，./configure --with-curl 仍可能失败，常见原因：

pkg-config 不在 $PATH 中：确保已安装 pkg-config（sudo apt install pkg-config）
系统有多个 libcurl（如同时装了 OpenSSL/GnuTLS 版本）：用 pkg-config --libs libcurl 检查链接参数是否合理；必要时显式指定 --with-curl=/usr 或 --with-curl=/usr/include（不推荐，仅调试用）
PHP configure 脚本缓存了旧结果：运行 ./buildconf --force（需有 autoconf）或直接删掉 config.cache 再重试
注意：PHP 8.1 默认启用 --with-curl，无需手动加；若你显式写了 --without-curl 又想启用，得删掉该参数再 configure

编译安装完成后，不能只看 php -m | grep curl，还要确认运行时行为：

运行 php -r "var_dump(curl_version());" —— 输出数组且 version_number ≥ 0x070f05（即 7.15.5 十六进制）才算通过
CLI 和 FPM 加载的 php.ini 可能不同，用 php --ini 和 php -r "echo php_ini_loaded_file();" 确认路径
若 curl_init() 报 Call to undefined function curl_init()，大概率是 extension_dir 路径错或 extension=curl.so 没写对（注意不是 extension=php_curl.dll）
最易被忽略的一点：某些云服务器或容器镜像会把 /usr/lib/x86_64-linux-gnu/libcurl.so 符号链接到一个不存在的路径（如 libcurl.so.4 指向 libcurl-gnutls.so.4 但后者被删了），此时需重建符号链接或重装 libcurl4-openssl-dev

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！