PHP文件上传失败主因是服务器限制与权限问题：一、调高php.ini中upload_max_filesize和post_max_size并重启服务；二、确保上传目录有写权限且属PHP运行用户；三、检查框架验证规则与中间件；四、调整Nginx的client_max_body_size或Apache的LimitRequestBody；五、确认系统临时目录可写且磁盘空间充足。
如果您在使用PHP框架上传文件时遇到失败，常见原因包括服务器端的文件大小限制设置过低或上传路径缺乏写入权限。以下是针对这两个核心问题的排查与修复步骤：
一、检查并调整PHP配置中的文件大小限制
PHP默认对上传文件的大小设置了多重限制，包括单个文件最大尺寸（upload_max_filesize）和整个POST请求数据总量（post_max_size），二者均需满足上传需求。
1、定位当前PHP配置文件php.ini的位置，可通过执行php --ini或在Web环境中创建临时PHP文件输出phpinfo()确认。
2、用文本编辑器打开php.ini文件，查找upload_max_filesize参数，将其修改为期望值，例如：upload_max_filesize = 50M。
立即学习“PHP免费学习笔记（深入）”；
3、同步修改post_max_size参数，该值必须大于或等于upload_max_filesize，例如：post_max_size = 55M。
4、若使用Apache，确保修改后重启服务；若使用Nginx + PHP-FPM，需重启php-fpm进程及Nginx服务。
5、验证修改是否生效：在Web脚本中调用ini_get('upload_max_filesize')和ini_get('post_max_size')，确认返回值与配置一致。
二、验证上传目标目录的路径权限与所有权
PHP进程需要对指定上传目录具备可写权限，否则即使配置正确，move_uploaded_file()等函数也会因权限拒绝而失败。
1、确认框架中设定的上传路径，例如Laravel的storage/app/uploads或ThinkPHP的public/uploads。
2、在终端中执行ls -ld /path/to/upload/directory，检查目录是否存在且权限位包含w（如drwxr-xr-x中的第二组x前应有w）。
3、若权限不足，执行chmod 755 /path/to/upload/directory赋予所有者读写执行、组和其他用户读执行权限；如需更宽松控制（仅限开发环境），可使用chmod 777，但生产环境严禁使用777权限。
4、检查目录所属用户与PHP运行用户是否一致，常见PHP用户为www-data（Ubuntu/Debian）、apache（CentOS/RHEL）或_www（macOS）。执行ps aux | grep php或ps aux | grep apache确认。
5、若不一致，执行chown www-data:www-data /path/to/upload/directory（以www-data为例）修正所有权。
三、检查框架内置上传配置与中间件拦截
部分PHP框架（如Laravel、Symfony）在应用层额外封装了上传逻辑，并可能启用文件类型、大小、MIME校验等中间件，导致上传被静默拒绝。
1、查阅框架文档确认上传组件配置位置，例如Laravel中config/filesystems.php的disk配置及App\Http\Controllers\UploadController中的验证规则。
2、检查控制器中是否使用Request对象的validate()方法，查找类似'file' => 'required|file|mimes:jpg,png|max:5120'的规则，其中max:5120表示5MB上限。
3、临时注释或放宽验证规则，例如将max:5120改为max:51200，测试是否绕过框架层限制。
4、确认是否启用了全局中间件（如CSRF、身份认证）干扰文件上传流程，尝试在路由中使用withoutMiddleware排除干扰后重试。
5、查看框架日志（如storage/logs/laravel.log）搜索“upload”、“file”、“failed”等关键词，定位具体拒绝原因。
四、验证Web服务器层级的上传限制
除PHP配置外，Nginx与Apache自身也设有客户端请求体大小限制，该限制优先于PHP生效，若未调整将直接截断请求。
1、若使用Nginx，在对应server或http块中查找client_max_body_size指令，确保其值不低于PHP的post_max_size，例如：client_max_body_size 60M。
2、修改Nginx配置后执行nginx -t验证语法，再执行systemctl reload nginx重载配置。
3、若使用Apache，在虚拟主机或目录配置中添加LimitRequestBody 62914560（即60MB字节值），注意该指令不可用于.htaccess除非AllowOverride包含Limit。
4、重启Apache服务使配置生效：systemctl restart apache2（Debian/Ubuntu）或systemctl restart httpd（CentOS/RHEL）。
5、通过curl命令模拟大文件上传并观察响应头状态码，如返回413 Request Entity Too Large，则表明Web服务器层限制未解除。
五、检查临时文件目录状态与磁盘空间
PHP上传文件时先暂存至系统临时目录（由sys_get_temp_dir()返回），再移动至目标路径。若临时目录不可写或磁盘满，上传必然失败。
1、在PHP脚本中调用echo sys_get_temp_dir();获取当前临时目录路径，常见为/tmp或/var/tmp。
2、执行ls -ld $(sys_get_temp_dir)确认该目录存在且权限允许PHP用户写入。
3、执行df -h $(sys_get_temp_dir)检查所在分区剩余空间，确保可用空间大于待上传文件体积。
4、若临时目录空间不足，清理无用文件或修改PHP临时目录：在php.ini中设置sys_temp_dir = "/path/to/writable/temp"，并确保新路径已创建且权限正确。
5、验证新临时目录是否生效：重启PHP服务后再次调用sys_get_temp_dir()，确认返回路径已更新。
