本文旨在解决在XAMPP本地环境中，使用.htaccess文件去除URL中的.php扩展名失效的问题。通过详细讲解mod_rewrite模块的启用方法以及.htaccess文件的配置，帮助开发者在本地开发环境中实现与线上服务器一致的URL美化效果，提升开发效率。
在Web开发过程中，为了URL的简洁性和美观性，我们通常会移除URL中的.php扩展名。虽然在服务器上通过配置.htaccess文件可以轻松实现，但在XAMPP本地环境中，可能会遇到配置生效的问题。这通常是因为mod_rewrite模块未启用。
启用mod_rewrite模块
mod_rewrite是Apache服务器的一个强大模块，用于URL重写。XAMPP默认情况下可能未启用此模块。启用它的步骤如下：
-
找到php.ini文件： php.ini 文件位于 XAMPP 的 PHP 安装目录下。可以通过 XAMPP 控制面板找到 PHP 的配置目录。通常位于 C:\xampp\php 目录下。
立即学习“PHP免费学习笔记（深入）”；
-
启用mod_rewrite扩展： 使用文本编辑器打开 php.ini 文件，搜索 extension=php_rewrite.dll (Windows) 或 extension=rewrite.so (Linux)。 如果该行被注释（以分号 ; 开头），请移除分号以取消注释，启用该扩展。
;extension=php_rewrite.dll (修改前) extension=php_rewrite.dll (修改后)
或者
;extension=rewrite.so (修改前) extension=rewrite.so (修改后)
修改Apache配置文件 (httpd.conf): 找到 Apache 的配置文件 httpd.conf。它通常位于 C:\xampp\apache\conf 目录下。
-
修改
指令： 在 httpd.conf 文件中，找到指令，该指令定义了网站根目录的访问权限。通常情况下，需要修改网站根目录的 指令，例如： Options Indexes FollowSymLinks Includes ExecCGI AllowOverride All Require all granted 确保 AllowOverride 设置为 All。 AllowOverride All 允许 .htaccess 文件覆盖 Apache 的全局配置。
重启 Apache 服务器： 保存修改后的 php.ini 和 httpd.conf 文件，然后通过 XAMPP 控制面板重启 Apache 服务器，以使更改生效。
配置.htaccess文件
在网站的根目录下创建一个名为 .htaccess 的文件（如果不存在）。 将以下代码添加到 .htaccess 文件中：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME}\.php -f
RewriteRule ^(.*[^/])/?$ $1.php [L]代码解释：
- RewriteEngine On: 启用 URL 重写引擎。
- RewriteCond %{REQUEST_FILENAME} !-d: 检查请求的文件名是否不是一个目录。
- RewriteCond %{REQUEST_FILENAME}\.php -f: 检查请求的文件名加上 .php 后是否是一个存在的文件。
- RewriteRule ^(.*[^/])/?$ $1.php [L]: 将不以斜杠结尾的任何请求重写到相应的 .php 文件。 [L] 标志表示这是最后一条规则。
示例
假设你有一个名为 about.php 的文件。 在配置完成后，你可以通过访问 http://localhost/about 来访问 about.php 文件，而无需在 URL 中包含 .php 扩展名。
注意事项
- 确保 .htaccess 文件位于网站的根目录下。
- 在修改任何配置文件之前，建议备份原始文件，以防止意外情况发生。
- 如果修改后仍然无法生效，请检查 Apache 的错误日志，以获取更多调试信息。错误日志通常位于 C:\xampp\apache\logs 目录下。
- 如果你的项目使用了框架（如 Laravel、Symfony 等），框架本身可能已经提供了 URL 重写机制，你需要按照框架的文档进行配置。
总结
通过启用 mod_rewrite 模块并正确配置 .htaccess 文件，你可以在 XAMPP 本地环境中成功去除 URL 中的 .php 扩展名，从而获得与线上服务器一致的开发体验。 请务必按照步骤操作，并仔细检查配置文件，确保所有设置正确无误。
