PHP如何将Google Cloud Storage文件流直接输出而不损坏图片

核心原因 #

你遇到的图片损坏问题主要是三个原因导致的：

• PHP默认开启的输出缓冲中存在提前输出的空格、换行等额外字符，污染了图片二进制内容
• GCS返回的流指针可能不在起始位置，导致只输出了部分内容
• 输出流后没有立即终止执行，后续逻辑的额外输出破坏了图片格式

正确实现代码 #

$storage = new Google\Cloud\Storage\StorageClient();
$bucket = $storage->bucket($bucketName);
$thumb = $bucket->object("thumb/Thumb-".$basename."-".$path[2].".jpg");
if ($thumb->exists()) {
    $size = $thumb->info()['size'];
    // 清空所有已有的输出缓冲，移除额外字符
    ob_end_clean();
    // 开启隐式刷出，流内容直接输出到响应无需手动flush
    ob_implicit_flush(true);

    header("Content-Type: image/jpeg");
    header("Content-Length: $size");

    $gcsStream = $thumb->downloadAsStream();
    // 重置流指针到起始位置
    rewind($gcsStream);
    // 输出流全部内容
    fpassthru($gcsStream);
    // 关闭流释放资源
    fclose($gcsStream);
    exit;
}

验证排查点 #

如果修改后仍有问题，可以先临时注释Content-Length头，观察返回的响应大小和实际文件大小是否一致，确认是否存在额外输出。

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