yii文件上传失败主因是php底层配置与yii运行时限制双重限制；需先通过phpinfo()查upload_max_filesize、post_max_size等实际值，再同步调整php.ini和yii模型rules中的maxsize（字节），超大文件应改用put流式上传并校验magic number。
Yii框架文件上传失败、报500或413错误，往往不是代码写错了，而是PHP底层配置和Yii运行时限制双重卡死——比如你设了20MB上传限制，但php.ini里upload_max_filesize还是2M，请求根本到不了Yii控制器。
查清当前PHP实际生效的上传限制
新建一个临时PHP文件（如phpinfo.php），放入Web根目录，内容为<?php phpinfo(); ?>，用浏览器访问它。
在页面中搜索upload_max_filesize、post_max_size、max_input_time、memory_limit四项，记下它们的值。注意：post_max_size必须 ≥ upload_max_filesize，否则即使文件没超限，整个POST请求也会被截断。
【关键前提】如果这四项里任意一项显示no value或远小于你预期（如2M），说明限制就在这里，Yii层的验证还没开始跑就已经被PHP拦下了。
调整PHP配置（需服务器权限）
编辑php.ini文件，修改以下四行（单位统一用M）：
upload_max_filesize = 64M
post_max_size = 72M（必须比upload_max_filesize大，留出表单字段开销）
max_input_time = 300（上传大文件时防止超时中断）
memory_limit = 256M（Yii加载模型、验证器、日志等会吃内存，别设成-1）
改完后重启PHP服务（FPM模式执行sudo systemctl restart php-fpm，Apache模式执行sudo systemctl restart apache2）。【不可逆操作】改错php.ini可能导致整个站点500，建议先备份原文件。
Yii模型层设置上传大小上限
在你的上传模型（如UploadForm.php）的rules()方法中，给file验证器加上maxSize：
[['imageFile'], 'file', 'maxSize' => 67108864, 'tooLarge' => '文件不能超过64MB，请压缩后再上传']
注意：这里的数值单位是字节，64MB = 64 × 1024 × 1024 = 67108864。不要写成'64M'，Yii不识别字符串单位。
这个限制是Yii运行时校验，仅当PHP层已放行请求后才生效。它不会阻止超限请求到达服务器，但能返回友好的中文提示。
绕过$_FILES处理超大文件（PUT流式上传）
当文件超过100MB或需稳定上传时，必须放弃传统multipart/form-data方式，改用原始二进制流上传。
方法一：前端用fetch发送PUT请求
fetch('/api/v1/upload', { method: 'PUT', body: fileBlob })
方法二：后端控制器禁用multipart解析器
在对应Controller的behaviors()中加入：'parsers' => ['application/octet-stream' => 'yii\web\BinaryParser']，或直接在config/web.php里全局移除multipart/form-data解析器，避免Yii提前解析空的$_FILES。
方法三：用php://input流式写入
在action中打开输入流：$input = fopen('php://input', 'rb');
创建目标文件句柄：$output = fopen($targetPath, 'wb');
分块读写（每次8KB）：while (!feof($input)) { fwrite($output, fread($input, 8192)); }
关闭句柄：fclose($input); fclose($output);
这一步不经过$_FILES，完全绕开PHP上传限制，但【必须自行校验文件头magic number】，否则可能把恶意payload当普通文件存下来。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
