在coolify中调整laravel项目的上传文件大小,核心在于同时修改web服务器(nginx)的`client_max_body_size`限制和php的`upload_max_filesize`及`post_max_size`配置。coolify通过环境变量注入配置,因此只需在coolify的项目设置中更新`nginx_upload_limit`、`upload_max_filesize`和`post_max_size`这三个变量并重新部署即可生效。

Coolify如何管理Nginx上传限制
Coolify使用`NGINX_UPLOAD_LIMIT`环境变量来控制Nginx允许的最大请求体大小。该值直接映射到Nginx配置中的`client_max_body_size`指令。如果此值设置过小,即使PHP配置了更大的上传限制,Nginx也会在请求到达PHP之前拦截大文件并返回413错误。

server {
listen 80;
server_name _;
# Coolify 自动生成的 Nginx 配置片段
# NGINX_UPLOAD_LIMIT=50M
client_max_body_size 50M;
location / {
proxy_pass http://php-fpm:9000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}当你在Coolify界面中将`NGINX_UPLOAD_LIMIT`设置为`50M`时,Coolify会重新生成Nginx配置并重启服务。此时,Nginx将允许最大50MB的请求体。若未设置此变量,Coolify通常默认为`10M`或根据基础镜像设定。开发者需确保此值大于或等于PHP层面的限制,否则上传将在Nginx层被阻断。
PHP层面上传参数的配置方法
Laravel运行在PHP之上,PHP自身有`upload_max_filesize`和`post_max_size`两个关键参数限制文件上传和POST数据的大小。`upload_max_filesize`限制单个文件的大小,而`post_max_size`限制整个POST请求体的大小,后者必须大于前者。在Coolify中,这两个值分别由`UPLOAD_MAX_FILESIZE`和`POST_MAX_SIZE`环境变量控制。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。

; PHP 配置文件片段 (php.ini) ; UPLOAD_MAX_FILESIZE=50M upload_max_filesize = 50M ; POST_MAX_SIZE=55M post_max_size = 55M ; 注意:file_uploads 必须为 On file_uploads = On
在Coolify的项目设置中,找到对应的环境变量输入框。将`UPLOAD_MAX_FILESIZE`设为你希望允许的单文件最大大小(如`50M`),将`POST_MAX_SIZE`设为稍大的值(如`55M`)。保存后,Coolify会重建容器并应用新的PHP配置。Laravel应用重启后,`ini_get('upload_max_filesize')`将返回新设定的值。务必保持`post_max_size` > `upload_max_filesize`,否则即使文件小于`upload_max_filesize`,若包含其他POST数据导致总和超限,仍会失败。
验证配置生效与常见报错排查
修改配置后,最直接的方法是尝试上传一个略小于设定值的文件。如果上传成功,说明配置已生效。如果失败,需检查具体错误信息。若收到HTTP 413 Payload Too Large,通常是Nginx的`NGINX_UPLOAD_LIMIT`未正确更新或未重新部署。若收到PHP警告“File to upload is larger than the maximum allowed size”,则是`UPLOAD_MAX_FILESIZE`设置过小。若收到“The post data exceeded max_allowed_packet”或类似PHP内部错误,可能是`POST_MAX_SIZE`小于`upload_max_filesize`或总POST数据过大。
此外,Laravel本身没有额外的上传大小限制,它依赖底层PHP和Web服务器。因此,确保这三个变量(Nginx、Upload Max、Post Max)协调一致是关键。建议在Coolify中统一规划这些值,例如都设为`100M`,以简化维护。对于大型文件上传,还需考虑PHP的`max_execution_time`,确保脚本执行时间足够长以完成上传处理。

















