三个思路解决laravel上传文件报错:413 Request Entity Too Large问题
上传图片的时候,是用laravel自带的上传图片的方法,一下气上传了20张,结果就无情报错:413 Request Entity Too Large,后面查一下,这个报错信息是nginx报的错误,不是php报的错误。也就是说在上传图片的时候被nginx拦截了。
最近一个项目当中,要求上传图片,并且限制图片大小,虽然在laravel当中已经添加了相关的表单验证来阻止文件过大的上传,然而当提交表单时,还没轮到laravel处理,nginx就先报错了。当你仔细看报错页面时,你会发现有nginx版本信息,经过分析,这报错是因为nginx的默认上传文件大小配置client_max_body_size只有2MB, 基于nginx验证比laravel验证要早,想要友好报错而不是直接显示413 Request Entity Too Large,那么就有三个思路去解决。
思路一:修改nginx配置
这是最简单的一个做法,着报错原因是nginx不允许上传配置过大的文件,那么件把nginx的上传大小配置调高就好。
1、打开nginx主配置文件nginx.conf,一般在/usr/local/nginx/conf/nginx.conf这个位置,找到http{}段并修改以下内容:
client_max_body_size 2m;
当中的2m修改成你需要的允许文件大小。
2、修改后,测试nginx配置是否正确
/usr/local/nginx/sbin/nginx -t
3、测试配置正确后,重启nginx使配置生效
/etc/init.d/nginx restart
注意:要是以php运行的话,这个大小client_max_body_size要和php.ini中的如下值的最大值差不多或者稍大,这样就不会因为提交数据大小不一致出现错误。
post_max_size = 2M
upload_max_filesize = 2M
当中的2m修改成你需要的允许文件大小。把当中的2m修改成你第一步设置的大小。
思路二:修改添加友好报错页面
思路一虽然简单,但是不一定能过项目测试那一关,项目测试就要求不要看到413 Request Entity Too Large这样显示错误,所以我们只好添加友好报错页面咯。
1、编辑一个简单的htm作为静态友好页面
(注意html文件乱码请用<meta http-equiv="Content-Type" content="text/html; charset=utf-8">)
2、更改nginx.conf在http定义区域加入:
fastcgi_intercept_errors on;
3、nginx的网站conf配置中的server 定义区域加入:
error_page 413 /413.htm;
(注意此处413与/413.htm之间不要用等号,否则返回状态码为200而不是413,同时尽量不要 http://www.xxx.com/404.html出错则会跳过该页面)
4、测试nginx配置是否正确
/usr/local/nginx/sbin/nginx -t
5、如果上一步成功重启nginx
/etc/init.d/nginx restart
思路三:表单提交之前先用JS判断并且阻止表单提交
思路二虽然比思路一有进步了一些,但是提醒还是跳转页面了,这样的用户体验并不会好到哪里去,所以最终想到了思路三。上文已经说过,这413报错是来自后端nginx的,nginx的判断虽然比PHP还要早,但是我们可以直接从前端处理呀!想到这里,实现并不难了。可以添加文件上传事件判断,如果文件超过限制的大小,那么就弹出警告框并让提交按钮失效,如果文件没有超过限制大小,就提示大小合适,并且把之前的按钮失效状态取消掉。
简单的HTML代码:
- <form action="" method="post" enctype="multipart/form-data">
- <div class="form-group">
- <label for="picture">文章展示图片(800KB内):</label>
- <input name="picture" type="file"/>
- </div>
- <button type="submit" class="am-btn am-btn-success"><span class="am-icon-send"></span>
- 发布
- </button>
- </p>
- </form>
JS代码:
- $('#picture').bind('change', function () {
- if (this.files[0].size / 1024 / 1024 > 0.8){
- value = this.files[0].size/1024;
- alert('该文件大小是 ' + value .toFixed(0) + "KB,已超过大小限制,请修改!");
- document.getElementById("submit").disabled=true;
- document.getElementById("submit").innerHTML='非法图片内容';
- }else{
- alert('该文件可以提交!');
- document.getElementById("submit").disabled=false;
- document.getElementById("submit").innerHTML='提交';
- }
- });
总结:其实三个思路是按照时间顺序来写的,在实际项目中最终的功能实现也是更新换代才有了最后的结果。不过当有这样类似的经验,下次遇到这样的弯路就省掉,同时会让自己的处理问题的方式更加成熟。