必须显式设置curlopt_url并调用curl_exec(),否则静默失败返回false;需设curlopt_returntransfer=true获取响应体;用完必须curl_close()防文件描述符耗尽;https需处理ssl验证。

curl_init() 创建句柄后必须设置 CURLOPT_URL
不设 CURLOPT_URL 就调用 curl_exec(),PHP 会静默失败并返回 false,且 curl_error() 为空——这是新手最常卡住的地方。
正确流程是:先 curl_init() 得到句柄,紧接着用 curl_setopt($ch, CURLOPT_URL, 'https://example.com') 显式指定目标地址。
- URL 必须带协议(
http://或https://),否则 cURL 不识别 - 如果 URL 含中文或特殊字符,务必先用
urlencode()处理参数部分,不要直接拼接 - 开发时建议始终开启
CURLOPT_FAILONERROR,避免 4xx/5xx 状态码被当成成功返回
必须显式调用 curl_exec() 才真正发请求
curl_init() 和 curl_setopt() 都只是配置,不发包;漏掉 curl_exec() 就等于写了 SQL 却没执行 query()——变量里啥也没有。
常见错误写法:$ch = curl_init(); curl_setopt(...); // 忘了 curl_exec(),结果 $result 是 null 或未定义。
立即学习“PHP免费学习笔记(深入)”;
-
curl_exec()返回false表示传输层失败(如 DNS 解析失败、连接超时),不是 HTTP 状态码问题 - 想拿到响应体,得提前设
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true),否则默认直接输出到屏幕 - 调试时可加
curl_setopt($ch, CURLOPT_HEADER, true)查看完整响应头
用完必须 curl_close(),尤其在循环或长生命周期脚本中
不关句柄会导致 PHP 进程持续占用 socket 连接,高并发下很快耗尽系统文件描述符(报错 Too many open files)。
即使 curl_exec() 报错或异常退出,也要确保 curl_close() 被执行——推荐用 try/finally 包裹:
try {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
} finally {
if (isset($ch)) curl_close($ch);
}
- PHP 7.4+ 支持资源自动销毁,但依赖 GC 不够可靠,手动关仍是底线操作
- 在 CLI 脚本或队列任务中,忘记关闭可能引发后续请求全部卡住
- 若需复用句柄(如批量请求同一域名),可用
curl_setopt_array()重置参数,而非反复 init/close
HTTPS 请求要小心 SSL 验证和 CA 证书路径
直接请求 HTTPS 地址时,cURL 默认校验服务器证书。若目标站证书异常(自签、过期、域名不匹配),curl_exec() 会返回 false,curl_error() 提示 SSL certificate problem。
- 临时调试可关验证:
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false),但线上环境严禁使用 - 生产环境应指定 CA 证书路径:
curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem') - Linux 系统通常可设
CURLOPT_CAPATH指向/etc/ssl/certs目录 - Windows 下 PHP 自带的
php_curl.dll可能缺少根证书,需单独下载curl-ca-bundle.crt
CURLOPT_RETURNTRANSFER 却试图把 curl_exec() 结果赋值给变量,或者以为 curl_setopt() 设完就自动执行了。这些点不踩一遍,很难信。











