0

0

PHP 404 错误排查:新 PHP 页面无法访问的常见原因与解决方案

心靈之曲

心靈之曲

发布时间:2026-01-12 11:07:20

|

640人浏览过

|

来源于php中文网

原创

PHP 404 错误排查:新 PHP 页面无法访问的常见原因与解决方案

当在本地开发环境中新增 about.php 等 php 文件却始终返回“404 not found”错误时,问题通常并非文件缺失,而是 web 服务器未正确识别或路由该请求——尤其在使用 apache 的 .htaccess 重写规则、虚拟主机配置或 url 重写机制的项目中。

该错误看似是文件路径问题,实则多为服务器端路由控制逻辑所致。从你提供的信息可确认以下关键事实:

  • index.php 和 search.php 可正常访问 → 说明 PHP 解析、Web 服务(如 Apache/XAMPP)及基础目录结构均无问题;
  • 所有新建的 .php 文件(包括简单 HTML 结构)均 404 → 排除文件权限、编码、BOM 头等常见文件级问题;
  • 全新项目中同样文件可运行 → 进一步证实是当前项目的特定配置干扰了直接 PHP 文件访问

最可能的原因是:项目启用了 URL 重写(RewriteEngine),且规则未放行原始 .php 文件请求。
例如,.htaccess 中可能存在类似以下规则:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]

该配置会将所有非真实文件/目录的请求统一转发给 index.php(常用于 MVC 路由)。但若 about.php 确实存在,理论上应被 !-f 条件排除而直接访问——除非:

  • .htaccess 文件未被 Apache 启用(检查 httpd.conf 中 AllowOverride All 是否对项目目录生效);
  • 重写规则中误加了 RewriteBase / 或路径偏移,导致匹配异常;
  • 存在更早的 RewriteRule 拦截了 .php 扩展名(如强制去除 .php 后缀,但未配置对应重写)。

? 快速验证与解决步骤:

  1. 检查 .htaccess 文件是否存在并生效
    在项目根目录下查找 .htaccess,临时重命名为 .htaccess.bak,刷新 http://localhost:84/Projects/Calculator/Calculator/about.php。若此时可访问,即确认是重写规则导致。

  2. 修正重写规则(推荐)
    若需保留友好 URL,应在重写前显式放行真实 PHP 文件:

    RewriteEngine On
    # 允许直接访问 .php 文件
    RewriteCond %{REQUEST_FILENAME} -f
    RewriteCond %{REQUEST_FILENAME} \.php$
    RewriteRule ^ - [L]
    
    # 其他路由(仅处理不存在的文件/目录)
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php [QSA,L]
  3. 验证服务器配置(XAMPP/WAMP 用户)
    确保 Apache 的 mod_rewrite 已启用(XAMPP 控制面板 → Apache → Config → httpd.conf,确认 LoadModule rewrite_module modules/mod_rewrite.so 未被注释,且对应 块中含 AllowOverride All)。

⚠️ 注意:不要依赖“复制 index.php 改名”的临时方案(如答案所提),它虽可能绕过某些逻辑判断,但未触及根本问题,且易引发后续维护混乱。

暗壳AI
暗壳AI

Ark.art 包罗万象的艺术方舟,友好高效的设计助手

下载

立即学习PHP免费学习笔记(深入)”;

✅ 总结:PHP 文件 404 的核心排查顺序应为:
① 检查 .htaccess 是否存在及规则逻辑;
② 验证 Apache mod_rewrite 与 AllowOverride 配置;
③ 审查虚拟主机或路由入口(如 index.php 是否接管了全部请求);
④ 最后才考虑文件系统层面问题(权限、大小写、隐藏字符等)。

通过以上结构化排查,可精准定位并永久解决此类“文件存在却 404”的典型开发环境问题。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2408

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1552

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1449

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

951

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1414

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1233

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1305

2023.11.13

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

3

2026.01.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号