PHP调用API时如何动态计算Content-Length？

嘿，这个问题我之前也踩过坑——手动硬写或者提前估算Content-Length很容易因为动态内容变化、编码问题导致请求失败。给你两种解决方案，优先选第一种，省心又靠谱：

方案一：让PHP自动处理（推荐） #

其实PHP的stream_context_create在处理POST请求时，如果你已经提供了完整的body内容，它会自动计算并添加Content-Length请求头，完全不需要你手动设置。这是最安全的方式，能避免所有手动计算可能出现的错误。

比如你的代码可以改成这样：

// 先组装好所有动态的请求体内容
$bodyContent = "FirstNa=" . urlencode($firstName);
// 动态添加额外内容
if (!empty($lastName)) {
    $bodyContent .= "&LastName=" . urlencode($lastName);
}
// 还可以继续添加其他动态字段
if ($needExtraData) {
    $bodyContent .= "&ExtraInfo=" . urlencode($extraValue);
}

$opts = [
    "http" => [
        "method" => "POST",
        "header" => "Header1: xxx\r\nHeader2: xxx\r\n",
        "body" => $bodyContent
    ]
];

$context = stream_context_create($opts);
$response = file_get_contents('https://your-api-url.com', false, $context);

只要你把最终的请求体完整传给body参数，PHP就会自动帮你计算字节长度并添加Content-Length头，完全不用操心动态内容的变化。

方案二：手动计算（仅用于特殊场景） #

如果因为某些特殊需求（比如自定义流处理、必须精确控制请求头），你必须手动设置Content-Length，那核心原则是：先组装好完整的最终请求体，再计算它的字节长度。

注意：Content-Length统计的是字节数，不是字符数，所以要确保计算的是字节长度：

// 第一步：组装完整的请求体（包括所有动态内容）
$bodyData = [
    'firstName' => $firstName,
    'lastName' => $lastName
];
if ($hasExtra) {
    $bodyData['extraField'] = $extraValue;
}
// 如果是JSON格式的请求体
$bodyContent = json_encode($bodyData);

// 第二步：计算字节长度
// 方法1：用strlen()，它在PHP中返回的就是字符串的字节数
$contentLength = strlen($bodyContent);
// 方法2：用mb_strlen明确指定按字节计算，更直观
// $contentLength = mb_strlen($bodyContent, '8bit');

// 第三步：把计算好的长度放到请求头里
$opts = [
    "http" => [
        "method" => "POST",
        "header" => "Header1: xxx\r\nHeader2: xxx\r\nContent-Length: {$contentLength}\r\n",
        "body" => $bodyContent
    ]
];

$context = stream_context_create($opts);
$response = file_get_contents('https://your-api-url.com', false, $context);

几个关键注意点 #

• 绝对不要先设置Content-Length再修改请求体，这样长度和实际内容会不匹配，直接导致请求失败。
• 如果请求体是二进制数据（比如文件内容），先把二进制内容读到变量里，再用strlen()计算长度；如果是本地文件，也可以用filesize()获取字节数，但要确保文件没有被修改。
• 对于UTF-8编码的字符串，strlen()会正确计算字节数（比如中文每个字符占3字节），不用担心字符和字节的差异。

内容的提问来源于stack exchange，提问作者Pikapops