使用.htaccess配置Apache：将子目录设为根目录并实现URL路径透明化-php教程-PHP中文网

使用.htaccess配置Apache：将子目录设为根目录并实现URL路径透明化

DDD

发布： 2025-11-21 12:01:52

原创

779人浏览过

使用.htaccess配置apache：将子目录设为根目录并实现url路径透明化

在现代Web开发中，尤其是在使用MVC（Model-View-Controller）或类似架构的PHP框架时，通常会将所有前端请求统一路由到一个入口文件（例如index.php），而这个入口文件通常位于项目根目录下的一个子目录（如public/）中。这样做有助于分离公共可访问资源与核心应用逻辑，提升安全性和项目结构清晰度。然而，Apache服务器的默认配置可能无法直接满足这种需求。本文将指导您如何通过mod_rewrite模块在.htaccess文件中实现这一目标。

理解核心需求

我们的目标是实现以下行为：

将public/目录视为网站的实际根目录。例如，访问http://localhost/应等同于访问public/目录下的内容。
允许直接访问public/目录及其子目录中的静态文件，如http://localhost/css/style.css、http://localhost/js/script.js或http://localhost/images/funny.gif。
对于所有非静态文件请求，将其重写到public/index.php，同时确保原始URL的完整路径和查询参数（例如http://localhost/news/1?test=helloword）在PHP中可被解析。这意味着，在PHP中，parse_url()函数应能正确获取到path为/news/1和query为test=helloword。

Apache mod_rewrite模块与.htaccess

mod_rewrite是Apache的一个强大模块，它允许通过正则表达式重写URL。.htaccess文件是放置在Web服务器目录中的配置文件，它为该目录及其子目录提供配置指令。要使用mod_rewrite，请确保您的Apache服务器已启用此模块，并且在httpd.conf或虚拟主机配置中，相关目录的AllowOverride指令设置为All或至少包含FileInfo。

实现.htaccess配置

为了满足上述需求，我们将在项目的根目录（即包含public/目录的上一级目录）创建一个.htaccess文件。以下是推荐的.htaccess配置内容：

# 启用RewriteEngine
RewriteEngine On

# 设置RewriteBase，指定重写规则的基准URL路径
# 如果您的网站部署在子目录中（例如 http://localhost/myproject/），则应设置为 /myproject/
RewriteBase /

# 规则1: 检查请求是否指向一个真实存在的文件或目录
# 如果请求的URI对应一个实际存在的文件（-f）或目录（-d），
# 则不执行后续的重写规则，直接由Apache提供服务。
# 这确保了静态资源（如CSS、JS、图片）能够被直接访问。
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 规则2: 将所有不匹配真实文件或目录的请求重写到 public/index.php
# ^(.*)$ 匹配所有URI路径，并将其作为捕获组传递。
# public/index.php 是我们的前端控制器。
# [L] 表示这是最后一条规则，停止处理后续规则。
# 此时，原始的请求URI（例如 /news/1?test=helloword）将通过 $_SERVER['REQUEST_URI']
# 完整地传递给 public/index.php。
RewriteRule ^(.*)$ public/index.php [L]

登录后复制

配置说明：

360智图

AI驱动的图片版权查询平台

143

查看详情

RewriteEngine On: 开启Apache的重写引擎。
RewriteBase /: 定义重写规则的基础URL路径。对于部署在域名根目录下的应用，通常设置为/。如果您的应用部署在子目录，例如http://example.com/myapp/，则应将其设置为/myapp/。
RewriteCond %{REQUEST_FILENAME} !-f: 这是一个条件指令。它检查当前请求的URI是否不对应一个实际存在的文件。!表示否定，-f表示文件。
RewriteCond %{REQUEST_FILENAME} !-d: 类似地，这个条件检查当前请求的URI是否不对应一个实际存在的目录。
RewriteRule ^(.*)$ public/index.php [L]: 这是核心重写规则。
- ^(.*)$: 匹配任何URI路径。
- public/index.php: 指定所有匹配的请求都将被内部重写到public/index.php。
- [L]: LAST标记，表示如果此规则匹配并执行，则停止处理后续的重写规则。

通过这组规则，当用户访问http://localhost/css/style.css时，由于public/css/style.css是一个真实存在的文件（假设它存在），RewriteCond条件不满足，请求将直接由Apache处理。而当用户访问http://localhost/news/1?test=helloword时，由于/news/1不是一个真实的文件或目录，RewriteCond条件满足，请求将被重写到public/index.php。

在PHP中解析URL

当请求被重写到public/index.php后，PHP应用可以通过$_SERVER超全局变量访问原始的URL信息。

在public/index.php中，您可以这样获取和解析URL：

<?php

// 获取原始的请求URI，包含路径和查询字符串
$requestUri = $_SERVER['REQUEST_URI'];

// 解析URL
$urlComponents = parse_url($requestUri);

// 获取路径部分
$path = $urlComponents['path'] ?? '/';

// 获取查询字符串部分
$queryString = $urlComponents['query'] ?? '';

// 如果需要，可以将查询字符串解析成关联数组
$queryParameters = [];
if (!empty($queryString)) {
    parse_str($queryString, $queryParameters);
}

echo "原始请求URI: " . $requestUri . "\n";
echo "解析后的路径: " . $path . "\n";
echo "解析后的查询字符串: " . $queryString . "\n";
echo "解析后的查询参数:\n";
print_r($queryParameters);

// 示例输出：
// 访问 http://localhost/news/1?test=helloword
// 原始请求URI: /news/1?test=helloword
// 解析后的路径: /news/1
// 解析后的查询字符串: test=helloword
// 解析后的查询参数:
// Array
// (
//     [test] => helloword
// )

// 在这里，您可以根据 $path 和 $queryParameters 实现您的路由逻辑
// 例如：
// require __DIR__ . '/../bootstrap/app.php'; // 引入应用启动文件
// $app->handleRequest($path, $queryParameters); // 路由处理

登录后复制

注意事项与最佳实践

启用mod_rewrite: 确保您的Apache服务器已启用mod_rewrite模块。在Ubuntu/Debian系统上，可以通过sudo a2enmod rewrite命令启用，然后重启Apache服务sudo service apache2 restart。
AllowOverride All: 在Apache的配置文件（例如httpd.conf或虚拟主机配置文件）中，确保您网站的DocumentRoot或相关目录的Directory块中包含AllowOverride All或AllowOverride FileInfo。如果没有，.htaccess文件中的RewriteRule将不会生效。
```
<Directory /var/www/html/your_project_root>
    Options Indexes FollowSymLinks
    AllowOverride All # 确保这一行存在
    Require all granted
</Directory>
```
登录后复制
性能考虑: .htaccess文件会在每个请求时被Apache解析，这会带来轻微的性能开销。对于高流量网站，最佳实践是将重写规则直接配置在主Apache配置文件（httpd.conf或虚拟主机配置）中，而不是使用.htaccess。然而，对于大多数开发环境和中小型网站，.htaccess的便利性通常 outweighs 其性能影响。
PHP内置服务器: 您提到的php -S localhost:8000 -t public/命令，PHP内置服务器会自动将所有请求路由到public/index.php（如果public/下没有匹配的文件），这与上述.htaccess的目标行为是一致的。
目录结构: 确保您的public/index.php能够正确地加载其他必要的PHP文件（例如，通过require __DIR__ . '/../vendor/autoload.php';）。

总结

通过上述.htaccess配置，您可以成功地将Apache服务器的Web根目录逻辑地指向项目的public/子目录，同时保留了静态资源的直接访问能力，并确保了所有动态请求都能被前端控制器（如public/index.php）接收并处理，且原始URL的路径和查询参数在PHP应用中保持完整可访问。这种设置是许多现代PHP框架（如Laravel、Symfony）推荐和使用的标准方式，为构建健壮、可维护的Web应用奠定了基础。

以上就是使用.htaccess配置Apache：将子目录设为根目录并实现URL路径透明化的详细内容，更多请关注php中文网其它相关文章！