yii项目上传失败需先定义@uploadpath别名，再用filehelper::createdirectory()递归创建并设0755权限；linux下还需确保web用户所有权及selinux上下文正确。
在Yii项目中部署文件上传功能时，服务器上缺少预设的上传目录或目录权限不足，会导致mkdir(): Permission denied或failed to open stream: No such file or directory错误，上传直接失败。
确认上传路径别名是否已定义
先检查@uploadPath别名是否已在配置中声明。该别名是后续所有自动创建目录操作的前提，未定义则后续步骤全部无效。
打开/common/config/bootstrap.php，确认存在类似以下行：
Yii::setAlias('@uploadPath', dirname(dirname(__DIR__)) . '/frontend/web/uploads');
若无此行，手动添加并保存。注意路径必须为绝对路径，不能用相对路径或./uploads这类写法——否则FileHelper::createDirectory()会创建到PHP工作目录而非Web根目录下。
使用FileHelper自动创建目录并设权限
在上传逻辑中调用yii\helpers\FileHelper::createDirectory()，它能递归创建多级目录并一次性设置权限。
示例代码（放在UploadForm::upload()方法内）：
$path = Yii::getAlias('@uploadPath') . '/' . date('Ym');<br>FileHelper::createDirectory($path, 0755, true);<br>$this->imageFile->saveAs($path . '/' . $this->imageFile->baseName . '.' . $this->imageFile->extension);
【0755权限必须显式传入】：不传第三个参数true时，仅创建最末级目录；不传第二个参数时，默认权限为0777（过于宽松），而0755对Web服务更安全——目录可读可执行但不可写，防止恶意脚本遍历或覆盖。
验证目录所有权与SELinux状态（Linux生产环境）
即使PHP脚本成功创建了目录，Apache/Nginx进程可能仍无权写入。需分两步排查：
第一步：确认Web服务器用户对目录有写权限。执行：ls -ld $(php -r "echo Yii::getAlias('@uploadPath');")
输出中第三段（如www-data或nginx）必须与ps aux | grep apache或ps aux | grep nginx显示的运行用户一致。
第二步：若服务器启用了SELinux，需额外赋予权限：
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/your-app/frontend/web/uploads(/.*)?"<br>sudo restorecon -Rv /var/www/your-app/frontend/web/uploads
未执行这两步，在CentOS/RHEL系统上即使chmod 0755也依然报错。
避免硬编码路径的两种替代方案
方法一：在params.php中定义动态路径
在/backend/config/params.php中加入：'uploadDir' => '@webroot/uploads/' . date('Y/m'),
然后在控制器中用Yii::getAlias($params['uploadDir'])拼接，再交由FileHelper::createDirectory()处理。
方法二：利用Yii内置的AssetManager管理上传资源
注册自定义asset bundle，将上传目录映射为Web可访问路径，同时通过publish()方法触发自动创建——但此方式仅适用于静态资源，不推荐用于用户上传内容。
