推荐使用 Guzzle HTTP Client 获取 JSON 数据，因其安全易维护；若用原生 cURL，须设置 CURLOPT_RETURNTRANSFER、检查 HTTP 状态码及 JSON 解析错误。
在 Laravel 5 中，不推荐直接使用原生 cURL 函数获取 JSON 数据，而是优先使用更安全、更易维护的 Guzzle HTTP Client（Laravel 5.1+ 默认已集成或可轻松安装）。如果你确实需要底层控制或临时调试，也可以用原生 cURL，但要注意错误处理、编码和 JSON 解析细节。
✅ 推荐方式：使用 Guzzle（Laravel 内置推荐）
Guzzle 是 Laravel 官方推荐的 HTTP 客户端，简洁、支持异步、自动处理 JSON、异常友好。
- 确保已安装 Guzzle：
composer require guzzlehttp/guzzle（Laravel 5.5+ 通常已预装） - 在控制器或服务中使用：
$client = new \GuzzleHttp\Client();
try {
$response = $client->get('https://api.example.com/data', [
'headers' => ['Accept' => 'application/json'],
'timeout' => 10,
]);
$data = json_decode($response->getBody(), true); // 自动转为数组
} catch (\GuzzleHttp\Exception\RequestException $e) {
\Log::error('API 请求失败：', ['error' => $e->getMessage()]);
$data = [];
}
⚠️ 备用方式：原生 cURL（需手动处理细节）
若因特殊原因必须用原生 cURL，请务必设置关键选项，避免乱码、超时或解析失败：
- 设置
CURLOPT_RETURNTRANSFER => true，否则返回bool而非响应体 - 显式设置
CURLOPT_HTTPHEADER包含Accept: application/json - 检查 HTTP 状态码，
curl_getinfo($ch, CURLINFO_HTTP_CODE)不为 200 时不应直接解析 - 调用
json_last_error()验证 JSON 是否有效，防止空响应或 HTML 错误页被误解析
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.example.com/data',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['Accept: application/json'],
CURLOPT_FOLLOWLOCATION => true,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200 && !empty($response)) {
$data = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
\Log::warning('JSON 解析失败', ['raw' => $response]);
$data = null;
}
} else {
\Log::error('HTTP 请求失败', ['code' => $httpCode, 'response' => $response]);
$data = null;
}
? 小技巧：封装成复用方法
把常用逻辑抽成辅助函数或 Service 类，比如 ApiService::getJson($url, $options = [])，统一处理超时、重试、日志和默认 headers，避免各处重复写 cURL 或 Guzzle 配置。
? 注意避开这些坑
- 没设
CURLOPT_SSL_VERIFYPEER => false（仅开发测试用！生产环境必须保持true并配置 CA 证书） - 忽略字符编码：确保 API 返回 UTF-8，必要时用
mb_convert_encoding()转换 - 把
curl_exec()结果直接传给json_decode()，却不检查是否为false（cURL 失败时返回false，会导致json_decode(false)得到null） - 未设置超时，请求卡死导致整个 PHP 进程阻塞
