PHP部署404错误怎么处理？

PHP项目部署后出现404错误，往往并非代码问题，而是Web服务器配置的关键细节出了偏差：最常见原因是服务器根目录（DocumentRoot或root）未精准指向框架要求的public子目录，叠加PHP模块未启用、重写规则失效（如Nginx缺少try_files或Apache未开启mod_rewrite及AllowOverride）、.php文件无法解析等多重因素——这些看似琐碎的配置陷阱，恰恰是线上环境反复踩坑的根源，快速定位需同步排查路径、PHP执行、URL重写与框架结构四层依赖。

检查 Web 服务器是否正确指向 PHP 项目根目录

404 最常见原因是 Web 服务器（如 Apache 或 Nginx）的 DocumentRoot（Apache）或 root（Nginx）没指向你放 index.php 的实际目录。比如你把项目放在 /var/www/myapp，但服务器配置仍指向 /var/www/html，就会直接 404。

• Apache：确认 DocumentRoot 和 路径一致，且该目录下存在 index.php
• Nginx：检查 server 块中的 root 指令，确保路径末尾**不带斜杠**（如 root /var/www/myapp;，不是 /var/www/myapp/;）
• 重启服务后用 curl -I http://localhost 看响应头，确认状态码是否变化

确认 PHP 文件能被 Web 服务器解析而非直接下载

如果访问 index.php 时浏览器直接下载文件，或返回原始 PHP 代码，说明 PHP 模块未启用或未正确关联 .php 后缀——此时 Web 服务器根本没执行 PHP，自然无法路由到控制器，也常表现为“看似 404”（其实是 200 返回了空内容或源码）。

• Apache：确认已加载 libphp.so（或 php_module），且 AddHandler application/x-httpd-php .php 已配置
• Nginx：确认 location ~ \.php$ 块存在，并正确将请求代理给 fastcgi_pass（如 127.0.0.1:9000 或 unix:/var/run/php/php8.1-fpm.sock）
• 运行 php -v 和 systemctl status php8.1-fpm（或对应版本）确认 PHP-FPM 正在运行

检查 Laravel / Symfony 等框架的重写规则是否生效

现代 PHP 应用依赖 URL 重写把所有请求统一交给 index.php 处理。若重写失效，除 index.php 外的路径（如 /login、/api/users）都会 404。

• Laravel：Apache 需启用 mod_rewrite，且项目根目录下的 .htaccess 文件必须存在且未被覆盖；Nginx 则需在 location / 块中加入 try_files $uri $uri/ /index.php?$query_string;
• Symfony：同理，Nginx 推荐用 try_files $uri /index.php?$query_string;，避免多一层 $uri/ 导致子目录匹配异常
• 测试方法：临时在 index.php 开头加 ，再访问任意路径（如 /test）。如果输出 hit，说明重写生效；否则仍是 404，问题在重写配置

验证 public 目录是否被误设为项目根目录上级

很多框架（Laravel、Lumen、Symfony）要求 Web 服务器的根目录必须是 public/，而不是项目根目录。如果错误地把 /var/www/myapp 设为 DocumentRoot，而真实入口是 /var/www/myapp/public/index.php，那么除 /public/index.php 外所有路径都不可达。

• 正确做法：Apache 设置 DocumentRoot "/var/www/myapp/public"；Nginx 设置 root /var/www/myapp/public;
• 常见陷阱：部署时复制整个项目，但忘记调整 Web 服务器配置指向 public 子目录
• 可临时加一个 info.php 到 public/ 下，内容为 ，通过 http://yoursite/info.php 验证路径和 PHP 是否就绪

最易忽略的是：重写规则和 public/ 路径这两个点经常同时出错，排查时别只盯一个。比如 Nginx 配置对了 root，但漏了 try_files；或者 .htaccess 写对了，但 Apache 的 AllowOverride All 没开在对应 块里——这两类权限与规则叠加问题，比单纯路径错更难一眼发现。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP部署404错误怎么处理？》文章吧，也可关注golang学习网公众号了解相关技术文章。