curl扩展未启用导致php脚本报错，需按系统分别启用：windows修改php.ini取消注释；linux用包管理器安装php-curl；macos通过homebrew验证或手动添加extension=curl；docker在dockerfile中安装；最后用php -m或curl_init()测试确认。
如果您在PHP环境中运行需要调用远程API、发送HTTP请求或处理JSON数据的脚本，但页面报错提示“cURL extension is not enabled”或函数如curl_init()未定义，则很可能是PHP未启用cURL扩展。以下是启用cURL扩展的具体方法：
一、Windows系统下通过php.ini启用cURL
Windows环境下，cURL扩展通常已随PHP二进制包提供，只需在配置文件中取消注释对应行即可启用。
1、找到PHP安装目录下的php.ini文件，常见路径为C:\php\php.ini或C:\xampp\php\php.ini。
2、用文本编辑器打开php.ini，搜索“;extension=curl”或“;extension=php_curl.dll”。
立即学习“PHP免费学习笔记（深入）”；
3、将该行开头的分号“;”删除，确保其变为extension=curl（PHP 8.0+）或extension=php_curl.dll（旧版本）。
4、确认extension_dir指向正确的扩展目录，例如extension_dir = "ext"，且php_curl.dll文件实际存在于该目录中。
5、保存php.ini，重启Web服务器（如Apache或Nginx）或PHP内置服务器。
二、Linux系统下通过包管理器安装并启用cURL
Linux发行版通常不默认安装PHP-cURL扩展，需使用系统包管理器安装对应模块，并确保PHP配置加载该扩展。
1、对于Debian/Ubuntu系统，执行命令：sudo apt update && sudo apt install php-curl。
2、对于CentOS/RHEL/Rocky Linux 8+，执行命令：sudo dnf install php-curl。
3、对于CentOS/RHEL 7，执行命令：sudo yum install php-curl。
4、安装完成后，检查是否已自动生成ini配置：查看/etc/php.d/或/etc/php/*/mods-available/目录下是否存在curl.ini，内容应为extension=curl。
5、重启Web服务，例如执行sudo systemctl restart apache2或sudo systemctl restart php-fpm。
三、macOS系统下使用Homebrew启用cURL
macOS通过Homebrew安装的PHP通常已内置cURL支持，但若使用系统默认PHP或扩展未加载，需手动验证与启用。
1、确认当前PHP路径：执行which php，若输出为/usr/bin/php，建议改用Homebrew安装的PHP。
2、若已安装brew install php，则cURL扩展默认启用；验证方式为执行php -m | grep curl，有输出即表示已启用。
3、若无输出，检查php.ini位置：php --ini，编辑Loaded Configuration File所指文件。
4、在php.ini末尾添加一行：extension=curl。
5、重启PHP-FPM或Web服务器（如Apache：sudo apachectl restart）。
四、Docker容器内启用cURL扩展
在基于官方PHP镜像构建的Docker环境中，cURL通常默认启用；若使用alpine镜像或自定义镜像，需显式安装扩展。
1、在Dockerfile中，针对debian基础镜像添加：RUN docker-php-ext-install curl。
2、针对alpine镜像，添加：RUN apk add --no-cache curl-dev && docker-php-ext-install curl。
3、确保Dockerfile中未通过disable-curl等参数编译PHP。
4、构建新镜像后，进入容器执行php -m | grep curl验证。
5、重启容器使更改生效。
五、验证cURL是否成功启用
无论采用哪种启用方式，最终必须通过代码或命令行确认扩展已加载并可正常调用。
1、创建一个test_curl.php文件，内容为：
2、在浏览器中访问该文件，返回bool(true)表示启用成功。
3、或在终端执行：php -r "var_dump(function_exists('curl_init'));"。
4、进一步测试连接能力：运行php -r "$ch = curl_init('https://httpbin.org/get'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); echo curl_exec($ch); curl_close($ch);"。
