curl_exec() 返回 false 须用 curl_errno() 和 curl_error() 查原因，常见错误包括dns解析失败（6）、ssl证书问题（35）、超时（28）；file_get_contents() 报“unable to find the wrapper”是因未启用openssl或allow_url_fopen关闭；guzzle内存暴涨或超时多因未设timeout、未流式处理大响应或未节流并发；post json需显式设置content-type头；高频调用应复用curl句柄或guzzle连接池。
curl_exec() 返回 false 怎么查原因
PHP 里最常踩的坑是 curl_exec() 直接返回 false，但没看错误码就去改业务逻辑。它不抛异常，也不打日志，默认静默失败。
必须搭配 curl_errno() 和 curl_error() 一起用：
$ch = curl_init('https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response === false) {
$errno = curl_errno($ch);
$error = curl_error($ch);
error_log("cURL error {$errno}: {$error}");
}
curl_close($ch);
-
CURLE_COULDNT_RESOLVE_HOST（6）：DNS 解析失败，检查域名拼写或网络连通性 -
CURLE_SSL_CONNECT_ERROR（35）：HTTPS 证书问题，开发环境可加curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)，但线上禁用 -
CURLE_OPERATION_TIMEOUTED（28）：超时，记得设CURLOPT_TIMEOUT（单位秒）和CURLOPT_CONNECTTIMEOUT
file_get_contents() 调用 HTTPS 接口报 “Unable to find the wrapper”
这个错误不是 API 本身的问题，而是 PHP 编译时没启用 openssl 扩展，或者 allow_url_fopen 被关了。
先确认基础配置：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep openssl看是否加载了openssl - 检查
php.ini中allow_url_fopen = On（很多生产环境默认关） -
file_get_contents()不支持 POST、自定义 header 或 cookie，别硬套在需要登录态的场景里
能用 curl 就别强求 file_get_contents()，它只是语法糖，灵活性和错误反馈都差一截。
用 Guzzle 发起请求时内存暴涨或超时
Guzzle 是封装层，但底层还是走 curl 或 stream，不当配置会放大问题。
常见失控点：
- 没设
timeout：默认无限等待，一个卡住的请求就能拖垮整个脚本 - 响应体过大时没流式处理：比如下载文件却用
$response->getBody()->getContents()全读进内存 - 批量请求没节流：100 次并发
Promise可能瞬间打爆连接池或远端限流
安全写法示例：
$client = new \GuzzleHttp\Client([
'timeout' => 5.0,
'connect_timeout' => 3.0,
]);
try {
$res = $client->get('https://api.example.com/data');
} catch (GuzzleHttp\Exception\ConnectException $e) {
// 注意：Guzzle 把 DNS、连接失败归为 ConnectException，超时归为 RequestException
}
POST JSON 数据总被服务端拒收
不是数据写错了，大概率是头没设对。API 要求 Content-Type: application/json，但很多人只写了 json_encode($data)，忘了发 header。
curl 场景下必须显式设置：
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data))curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json'])- 别漏掉
Content-Length：现代 cURL 一般自动算，但旧版本或某些代理下可能需手动加
另外注意：json_encode() 默认不处理中文，中文变 \uXXXX 是正常行为；如果接口要求原始中文，加 JSON_UNESCAPED_UNICODE 参数。
curl_init() + curl_close()，每次都在重建连接。真要高频调用，得复用 $ch 句柄，或者用 Guzzle 的连接池机制。 
