Ubuntu PHP如何实现文件下载

在 Ubuntu 系统上使用 PHP 实现文件下载，可以通过多种方法来完成。以下介绍几种常用的方法，并附有示例代码，帮助你轻松实现文件下载功能。

方法一：使用 PHP 的 readfile() 函数

readfile() 是一个简单且高效的函数，适用于直接将文件发送给浏览器进行下载。

示例代码

<?php
// 设置要下载的文件路径
$file = 'path/to/your/file.zip';

// 检查文件是否存在
if (file_exists($file)) {
    // 设置下载时的头信息
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="' . basename($file) . '"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));

    // 清空输出缓冲区
    flush();

    // 读取文件并输出到浏览器
    readfile($file);
    exit;
} else {
    echo "文件不存在。";
}
?>

说明

1. 设置文件路径：将 'path/to/your/file.zip' 替换为你希望用户下载的文件的实际路径。

2. 检查文件是否存在：使用 file_exists() 函数确认文件是否存在，避免出现错误。

3. 设置头信息：

   • Content-Type: 设置为 application/octet-stream 适用于大多数文件类型，浏览器会提示下载。
   • Content-Disposition: 设置为 attachment 并指定文件名，提示用户下载而不是直接打开。
   • 其他头信息如 Expires, Cache-Control, Pragma 等用于控制缓存行为。

4. 输出文件内容：使用 readfile() 函数将文件内容直接输出到浏览器。

方法二：使用 PHP 的 fpassthru() 函数

fpassthru() 函数适用于大文件下载，因为它会将文件直接传递给浏览器，而不需要将整个文件加载到内存中。

示例代码

<?php
$file = 'path/to/your/largefile.zip';

if (file_exists($file)) {
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="' . basename($file) . '"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));

    // 清空输出缓冲区
    flush();

    // 将文件指针传递给浏览器
    fpassthru(fopen($file, 'rb'));
    exit;
} else {
    echo "文件不存在。";
}
?>

说明

与 readfile() 类似，但使用 fpassthru() 可以更好地处理大文件，避免内存消耗过大。

方法三：使用 PHP 的输出缓冲区

对于需要更多控制的场景，可以使用输出缓冲区逐步发送文件内容。

示例代码

<?php
$file = 'path/to/your/file.pdf';

if (file_exists($file)) {
    header('Content-Type: application/pdf');
    header('Content-Disposition: attachment; filename="' . basename($file) . '"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));

    // 清空输出缓冲区
    flush();

    // 打开文件
    $handle = fopen($file, 'rb');
    if ($handle !== false) {
        // 分块读取并输出文件内容
        while (!feof($handle)) {
            echo fread($handle, 8192);
            flush();
            if (connection_status() != 0) {
                fclose($handle);
                exit;
            }
        }
        fclose($handle);
    } else {
        echo "无法打开文件。";
    }
    exit;
} else {
    echo "文件不存在。";
}
?>

说明

这种方法适用于需要在传输过程中进行更多控制的情况，例如监控传输进度、处理大文件等。

方法四：使用 PHP 的 stream_copy_to_stream() 函数（PHP 8.0+）

stream_copy_to_stream() 提供了一种高效的方式来将一个流的内容复制到另一个流，适用于需要流式传输的场景。

示例代码

<?php
$file = 'path/to/your/file.mp4';

if (file_exists($file)) {
    header('Content-Type: video/mp4');
    header('Content-Disposition: attachment; filename="' . basename($file) . '"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));

    // 清空输出缓冲区
    flush();

    // 打开文件流和输出流
    $fileStream = fopen($file, 'rb');
    $outputStream = fopen('php://output', 'wb');

    if ($fileStream && $outputStream) {
        stream_copy_to_stream($fileStream, $outputStream);
        fclose($fileStream);
        fclose($outputStream);
    } else {
        echo "无法传输文件。";
    }
    exit;
} else {
    echo "文件不存在。";
}
?>

说明

这种方法利用了 PHP 的流式处理能力，适合处理大文件和需要流式传输的应用场景。

注意事项

1. 文件路径安全：确保用户无法通过输入参数控制下载的文件路径，以防止目录遍历攻击。可以使用白名单或 realpath() 函数验证文件路径。

   $file = 'path/to/your/files/' . basename($_GET['file']);
   if (!in_array(basename($file), ['file1.zip', 'file2.pdf'])) {
       die("不允许下载该文件。");
   }
   

2. 权限设置：确保 PHP 进程对要下载的文件具有读取权限。

3. 输出缓冲：在使用 readfile()、fpassthru() 等函数前，避免有任何输出（如 echo），否则会导致头信息发送失败。可以使用 ob_end_clean() 或 ob_end_flush() 清空输出缓冲区。

4. 大文件处理：对于大文件，建议使用 fpassthru() 或流式传输方法，以避免内存耗尽的问题。

5. 错误处理：在实际应用中，应添加更多的错误处理机制，如捕获异常、记录日志等，以提高代码的健壮性。

总结

以上介绍了在 Ubuntu 系统上使用 PHP 实现文件下载的几种常用方法。根据具体需求选择合适的方法，并注意安全性和性能方面的考虑。希望这些示例代码和说明对你有所帮助！