Yii2高级版路径别名问题：如何统一图片存储至前端目录？

这个问题的核心是前后端的@webroot别名指向不同目录：前端的@webroot对应你的public_html（即frontend/web），后端的@webroot对应public_html/admin（即backend/web），直接依赖@webroot定义上传路径自然会出现分叉。下面是具体的解决步骤：

1. 重新配置上传目录别名（固定指向前端目录） #

打开common/config/bootstrap.php，把原来的上传别名改成直接指向前端web目录的绝对路径，摆脱对@webroot的依赖：

// 先定义前端web根目录的固定别名
Yii::setAlias('@frontendWeb', dirname(dirname(__DIR__)) . '/frontend/web');
// 基于前端web目录定义上传目录
Yii::setAlias('@uploads', '@frontendWeb/uploads/images');

这样不管前端还是后端调用@uploads，都会指向同一个路径：public_html/uploads/images。

2. 统一上传逻辑，使用@uploads别名 #

确保创建文件夹、保存文件的代码里，都用Yii::getAlias('@uploads')获取路径，不要用相对路径或@webroot：

$uploadDir = Yii::getAlias('@uploads');
// 递归创建目录（如果不存在）
if (!is_dir($uploadDir)) {
    mkdir($uploadDir, 0755, true);
}

3. 处理后端访问上传文件的URL问题（可选） #

因为后端入口在public_html/admin，如果需要在后端页面展示上传的图片，得让后端能正确访问到public_html/uploads的文件，有两种方式：

• 方式一：配置URL重写规则
  在backend/config/main.php的urlManager组件里添加规则：

'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [
            // 让后端的/uploads/*请求转发到根目录的/uploads
            'uploads/<path:.*>' => '/uploads/<path>',
        ],
    ],
],

之后在后端页面用/uploads/images/xxx.jpg就能直接访问图片。

• 方式二：创建软链接（服务器支持时更简便）
  在public_html/admin目录下执行命令，创建指向上级目录uploads的软链接：

ln -s ../uploads ./admin/uploads

这样后端通过/admin/uploads/images/xxx.jpg也能访问到图片。

额外检查 #

确保前后端.htaccess保持Yii2默认规则，不要修改路径解析逻辑：
前端public_html/.htaccess：

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php

后端public_html/admin/.htaccess：

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php

调整完成后，前后端的上传逻辑都会将文件统一存储到public_html/uploads/images目录下。

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