curl是PHP中最重要的网络请求扩展之一，无论是调用第三方接口、抓取网页数据还是对接支付回调，几乎都离不开它。但不少新手在本地搭建环境后，第一次调用curl_init()就收到Function must be defined之类的致命错误，说明curl扩展根本没有被加载。此时最有效的排查工具就是PHP自带的phpinfo，它能直观显示当前运行环境中加载了哪些模块、读取了哪个配置文件。本文将带你完整走一遍从phpinfo诊断到配置修复的全过程。
第一步：创建phpinfo页面并确认curl是否加载
在网站根目录下新建一个文件，命名为phpinfo.php，内容只需要三行代码：
<?php phpinfo(); ?>
保存后在浏览器中访问这个页面（例如http://127.0.0.1/phpinfo.php），页面会输出当前PHP环境的完整信息。接下来按Ctrl+F搜索curl关键字，重点看两个位置：一是一级模块列表中有没有单独的curl区块，区块中会显示cURL support是否为enabled以及cURL的版本号；二是底部的Additional Modules区域有没有curl。如果整个页面搜不到任何curl字样，基本可以断定扩展没有被加载，需要进入配置环节。
除了确认curl本身，phpinfo页面的顶部还有几个关键字段需要留意。Loaded Configuration File显示的是PHP实际读取的php.ini路径，这一点非常重要，因为很多机器上同时存在多个php.ini，改错了文件等于白忙一场。另外extension_dir字段指明了扩展目录的位置，后面检查dll或so文件时要用到。建议新手先把这两个路径抄下来，避免后续排查走弯路。
第二步：Windows环境下启用curl扩展
如果你用的是Windows下的集成环境（如phpstudy、WAMP或独立安装的PHP），curl默认以php_curl.dll文件形式存在于ext目录中。打开phpinfo中显示的php.ini，找到这样一行：
;extension=php_curl.dll ; 或者新版本写法 ;extension=curl
行首的分号表示这行被注释掉了，把分号删掉并保存即可。然后重启Apache或Nginx加PHP-FPM（集成环境一般直接重启整个套件），再刷新phpinfo页面搜索curl，正常情况下就能看到curl区块出现了。
Windows下还有一个高频坑点：取消了注释curl还是加载失败。常见原因是ext目录下的php_curl.dll依赖的系统库没有就位，需要把PHP根目录下的libssh2.dll、libcrypto相关dll复制到Apache的bin目录或系统的C:\Windows\System32目录中（复制到System32时要注意PHP是否线程安全版本匹配）。另外如果PHP是以模块方式运行在Apache下的，php.ini中extension_dir的路径必须是绝对路径，写成相对路径有时会导致扩展加载异常。改完任何配置后切记重启服务，phpinfo不会自动刷新。
第三步：Linux环境下安装并启用curl扩展
Linux下PHP扩展通常以独立软件包形式分发。以CentOS为例，执行yum install php-curl或者针对具体版本执行yum install php74-php-curl；Ubuntu和Debian则执行apt-get install php-curl。安装完成后扩展一般会自动在配置目录中生成独立的ini文件，位于/etc/php.d/或/etc/php/版本/mods-available/目录下，使用命令php -m可以快速验证curl是否已出现在模块列表中。
安装后还需要重启Web服务才能让phpinfo页面反映变化。如果PHP-FPM方式运行，执行systemctl restart php-fpm（或带版本号的php74-php-fpm）；如果是Apache模块方式，执行systemctl restart httpd或apache2。重启后再次检查phpinfo页面，确认curl区块出现且cURL support为enabled。
如果是源码编译安装的PHP且当初编译时没有加--with-curl参数，则需要进入源码ext/curl目录，依次执行phpize、./configure、make && make install编译扩展，再在php.ini中添加extension=curl.so并重启服务。编译前需确保系统已安装libcurl-devel开发包，否则configure阶段会报错。
常见坑点：命令行与Web环境配置不一致
很多新手遇到过这样的怪现象：命令行执行php -m能看到curl，但网页里phpinfo却搜不到。这是因为CLI和Web服务读取的可能是不同的php.ini。排查方法是对比phpinfo页面顶部的Loaded Configuration File与命令行执行php --ini显示的加载路径，两者不一致就说明改错了文件。解决方案是统一修改Web环境实际加载的那份php.ini，或者将两份配置中curl相关的启用项保持同步。
另一个典型场景是修改php.ini后忘记重启服务。PHP只在进程启动时读取一次配置，之后无论怎么改文件都不会生效。此外，如果使用了Docker镜像，扩展应该在构建阶段通过docker-php-ext-install curl安装，直接进容器手改配置在容器重建后会全部丢失。掌握phpinfo这个诊断入口后，排查PHP扩展问题就有了清晰的路线图：先看模块是否加载，再核对配置文件路径，最后逐一处理依赖与重启，curl无法使用的问题基本都能顺利解决。