Apache如何配置PHP的URL重写_使用mod_rewrite与PHP协作的指南【详解】

胖瑶小哥_5977

胖瑶小哥_5977

2026-02-21

672人浏览

原创

启用mod_rewrite前必须确认三件事:一是模块已启用(sudo a2enmod rewrite或取消httpd.conf中LoadModule注释),二是AllowOverride All(或FileInfo)已配置,三是.htaccess文件存在且Apache用户有读取权限。

apache如何配置php的url重写_使用mod_rewrite与php协作的指南【详解】

Apache启用mod_rewrite模块前必须确认的三件事

PHP本身不处理URL重写,真正起作用的是Apache的mod_rewrite模块——它在请求到达PHP之前就完成路径改写。如果你发现.htaccess里的规则没生效,大概率不是PHP配置问题,而是mod_rewrite没启用或AllowOverride被禁用。

  • 运行sudo a2enmod rewrite(Debian/Ubuntu)或确认LoadModule rewrite_module modules/mod_rewrite.so在httpd.conf中已取消注释(CentOS/RHEL)
  • 确保对应虚拟主机或目录配置里包含AllowOverride All(仅AllowOverride FileInfo也够用,但All更省心)
  • .htaccess文件必须放在Web根目录或子目录下,且Apache用户(如www-data或apache)有读取权限

PHP项目常用重写规则:隐藏index.php与支持PATH_INFO

现代PHP框架(Laravel、ThinkPHP、CodeIgniter等)依赖将所有请求路由到index.php,再由PHP解析$_SERVER['REQUEST_URI']分发。关键不是“让PHP能重写”,而是“让Apache把非静态资源全交给PHP处理”。

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

注意:index.php/$1这种写法会触发PATH_INFO,PHP中可通过$_SERVER['PATH_INFO']获取原始路径;若用index.php?_url=/$1,则需从$_GET['_url']读取——两种方式都可行,但前者更轻量,后者兼容性略高(尤其在某些FastCGI配置下)。

  • 务必保留两个RewriteCond:跳过真实存在的文件(如css/style.css)和目录,否则静态资源会404
  • [L]标志表示“最后一条规则”,避免后续规则干扰;如果还有其他重写逻辑,需谨慎安排顺序
  • 若使用PHP-FPM,确认fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;未被意外覆盖,否则index.php可能无法执行

重写后PHP如何安全获取原始请求路径

重写会改变$_SERVER中多个变量的值,直接读$_SERVER['REQUEST_URI']通常仍正确,但$_SERVER['SCRIPT_NAME']和$_SERVER['PATH_INFO']取决于重写写法和SAPI模式。别假设它们一定可靠。

Apache Tika Content Extraction Hub
Apache Tika Content Extraction Hub

通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。

下载
  • 最稳妥的方式是用$_SERVER['REQUEST_URI'](含查询参数)配合parse_url()提取路径部分
  • 如果用了index.php/$1写法,且PATH_INFO可用,可检查isset($_SERVER['PATH_INFO']) && $_SERVER['PATH_INFO'] !== '',但需确认php.ini中cgi.fix_pathinfo=1(默认值,但某些Docker镜像会关掉)
  • 避免依赖$_SERVER['REDIRECT_URL']:它是Apache内部变量,不同版本行为不一致,且CLI或某些FastCGI环境可能不存在

调试mod_rewrite失败时最先查的三个地方

重写不生效时,90%的问题出在Apache配置层,而不是PHP代码。不要一上来就改PHP路由逻辑。

  • 查看Apache错误日志:tail -f /var/log/apache2/error.log(Ubuntu)或/var/log/httpd/error_log(CentOS),搜索rewrite或htaccess关键词,常能看到Options FollowSymLinks or SymLinksIfOwnerMatch is off这类提示
  • 临时在.htaccess顶部加RewriteRule ^test-rewrite$ /test.php [R=302,L],访问/test-rewrite看是否跳转,快速验证模块和AllowOverride是否真生效
  • 用curl -I http://localhost/.htaccess确认该文件不能被直接下载(应返回403),否则说明AllowOverride未生效或Files指令被绕过

重写是Apache的事,PHP只是接收结果;把边界划清楚,排查效率会高很多。PATH_INFO是否开启、REQUEST_URI是否被代理篡改、mod_rewrite日志级别是否调为RewriteLogLevel 3(仅开发环境)——这些细节比写一百行PHP路由更影响最终效果。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php apache

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

897

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

875

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2528

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

5081

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

7490

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

4916

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

9209

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1536

29

Laravel 框架安装指南
Laravel 框架安装指南

本指南详解 Laravel 框架安装全流程,涵盖 PHP 8.1+ 环境配置、Composer 依赖管理工具安装及国内镜像源优化。重点演示使用 composer create-project 命令创建 Laravel 10/11 项目,解决常见安装错误与依赖冲突。从环境搭建到项目初始化,助您快速完成 Laravel 开发环境部署,为后续 Web 应用开发奠定基础。适合 PHP 初学者与框架迁移开发者参考。

2026.04.09

235

6

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习