TP框架实现文件下载（核心解决中文文件名乱码问题）

Content-Disposition: attachment; filename="文档.pdf"

<?php
namespace app\index\controller;
 
use think\Controller;
use think\Response;
 
class Download extends Controller
{
    public function index()
    {
        // 1. 基础配置
        $filePath = realpath('./uploads/中文技术文档.pdf'); // 真实文件绝对路径
        $originalName = basename($filePath); // 原始文件名（含中文）
        
        // 2. 安全校验：文件是否存在
        if (!file_exists($filePath)) {
            return $this->error('文件不存在或已被删除');
        }
 
        // 3. 处理中文文件名：根据浏览器类型编码
        $userAgent = $this->request->header('user-agent');
        $encodedName = $this->encodeFileName($originalName, $userAgent);
 
        // 4. 构造响应
        return Response::create($filePath, 'file')
            ->header([
                'Content-Disposition' => "attachment; filename=\"{$encodedName}\"",
                // 兼容Chrome/Firefox的RFC 5987规范
                'Content-Disposition' => "attachment; filename=\"{$encodedName}\"; filename*=UTF-8''" . rawurlencode($originalName),
                'Content-Type' => mime_content_type($filePath), // 自动获取文件MIME类型
                'Content-Length' => filesize($filePath), // 告诉浏览器文件大小
                'Cache-Control' => 'public, max-age=86400' // 启用浏览器缓存
            ]);
    }
 
    /**
     * 浏览器兼容的文件名编码
     * @param string $fileName 原始中文文件名
     * @param string $userAgent 浏览器UA
     * @return string 编码后的文件名
     */
    private function encodeFileName(string $fileName, string $userAgent): string
    {
        if (strpos($userAgent, 'MSIE') !== false || strpos($userAgent, 'Trident') !== false) {
            // IE/Edge浏览器：转GBK编码
            return iconv('UTF-8', 'GBK//IGNORE', $fileName);
        } else {
            // 其他浏览器：转URL编码
            return rawurlencode($fileName);
        }
    }
}

<?php
namespace app\index\controller;
 
use think\facade\Request;
 
class Download
{
    public function index()
    {
        // 1. 基础配置
        $filePath = app()->getRootPath() . 'public/uploads/中文技术文档.pdf';
        $originalName = basename($filePath);
        
        // 2. 安全校验
        if (!file_exists($filePath)) {
            return json(['code' => 404, 'msg' => '文件不存在']);
        }
 
        // 3. 浏览器兼容编码
        $userAgent = Request::header('user-agent');
        $encodedName = $this->encodeFileName($originalName, $userAgent);
 
        // 4. 返回下载响应（TP6专属助手函数）
        return download($filePath, $encodedName)
            ->header([
                // 兼容所有浏览器的双模式Header
                'Content-Disposition' => "attachment; filename=\"{$encodedName}\"; filename*=UTF-8''" . rawurlencode($originalName),
                'Content-Type' => mime_content_type($filePath),
                'Cache-Control' => 'public, max-age=86400'
            ]);
    }
 
    // 复用TP5.x的encodeFileName方法...
}

<?php
/**
 * 安全下载文件（自动处理中文文件名乱码）
 * @param string $filePath 文件绝对路径
 * @param string|null $customName 自定义下载文件名（默认使用原文件名）
 * @return \think\Response|\think\response\File
 * @throws \Exception
 */
function safe_download(string $filePath, ?string $customName = null)
{
    // 1. 安全校验
    $filePath = realpath($filePath);
    if (!file_exists($filePath)) {
        throw new \Exception('文件不存在');
    }
 
    // 2. 文件名处理
    $originalName = $customName ?? basename($filePath);
    $userAgent = isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : '';
    
    // 3. 浏览器兼容编码
    if (strpos($userAgent, 'MSIE') !== false || strpos($userAgent, 'Trident') !== false) {
        $encodedName = iconv('UTF-8', 'GBK//IGNORE', $originalName);
        $disposition = "attachment; filename=\"{$encodedName}\"";
    } else {
        $encodedName = rawurlencode($originalName);
        $disposition = "attachment; filename=\"{$encodedName}\"; filename*=UTF-8''{$encodedName}";
    }
 
    // 4. 适配TP版本
    if (class_exists('think\\facade\\Response')) {
        // TP6.x
        return \think\facade\Response::file($filePath, $encodedName)
            ->header([
                'Content-Disposition' => $disposition,
                'Content-Type' => mime_content_type($filePath),
                'Cache-Control' => 'public, max-age=86400'
            ]);
    } else {
        // TP5.x
        return \think\Response::create($filePath, 'file')
            ->header([
                'Content-Disposition' => $disposition,
                'Content-Type' => mime_content_type($filePath),
                'Cache-Control' => 'public, max-age=86400'
            ]);
    }
}
 
// 控制器中调用示例
public function download()
{
    try {
        return safe_download('./uploads/中文文档.pdf');
    } catch (\Exception $e) {
        return $this->error($e->getMessage());
    }
}