PHP使用ZipArchive展示多PDF失败：加载PDF文档错误解决

我之前也碰到过类似的PDF加载失败问题，大概率是输出时的二进制内容被干扰了，或者路径、header设置出了问题。先看看你的代码里可能踩的坑：

问题分析 #

你遇到的“Failed to load PDF Document”通常是这几个原因：

• 输出PDF之前有残留的字符（比如空格、BOM头、echo的调试信息），破坏了PDF的二进制结构
• Content-Length设置错误，导致浏览器接收的文件大小和实际不符
• ZipArchive提取后的PDF路径错误，或者文件本身损坏
• 脚本输出PDF后没有终止，后续代码输出了额外内容

修正后的代码示例 #

我把你的代码补全并做了关键修改，你可以参考：

<?php
// 先设置字符编码，注意不要有空格在<?php前面！
header('Content-type: text/html; charset=utf-8');

// 强制清理所有输出缓冲区，避免残留内容干扰PDF
ob_clean();
flush();

$requestUri = $_SERVER['REQUEST_URI'];
$pdfFileName = substr($requestUri, strrpos($requestUri, '/') + 1);
$pdfPath = '//dsbimrj16/Vinculacao_Cadastro_Gestor/' . $pdfFileName . '.pdf';

if (file_exists($pdfPath) && is_file($pdfPath)) {
    // 输出单个PDF的逻辑
    header('Content-type: application/pdf');
    // 用basename只取文件名，不要带完整路径
    header('Content-Disposition: inline; filename="' . basename($pdfPath) . '"');
    header('Content-Transfer-Encoding: binary');
    header('Content-Length: ' . filesize($pdfPath));
    header('Accept-Ranges: bytes');
    
    // 再次清理缓冲区，确保没有残留
    ob_clean();
    flush();
    readfile($pdfPath);
    // 输出后立即终止脚本，防止后续代码输出内容
    exit;
} else {
    // 处理ZIP文件夹的逻辑
    function folder_exist($folder) {
        $path = realpath($folder);
        return ($path !== false && is_dir($path)) ? $path : false;
    }

    chdir('//dsbimrj16/Vinculacao_Cadastro_Gestor/');
    
    // 简化路径提取，减少嵌套substr出错的概率
    $pPos = strpos($requestUri, 'p/') + 2;
    $folderEndPos = strpos($requestUri, '/', $pPos);
    $folderName = substr($requestUri, $pPos, $folderEndPos - $pPos);
    $folder = '/' . $folderName . '/';

    if (FALSE !== ($path = folder_exist($folder))) {
        // 遍历文件夹中的PDF文件
        $pdfFiles = glob($path . '/*.pdf');
        if (!empty($pdfFiles)) {
            // 假设你要输出第二个PDF，这里可以根据实际请求调整
            $targetPdf = $pdfFiles[1];
            if (file_exists($targetPdf) && is_file($targetPdf)) {
                // 输出PDF的标准header设置
                header('Content-type: application/pdf');
                header('Content-Disposition: inline; filename="' . basename($targetPdf) . '"');
                header('Content-Transfer-Encoding: binary');
                header('Content-Length: ' . filesize($targetPdf));
                header('Accept-Ranges: bytes');
                
                ob_clean();
                flush();
                readfile($targetPdf);
                exit;
            } else {
                echo "目标PDF文件不存在或损坏";
            }
        } else {
            echo "文件夹中没有PDF文件";
        }
    } else {
        echo "指定的文件夹不存在";
    }
}
?>

关键修改点说明 #

1. 清理输出缓冲区：在输出PDF前后都调用ob_clean()和flush()，确保没有任何残留的字符（包括<?php前面的空格、BOM）破坏PDF的二进制数据
2. 修正文件名和路径：用basename()处理下载文件名，避免把完整路径传给浏览器；简化路径提取逻辑，减少嵌套substr导致的错误
3. 脚本终止：输出PDF后立即调用exit，防止后续代码（比如PHP的闭合标签后的空格）输出额外内容
4. 增加存在性检查：在读取PDF之前，再次确认文件存在且是正常文件，避免读取损坏或不存在的文件

额外排查建议 #

• 手动打开Zip提取后的PDF文件，确认文件本身没有损坏
• 检查服务器对共享路径//dsbimrj16/Vinculacao_Cadastro_Gestor/是否有足够的读写权限
• 开启PHP错误提示（添加error_reporting(E_ALL); ini_set('display_errors', 1);），查看是否有隐藏的路径或权限错误
• 确认PHP的zip扩展已经启用，ZipArchive可以正常工作

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