本地部署PHP应用无法上传文件的常见原因及解决步骤包括：一、修改php.ini中upload_max_filesize、post_max_size等参数并重启服务器；二、设置上传目录写入权限；三、调整Nginx或Apache的请求体大小限制；四、确认upload_tmp_dir路径存在且可写；五、检查SELinux或AppArmor策略限制。
如果您在本地部署 PHP 应用后无法成功上传文件，常见原因包括 PHP 配置中的文件大小限制过低或 Web 服务器对上传目录的写入权限不足。以下是针对此问题的多项具体处理步骤：
一、修改 php.ini 中的上传限制参数
PHP 默认对单个上传文件大小和整个 POST 数据总量设有限制，需手动调整相关配置项以支持更大的文件上传。
1、定位当前生效的 php.ini 文件：在 Web 根目录下新建 info.php，内容为 <?php phpinfo(); ?>；，通过浏览器访问该文件，在 “Loaded Configuration File” 行查看路径。
2、使用文本编辑器打开该 php.ini 文件。
立即学习“PHP免费学习笔记（深入）”；
3、查找并修改以下三项参数值（例如设为 100M）：
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 300
4、保存文件后，重启 Web 服务器（如 Apache 或 Nginx）使配置生效。
二、检查并设置上传目标目录的写入权限
PHP 脚本需对指定的临时上传目录及最终保存目录具备写入权限，否则 move_uploaded_file() 将失败。
1、确认上传脚本中指定的目标路径，例如 $_FILES['file']['tmp_name'] 对应的临时目录通常为系统默认 tmp，而最终保存路径如 './uploads/'。
2、在终端中执行命令设置上传目录权限（Linux/macOS）：
chmod -R 755 ./uploads/
3、若仍报错，可临时测试赋予完全写入权限：
chmod -R 777 ./uploads/
4、Windows 系统需右键点击 uploads 文件夹 → “属性” → “安全” 选项卡 → 编辑用户（如 IIS_IUSRS 或 www-data）的“写入”权限为允许。
三、调整 Web 服务器层的请求体大小限制
Nginx 和 Apache 在自身配置中也设有客户端请求体大小上限，若未同步放宽，PHP 层修改将无效。
1、对于 Nginx：编辑站点配置文件（如 /etc/nginx/sites-enabled/default），在 server 或 location 块内添加：
client_max_body_size 100M;
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
2、保存后执行 nginx -t 验证语法，再运行 nginx -s reload 重载配置。
3、对于 Apache：若使用 .htaccess，在上传目录下创建或编辑该文件，加入：
LimitRequestBody 104857600
4、若 Apache 主配置启用 mod_php，也可在 httpd.conf 或 virtual host 段中直接添加上述 LimitRequestBody 指令。
四、验证 upload_tmp_dir 设置是否有效
PHP 使用 upload_tmp_dir 指定临时文件存放路径，若该路径不存在、不可写或磁盘空间不足，上传会静默失败。
1、在 phpinfo() 输出中查找 “upload_tmp_dir” 行，确认其值是否为空或指向合法路径。
2、若为空，需在 php.ini 中显式设置：
upload_tmp_dir = /var/tmp
3、确保该路径存在且 Web 服务器用户（如 www-data、apache）对其有读写权限：
mkdir -p /var/tmp && chown www-data:www-data /var/tmp && chmod 755 /var/tmp
4、重启 PHP-FPM 或 Web 服务进程。
五、检查 SELinux 或 AppArmor 强制访问控制策略
在启用了 SELinux（CentOS/RHEL）或 AppArmor（Ubuntu）的系统中，即使文件权限正确，安全模块也可能阻止 PHP 进程写入指定目录。
1、检查 SELinux 状态：
sestatus
2、若处于 enforcing 模式，临时设为 permissive 测试是否解决问题：
setenforce 0
3、若上传恢复正常，需为上传目录添加正确上下文：
semanage fcontext -a -t httpd_sys_rw_content_t "/path/to/uploads(/.*)?"
restorecon -Rv /path/to/uploads
4、Ubuntu 用户检查 AppArmor 日志：
sudo aa-logprof && sudo systemctl restart apparmor
