通过PHP实现PDF文件下载的完整教程-php教程-PHP中文网

通过PHP实现PDF文件下载的完整教程

聖光之護

发布： 2025-10-24 12:55:00

原创

583人浏览过

通过php实现pdf文件下载的完整教程

本文旨在提供一个清晰、简洁的PHP教程，指导开发者如何通过PHP代码实现PDF文件的下载功能。我们将深入探讨如何正确设置HTTP头部信息，以及如何避免常见错误，确保用户能够成功下载并打开PDF文件。本文将提供示例代码，并着重强调在实现过程中需要注意的关键点。

在Web开发中，实现文件下载功能是一项常见的需求。对于PDF文件，通常需要通过PHP设置正确的HTTP头部信息，才能强制浏览器进行下载，而不是直接在浏览器中打开。以下将详细介绍如何使用PHP实现PDF文件的下载。

核心原理：HTTP头部信息设置

实现PDF下载的关键在于设置正确的HTTP头部信息。Content-Type 头部告诉浏览器文件的MIME类型，Content-Disposition 头部则指示浏览器以附件形式处理文件，并设置下载的文件名。

立即学习“PHP免费学习笔记（深入）”；

PHP实现代码示例

以下是一个基本的PHP代码示例，用于实现PDF文件的下载：

巧文书

巧文书是一款AI写标书、AI写方案的产品。通过自研的先进AI大模型，精准解析招标文件，智能生成投标内容。

查看详情

<?php

// 假设 $pdfData 包含PDF文件的二进制数据
// 假设 $fileName 是你想要用户下载时看到的文件名，例如 "example.pdf"

// 设置HTTP头部信息
header("Content-Type: application/pdf");
header('Content-Disposition: attachment; filename="' . basename($fileName) . '"');
header("Content-Transfer-Encoding: binary");
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Content-Length: ' . strlen($pdfData)); // 可选，但建议设置

// 输出PDF数据
echo $pdfData;

exit; // 确保脚本在此处停止执行，防止输出其他内容
?>

登录后复制

代码解释：

header("Content-Type: application/pdf");：设置MIME类型为application/pdf，告诉浏览器这是一个PDF文件。
header('Content-Disposition: attachment; filename="' . basename($fileName) . '"');：设置下载的文件名。attachment 表示强制下载，basename() 函数用于提取文件名，防止路径注入攻击。
header("Content-Transfer-Encoding: binary");：声明传输编码为二进制，确保PDF数据正确传输。
header('Expires: 0');，header('Cache-Control: must-revalidate');，header('Pragma: public');：设置缓存控制，防止浏览器缓存。
header('Content-Length: ' . strlen($pdfData));：可选，但建议设置。告诉浏览器文件的大小，有助于显示下载进度。
echo $pdfData;：输出PDF文件的二进制数据。
exit;：确保脚本在此处停止执行，防止输出其他内容干扰下载。

更完善的示例 (从文件读取)

如果PDF文件已经存在于服务器上，可以使用 readfile() 函数直接读取并输出：

<?php

$filePath = '/path/to/your/file.pdf'; // PDF文件的完整路径
$fileName = 'downloaded_file.pdf'; // 下载时显示的文件名

if (file_exists($filePath)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/pdf');
    header('Content-Disposition: attachment; filename="' . basename($fileName) . '"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($filePath));
    readfile($filePath);
    exit;
} else {
    // 文件不存在的处理
    header("HTTP/1.0 404 Not Found");
    echo "文件未找到";
    exit;
}

?>

登录后复制

注意事项：

确保PDF数据正确生成或读取： 如果PDF数据来自外部库（例如Dompdf），请确保数据生成正确，并且没有错误信息混入。
处理文件不存在的情况： 如果PDF文件不存在，应该返回404错误，并显示相应的错误信息。
避免输出其他内容： 在调用 header() 函数之前，不能有任何输出（包括空格、换行符等）。否则，header() 函数调用会失败，导致下载失败。
文件名编码： 如果文件名包含中文或其他特殊字符，可能需要进行URL编码，以确保浏览器正确识别。可以使用 rawurlencode() 函数进行编码。
安全考虑： 始终对用户输入的文件名进行验证和过滤，防止路径注入攻击。使用 basename() 函数可以有效防止此类攻击。
临时文件处理： 如果需要先将PDF写入临时文件，再进行下载，务必在使用完毕后删除临时文件，避免占用服务器资源。可以使用 unlink() 函数删除文件。