本文详解 PHP cURL 中 CURLOPT_POSTFIELDS 为 null 的常见原因，重点解决单引号字符串无法解析变量、手动拼接 JSON 导致格式错误等问题，并推荐使用 json_encode() 安全构建请求体。
本文详解 php curl 中 curlopt_postfields 为 null 的常见原因，重点解决单引号字符串无法解析变量、手动拼接 json 导致格式错误等问题，并推荐使用 `json_encode()` 安全构建请求体。
在使用 cURL 发送 POST 请求时，若 CURLOPT_POSTFIELDS 出现 null 或请求体未按预期传递（如 price_amount 字段值为字面量 $amount 而非实际数值），通常源于两个关键问题：字符串插值失效与JSON 构建方式不安全。
❌ 错误写法：单引号字符串 + 手动拼接 JSON
原始代码中：
CURLOPT_POSTFIELDS =>'{
"price_amount": $amount,
"price_currency": "usd",
"pay_currency": "btc"
}',
由于 PHP 单引号字符串不会解析变量，$amount 被当作纯文本处理，最终发送的 JSON 实际为：
{"price_amount": "$amount", "price_currency": "usd", "pay_currency": "btc"}
若 $amount 本身为空或未定义，json_encode() 后可能进一步导致 null 值，服务端解析失败，返回异常响应（如 400 Bad Request 或字段缺失）。
✅ 正确做法：使用 json_encode() 动态构建请求体
应先构造关联数组，再交由 json_encode() 序列化——它自动处理类型转换、转义与格式校验，杜绝语法错误：
<?php $api = $_GET['api'] ?? '';
$amount = $_GET['amount'] ?? null;
// 强制类型校验与默认值保护（关键！）
if (!is_numeric($amount) || $amount <= 0) {
http_response_code(400);
echo json_encode(['error' => 'Invalid or missing amount'], JSON_UNESCAPED_UNICODE);
exit;
}
// 构建数据结构（清晰、可维护、类型安全）
$data = [
'price_amount' => (float) $amount, // 显式转为浮点数，避免整型截断
'price_currency' => 'usd',
'pay_currency' => 'btc'
];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.googl.com',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode($data), // ✅ 自动序列化为合法 JSON
CURLOPT_HTTPHEADER => [
'x-api-key: ' . $api,
'Content-Type: application/json',
'Accept: application/json'
]
]);
$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
// 响应处理：检查 HTTP 状态码与 JSON 有效性
header('Content-Type: application/json; charset=utf-8');
if ($response === false || $httpCode >= 400) {
echo json_encode([
'error' => 'API request failed',
'http_code' => $httpCode,
'raw_response' => $response
], JSON_PRETTY_PRINT);
} else {
echo json_encode(json_decode($response, true), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
}
?>
⚠️ 关键注意事项
- 输入验证不可省略：$_GET['amount'] 可能为空、非数字或恶意字符串，务必校验并设置默认值；
- json_encode() 返回 false 时需捕获：若 $data 包含不可序列化类型（如资源、闭包），json_encode() 返回 null，应添加 if (json_last_error() !== JSON_ERROR_NONE) 检查；
- Header 严格匹配：Content-Type: application/json 必须与 CURLOPT_POSTFIELDS 数据格式一致，否则服务端可能拒绝解析；
- 避免敏感信息泄露：示例中直接暴露 x-api-key 在 URL 参数中存在安全风险，生产环境应改用请求头认证或后端密钥管理。
通过结构化数据 + json_encode()，不仅彻底规避变量解析失败问题，更提升代码健壮性、可读性与安全性。
