CodeIgniter4中如何授予文件外部访问权限？

阿华AIGC实验室

2026-4-8

哥们，我之前从CI3升级到CI4的时候，也踩过一模一样的坑！用第三方服务访问图片直接报500错误，折腾了半天才搞明白，这俩框架的文件访问规则差得不是一点半点。你这问题大概率是CI4的安全机制和目录结构导致的，我给你捋几个解决办法，都是亲测有效的：

先把文件移到public目录里再说！
CI4为了安全，只把public目录设为Web服务器的可访问根目录，不像CI3那样可能让application目录的文件也暴露出去。如果你的图片之前存在非public的目录（比如旧CI3的application/uploads），第三方服务肯定访问不到，直接移到public下面，比如public/uploads/images/，然后给WebPurify的URL改成你的域名/uploads/images/xxx.jpg，这是最快解决的办法。
检查系统文件权限，别让服务器读不到文件
你用的是Ubuntu LAMP，Web服务器是用www-data用户运行的，所以得确保图片所在的目录和文件权限正确：
- 目录权限设为755（让服务器能进入目录）
- 文件权限设为644（让服务器能读取文件）
  用命令改的话就是这样：
```
chown -R www-data:www-data /var/www/你的项目/public/uploads
chmod -R 755 /var/www/你的项目/public/uploads
chmod -R 644 /var/www/你的项目/public/uploads/*
```
别图省事给777权限，那等于把文件裸奔在网上，安全风险贼大。

要是不想移文件，就用控制器代理访问
有些情况比如文件存在其他存储目录，不想动位置，那可以写个简单的控制器当“中间人”，让第三方服务访问控制器的URL，由控制器返回图片内容：
比如在app/Controllers里新建一个FileProxy.php：

<?php namespace App\Controllers;

use CodeIgniter\Controller;

class FileProxy extends Controller
{
    public function serveImage($filename)
    {
        // 这里替换成你实际的文件存储路径，比如app/uploads/images/
        $filePath = WRITEPATH . 'uploads/images/' . $filename;
        
        // 先检查文件是否存在且可读
        if (!file_exists($filePath) || !is_readable($filePath)) {
            $this->response->setStatusCode(404);
            return '图片不存在或无法访问';
        }
        
        // 设置正确的响应头，让第三方服务识别是图片
        $mimeType = mime_content_type($filePath);
        $this->response->setHeader('Content-Type', $mimeType);
        $this->response->setHeader('Content-Length', filesize($filePath));
        
        // 输出图片内容
        return $this->response->setBody(file_get_contents($filePath));
    }
}

然后在app/Config/Routes.php里加一条路由规则：

$routes->get('image-proxy/(:segment)', 'FileProxy::serveImage/$1');

这样WebPurify就可以访问你的域名/image-proxy/xxx.jpg，由控制器把图片内容返回给它，既安全又不用动原文件的位置。

最后检查public目录下的.htaccess
CI4默认的.htaccess会保护路由，但如果你的.htaccess被改过，可能不小心阻止了静态文件的访问。确保里面有这条规则：
```
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]
```
这条规则的意思是：如果请求的是存在的文件或目录，就直接返回内容，不用走CI4的路由，这样静态图片就能正常被第三方服务访问了。