PHP网页404错误怎么解决
时间:2026-05-26 15:45:37 466浏览 收藏
PHP网页出现404错误并非PHP本身的问题,而是Web服务器(如Apache或Nginx)在路径匹配、配置解析或权限设置上出了偏差——可能是URL路径与文件实际位置不一致(尤其注意Linux大小写敏感)、DocumentRoot指向错误、PHP解析模块未启用、.htaccess重写规则误导向,或文件权限/读取限制导致服务器根本找不到资源;排查时需逐层验证请求路径真实性、服务器配置有效性、重写规则合理性及PHP执行链完整性,因为一个微小的配置疏漏,就足以让服务器把“走错路”的请求直接判为“页面不存在”。

确认请求的 URL 路径是否匹配服务器实际文件位置
PHP 本身不直接返回 404,真正触发 404 的是 Web 服务器(如 Apache 或 Nginx)——它找不到对应路径的文件或未配置好路由。先检查浏览器地址栏里的 URL,比如访问的是 http://localhost/user/profile.php,就要确认项目根目录下是否存在 user/profile.php 这个文件,路径大小写、斜杠方向、扩展名都不能出错。
- Linux 服务器区分大小写:
Profile.php≠profile.php - Apache 默认不解析
.php文件时,可能返回 404 而非 500,需检查httpd.conf或.htaccess中是否有AddType application/x-httpd-php .php - Nginx 需确保
location ~ \.php$块存在且fastcgi_pass指向正确的 PHP-FPM 地址
检查 Web 服务器的文档根目录(DocumentRoot)设置是否正确
很多本地开发环境(如 XAMPP、WAMP、MAMP)默认把站点放在 htdocs 或 www 目录,但你可能把 PHP 文件放到了桌面或其它位置。Apache 的 DocumentRoot 和 必须指向你实际存放 PHP 文件的父目录。
DocumentRoot "/Applications/MAMP/htdocs"
<Directory "/Applications/MAMP/htdocs">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
如果改过这个路径,记得重启 Apache;Nginx 则检查 root 指令,例如 root /var/www/myapp;,确保该路径真实存在且有读取权限。
排除 .htaccess 重写规则导致的伪 404
如果你用了 Laravel、WordPress 或自定义 URL 重写,.htaccess 中的 RewriteRule 可能误将合法请求导向不存在的路径,而服务器最终因找不到目标文件返回 404。临时重命名 .htaccess 为 .htaccess.bak,再刷新页面:如果 404 消失,说明问题出在重写逻辑。
- 常见错误:
RewriteBase /subdir/写成/,但项目实际部署在子目录 - 遗漏
RewriteCond %{REQUEST_FILENAME} !-f和!-d,导致静态资源(如style.css)也被重写 - Apache 启用了
mod_rewrite但未允许AllowOverride All,导致规则不生效,看似“没重写”,实则因配置失效引发路径错乱
验证 PHP 是否真的被服务器执行而非当作纯文本下载
如果访问 info.php 页面只看到源码(即浏览器下载或显示 ),说明 PHP 解析模块未启用或 MIME 类型未注册,此时服务器无法执行脚本,也就不会进入 PHP 层级的错误处理,直接按“文件不存在”对待,返回 404(尤其在某些 Nginx + PHP-FPM 配置缺失时)。
- Apache:检查
LoadModule php_module modules/libphp.so和AddHandler php-script .php是否启用 - Nginx:确认
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;中的$document_root不为空,且$fastcgi_script_name匹配真实路径 - 用
curl -I http://localhost/info.php查看响应头,若含Content-Type: text/html且状态码是 200,说明 PHP 已执行;若是text/plain或 404,则解析链断裂
路径、权限、配置三者只要一个没对上,404 就会悄无声息地出现——它看起来是“页面丢了”,其实往往是“路标指错了”。
今天关于《PHP网页404错误怎么解决》的内容介绍就到此结束,如果有什么疑问或者建议,可以在golang学习网公众号下多多回复交流;文中若有不正之处,也希望回复留言以告知!
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
292 收藏
-
189 收藏
-
213 收藏
-
286 收藏
-
333 收藏
-
449 收藏
-
273 收藏
-
466 收藏
-
305 收藏
-
421 收藏
-
135 收藏
-
106 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习