PHP访问404错误怎么解决

PHP访问时出现404错误，往往并非代码问题，而是Web服务器（如Apache或Nginx）根本未将.php请求正确转发给PHP解析器——它把PHP文件当作了不存在的静态资源直接返回404；解决关键在于系统排查：确认PHP模块已启用、MIME类型与路由规则配置正确、PHP-FPM服务正常运行且权限/连接无误、服务器root路径与URL严格匹配，并排除.htaccess或Nginx重写规则的干扰；一个简单却高效的验证方法是用PHP内置服务器（php -S）直跑脚本，若能成功则铁定是Web服务器配置出了问题——别在代码里盲目调试，先打通从HTTP请求到PHP执行的“最后一公里”。

检查 Web 服务器是否真的在运行 PHP 而不是只返回静态文件

很多“404”其实根本不是 PHP 报的，而是 Web 服务器（如 Apache 或 Nginx）压根没把 .php 文件交给 PHP 解析器处理，直接当成不存在的静态资源返回了 404。典型表现是：访问 index.html 正常，但 index.php 404；或者浏览器地址栏显示 http://localhost/test.php，但响应头里 Content-Type 是 text/html 而不是 PHP 输出的内容。

• Apache：确认启用了 mod_php（或 php_module），且配置中有类似 AddType application/x-httpd-php .php 和 段落
• Nginx：确认 location ~ \.php$ 块存在，并正确将请求代理给 fastcgi_pass（如 127.0.0.1:9000 或 unix:/var/run/php/php8.1-fpm.sock）
• 用命令快速验证 PHP 是否就绪：

  php -v

  （看 CLI 是否正常），再执行

  php -S localhost:8000

  启动内置服务器，访问 http://localhost:8000/test.php —— 如果这时能显示内容，说明是 Web 服务器配置问题，不是 PHP 本身

确认请求路径和文件物理位置完全匹配

PHP 不会“猜路径”，404 最常见原因是 URL 路径与服务器上真实文件路径不一致，尤其容易在重写规则、虚拟主机或子目录部署时出错。

• 不要依赖 IDE 或编辑器的“在浏览器中打开”功能，它可能用的是 file:// 协议，绕过 Web 服务器 → 一定要用 http:// 开头的地址访问
• 在 PHP 文件开头加一句：

  <?php die(__FILE__); ?>

  ，访问后看输出的绝对路径，对比你认为它该在的位置，确认是否少了一级目录（比如项目放在 /var/www/html/myapp/，但你访问的是 /myapp/index.php，而服务器配置的 root 是 /var/www/html）
• Apache 的 DocumentRoot 和 Nginx 的 root 指令必须指向包含 .php 文件的父目录，不能指向更深的子目录却没配对的 location 或 Alias

排查 .htaccess 或 Nginx 重写规则干扰

URL 重写（尤其是 Laravel、WordPress 等框架常用）一旦配置错误，会导致 PHP 脚本被重定向到不存在的路径，最终由 Web 服务器返回 404。

• Apache 下临时禁用 .htaccess：把 AllowOverride 改为 None，或重命名 .htaccess 文件，再试访问原始 PHP 文件（如 /info.php）
• Nginx 中注释掉整个 location ~ \.php$ { ... } 块以外的重写逻辑（如 try_files $uri $uri/ /index.php?$query_string;），改用最简配置直通 PHP，排除干扰
• 开启 Web 服务器的重写日志（Apache：RewriteLog + RewriteLogLevel；Nginx：rewrite_log on;）可看到每一步跳转，定位哪条规则意外截断了请求

检查 PHP-FPM 是否监听正确地址且有权限访问

Nginx 常见报错是 connect() to unix:/var/run/php/php8.1-fpm.sock failed (13: Permission denied)，表面是 404，实际是 Nginx 根本连不上 PHP-FPM，于是降级返回 404（而非 502）。

• 确认 PHP-FPM 进程正在运行：

  systemctl status php8.1-fpm

  （版本号按实际调整）
• 检查 listen 配置项（通常在 /etc/php/8.1/fpm/pool.d/www.conf）：如果是 unix 套接字，确认 Nginx worker 进程用户（如 www-data）对该 socket 文件有读写权限；如果是 127.0.0.1:9000，确认端口未被占用且防火墙放行
• 用 ls -l /var/run/php/ 查看 socket 文件属主和权限，必要时修改 listen.owner / listen.group 并重启 PHP-FPM

真正卡住的地方往往不在 PHP 代码里，而在 Web 服务器和 PHP-FPM 之间的那层连接——路径、权限、协议、用户上下文，四者缺一不可。调不通时，先砍掉所有中间层（重写、缓存、CDN），用最裸的配置跑一个 phpinfo()，再一层层加回来。

到这里，我们也就讲完了《PHP访问404错误怎么解决》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！