CodeIgniter4如何获取writable/uploads上传文件路径并在新标签页打开？

首先得明确：WRITEPATH是服务器本地的文件系统路径（比如/var/www/html/writable/uploads/xxx.csv），浏览器根本无法直接访问这个路径，而且直接调用的话服务器会默认返回下载响应头，所以必须通过控制器代理输出的方式实现预览。

下面是具体实现步骤：

1. 添加路由规则 #

打开app/Config/Routes.php，添加一条路由映射文件预览请求：

$routes->get('file-preview/(:any)', 'FileController::preview/$1');

这里的FileController是你要创建的控制器名称，preview是处理预览的方法名，(:any)用来接收文件名参数。

2. 创建文件预览控制器 #

在app/Controllers下新建FileController.php，写入以下代码：

<?php

namespace App\Controllers;

use CodeIgniter\Controller;

class FileController extends Controller
{
    public function preview($fileName)
    {
        // 拼接服务器本地文件路径
        $filePath = WRITEPATH . 'uploads/' . $fileName;
        
        // 验证文件是否存在
        if (!file_exists($filePath)) {
            throw new \CodeIgniter\Exceptions\PageNotFoundException('文件不存在');
        }

        // 获取文件MIME类型，让浏览器识别文件格式
        $mime = mime_content_type($filePath);
        
        // 设置响应头：告知浏览器直接预览而非下载
        return $this->response
            ->setHeader('Content-Type', $mime)
            ->setHeader('Content-Disposition', 'inline; filename="' . $fileName . '"')
            ->setBody(file_get_contents($filePath));
    }
}

核心是把Content-Disposition设为inline，这会让浏览器尝试直接渲染文件内容，而不是触发下载弹窗；同时正确设置Content-Type，确保浏览器能识别文件类型。

3. 页面生成正确的预览链接 #

在你的文件列表页面里，不要直接输出WRITEPATH路径，而是生成指向上述路由的可访问URL，示例代码：

<a href="<?= site_url('file-preview/' . $allList->documentCsv) ?>" target="_blank">查看文件</a>

用site_url()生成浏览器可访问的URL，点击后会触发控制器的预览方法，输出正确的响应内容实现新标签页预览。

额外注意事项 #

• 安全校验：在控制器里可以对文件名做过滤，比如只允许字母、数字、下划线、点号，防止路径遍历攻击（比如用户传入../之类的恶意参数）。
• 大文件处理：如果是大文件，建议用readfile()流式输出替代file_get_contents()，避免内存溢出：

  $this->response
      ->setHeader('Content-Type', $mime)
      ->setHeader('Content-Disposition', 'inline; filename="' . $fileName . '"')
      ->setHeader('Content-Length', filesize($filePath))
      ->send();
  readfile($filePath);
  exit;
  

• Excel文件兼容：部分浏览器本身不支持直接预览Excel文件（.xlsx/.xls），这时候控制器的设置是正确的，能否预览取决于浏览器的插件或在线预览能力。

内容的提问来源于stack exchange，提问作者user19204293