PHP下载文件的几种方案

在Web开发中，文件下载是比较常见的功能。本文将介绍PHP中实现文件下载的几种方案，适用于不同的场景。

直接链接下载

直接链接下载是最简单的方式，只需要在前端使用标签指向指定URL即可完成下载。

如下代码展示了一个简单的PHP下载页面，底下的链接指向指定文件的URL地址。

<?php 
$file = '文件名.pdf';
$file_path = './download/' . $file;
if (file_exists($file_path)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename='.basename($file_path));
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file_path));
    readfile($file_path);
    exit;
} else {
    echo "文件不存在";
}
?>
<a href="download.php?file=文件名.pdf">下载文件</a>

值得注意的是，在下载时需要使用header()函数设置Content-Disposition头并指定附件的名字，否则可能会导致浏览器无法正常下载文件。

该方式最大的优点是实现简单、适用范围广，但也存在一些不足：由于需要在前端进行URL跳转，因此它不能灵活地与后端业务逻辑配合，不能实现文件权限控制、下载次数限制等功能。

通过PHP流式下载

流式下载是PHP下载文件常用的方式之一，它可以直接向浏览器返回数据流，适用于处理大文件、限制下载速度等场景。

以下是通过PHP实现流式下载文件的示例代码：

<?php
$file = '文件名.pdf';
$file_path = './download/' . $file;
if (file_exists($file_path)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename='.basename($file_path));
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file_path));
    ob_clean();
    flush();
    $handle = fopen($file_path, "rb");
    while (!feof($handle)) {
        echo fread($handle, 8192);
        flush();
    }
    fclose($handle);
    exit;
} else {
    echo "文件不存在";
}
?>
<a href="download.php?file=文件名.pdf">下载文件</a>

代码中，我们先打开文件，然后通过while循环不断以8192字节为单位读取文件，将读取的数据直接输出到浏览器端，从而实现了下载。

该方式适合处理大文件下载，可以限制下载速度，但因为输出交给了PHP处理，可能导致服务器占用过高的情况。

借助第三方插件实现下载

除了上述两种方式外，我们还可以通过借助第三方插件来实现文件下载。其中，比较流行的插件有PHP的PEAR库中的HTTP_Download，或者是开源项目Symfony HttpFoundation组件的BinaryFileResponse。

在使用PEAR库HTTP_Download时，示例代码如下：

<?php
require_once 'HTTP/Download.php';
$file = '文件名.pdf';
$file_path = './download/' . $file;
if (file_exists($file_path)) {
    $mime = 'application/octet-stream';
    $data = file_get_contents($file_path);
    $download = new HTTP_Download($data, $file, $mime);
    $download->send();
    exit;
} else {
    echo "文件不存在";
}
?>
<a href="download.php?file=文件名.pdf">下载文件</a>

而通过Symfony HttpFoundation组件则可以使用如下代码：

<?php
use Symfony\Component\HttpFoundation\BinaryFileResponse;
$file = '文件名.pdf';
$file_path = './download/' . $file;
if (file_exists($file_path)) {
    $response = new BinaryFileResponse($file_path);
    return $response->setContentDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, $file);
} else {
    echo "文件不存在";
}
?>
<a href="download.php?file=文件名.pdf">下载文件</a>

这种方式相比前两者而言，由于使用了第三方插件，因此代码量更少，扩展性更好。缺点则是需要事先安装插件库。

结语

本文介绍了PHP下载文件的几种方式，并讲解了它们分别适用的场景，希望能对读者有所帮助。