FlightPHP 文件下载功能实现指南

FlightPHP 作为一个轻量级 PHP 框架，虽然官方文档中没有明确说明文件下载的实现方法，但通过框架提供的响应机制，我们可以优雅地实现文件下载功能。

文件下载的基本实现

在 PHP 中实现文件下载通常需要处理以下几个关键点：

1. 设置正确的 HTTP 头信息
2. 清空输出缓冲区
3. 读取并输出文件内容

在 FlightPHP 中，最简单的实现方式是直接使用 PHP 原生的 readfile() 函数：

// 获取文件路径 $attachment
// 处理相关头信息

ob_end_clean();
flush();

if (!readfile($attachment)) {
    Flight::error(new Exception('无法读取文件 ' . $attachment));
}

更优雅的解决方案

FlightPHP 提供了响应流(Streaming Response)功能，这为文件下载提供了更好的实现方式。通过流式响应，可以更高效地处理大文件下载，避免内存问题。

Flight::route('/download', function() {
    $filePath = '/path/to/your/file.ext';
    
    Flight::response()
        ->header('Content-Type', 'application/octet-stream')
        ->header('Content-Disposition', 'attachment; filename="'.basename($filePath).'"')
        ->header('Content-Length', filesize($filePath))
        ->sendHeaders();
    
    $stream = fopen($filePath, 'r');
    Flight::response()->sendStream($stream);
});

框架集成方案

考虑到文件下载是一个常见需求，最新版本的 FlightPHP 已经集成了文件下载的快捷方法 Flight::file()，使实现更加简洁：

Flight::route('/download', function() {
    $filePath = '/path/to/your/file.ext';
    Flight::file($filePath);
});

这个方法会自动处理所有必要的头信息设置和文件流输出，开发者只需关注业务逻辑即可。

实际应用中的注意事项

1. 文件路径安全：确保文件路径来自可信来源，避免目录遍历攻击
2. 内存管理：对于大文件，始终使用流式处理
3. 权限控制：在下载前验证用户权限
4. 错误处理：妥善处理文件不存在等异常情况
5. 性能考虑：对于频繁下载的场景，考虑使用 CDN 或缓存

通过 FlightPHP 的这些特性，开发者可以轻松实现安全、高效的文件下载功能，满足各种业务场景需求。