从GET参数到PATH_INFO的路由迁移
在Web开发中，管理页面路由的方式多种多样。常见的一种是通过URL中的GET参数，例如： www.example.com/index.php?action=imageGallery
另一种更“整洁”且常用于构建RESTful API或美观URL的方式是利用服务器的环境变量$_SERVER["PATH_INFO"]，将页面标识作为URL路径的一部分，例如： www.example.com/index.php/imageGallery
这种方式通常涉及到服务器配置（如apache的mod_rewrite或nginx的try_files）将所有请求重写到单一的入口文件（通常是index.php），该文件被称为“前端控制器”（front controller）。然后，index.php通过解析$_server["path_info"]来决定加载哪个模块或执行哪个操作。
相对URL链接的意外拼接问题
当从GET参数路由迁移到PATH_INFO路由时，如果HTML中的<a>链接仍使用简单的相对路径，可能会出现意想不到的URL拼接行为。
假设我们有以下链接结构：
<a href="index.php">主页</a> <a href="index.php/imageGallery">图库</a> <a href="index.php/addImage">添加图片</a>
当用户从 www.example.com/myProject/index.php 导航到图库页面 www.example.com/myProject/index.php/imageGallery 后，如果再点击“主页”链接 (<a href="index.php">主页</a>)，预期的行为是返回到 www.example.com/myProject/index.php。然而，实际的URL可能会变成 www.example.com/myProject/index.php/index.php。同样，如果此时点击“添加图片”链接，URL会变成 www.example.com/myProject/index.php/index.php/addImage。
问题根源：URL解析规则
这种行为并非错误，而是浏览器遵循标准URL解析规则的结果。当URL中包含额外的路径组件（如/imageGallery）时，浏览器会将当前URL的“基准路径”（base path）更新。
立即学习“PHP免费学习笔记（深入）”；
- 当你在 www.example.com/myProject/index.php 页面时，相对链接 index.php 会解析为 www.example.com/myProject/index.php。
- 当你在 www.example.com/myProject/index.php/imageGallery 页面时，浏览器认为当前的“目录”是 www.example.com/myProject/index.php/。因此，任何相对链接（如 index.php）都会相对于这个新的基准路径进行解析，导致 www.example.com/myProject/index.php/index.php。
解决方案策略
为了解决这个问题，我们需要确保相对链接在任何页面上都能正确解析，或者使用绝对路径。以下是几种推荐的策略：
策略一：引入一致的路径组件并进行服务器端重定向
为了使所有页面的URL结构保持一致，可以为“主页”也定义一个明确的路径组件，例如 mainPage。
-
服务器端处理： 在你的index.php前端控制器中，检查PATH_INFO是否为空。如果为空，执行一个内部重定向到包含mainPage路径的URL，以保持URL结构的统一性。
<?php // index.php if (empty($_SERVER['PATH_INFO']) || $_SERVER['PATH_INFO'] === '/') { // 如果没有PATH_INFO或PATH_INFO是根目录，重定向到主页的统一路径 header('Location: index.php/mainPage'); echo '<title>Moved</title><h1>Moved</h1><a href="index.php/mainPage">Click here if not redirected.</a>'; exit(); // 确保重定向后代码不再执行 } // 后续根据 $_SERVER['PATH_INFO'] 处理路由 $pathInfo = trim($_SERVER['PATH_INFO'], '/'); switch ($pathInfo) { case 'mainPage': // 加载主页内容 echo "<h1>欢迎来到主页</h1>"; break; case 'imageGallery': // 加载图库内容 echo "<h1>图库页面</h1>"; break; case 'addImage': // 加载添加图片页面内容 echo "<h1>添加图片页面</h1>"; break; default: // 404 页面或默认主页 header("HTTP/1.0 404 Not Found"); echo "<h1>404 Not Found</h1>"; break; } ?> -
HTML链接调整： 将所有的<a>链接调整为只包含路径组件，这样它们都会相对于index.php/进行解析。
<!-- 在任何页面中 --> <a href="mainPage">主页</a> <a href="imageGallery">图库</a> <a href="addImage">添加图片</a>
在这种配置下，当你在 index.php/imageGallery 页面点击 <a href="mainPage"> 时，浏览器会将其解析为 index.php/mainPage，从而正确导航。
策略二：使用当前目录引用或根相对路径
另一种更简洁的方式是利用相对路径的特性，特别是 ./ 或 /。
-
使用 ./ 明确表示当前目录：./ 表示当前目录。当你在 index.php/imageGallery 页面时，./ 就代表 index.php/。因此，链接可以这样写：
<!-- 在任何页面中 --> <a href="./">主页</a> <!-- 指向 index.php/ --> <a href="./imageGallery">图库</a> <a href="./addImage">添加图片</a>
或者，对于非主页链接，./ 甚至可以省略，因为它们默认就相对于当前路径解析：
<!-- 在任何页面中 --> <a href="./">主页</a> <a href="imageGallery">图库</a> <a href="addImage">添加图片</a>
这种方式下，点击“主页”链接会导航到 www.example.com/myProject/index.php/。如果你希望主页URL是 www.example.com/myProject/index.php 而没有 /，则需要更复杂的重写规则或使用绝对路径。
-
使用根相对路径（推荐）： 最健壮的方法是使用根相对路径，即路径以 / 开头。这种路径总是相对于网站的根目录解析，而不受当前页面URL深度的影响。
假设你的项目根目录是 myProject，并且 index.php 位于 myProject/ 下。
<!-- 在任何页面中 --> <a href="/myProject/index.php">主页</a> <a href="/myProject/index.php/imageGallery">图库</a> <a href="/myProject/index.php/addImage">添加图片</a>
这种方法虽然需要你在链接中包含项目路径（如果项目不在域名根目录下），但它能确保链接始终指向预期目标，无论当前页面的URL结构如何。为了避免硬编码项目路径，可以使用PHP动态生成：
<?php $baseUrl = '/myProject/index.php'; // 或动态获取：$_SERVER['SCRIPT_NAME'] ?> <!-- 在任何页面中 --> <a href="<?php echo $baseUrl; ?>">主页</a> <a href="<?php echo $baseUrl; ?>/imageGallery">图库</a> <a href="<?php echo $baseUrl; ?>/addImage">添加图片</a>
总结与最佳实践
当从GET参数路由迁移到PATH_INFO路由时，理解浏览器如何解析相对URL至关重要。核心在于，当URL中引入新的路径组件时，相对链接的解析基准会发生变化。
- 避免简单的相对路径： 尽量不要使用 href="index.php" 这样的链接，因为它会根据当前URL的深度进行拼接。
- 使用一致的路径结构： 为所有页面（包括主页）定义一个明确的PATH_INFO组件，并通过服务器端重定向确保访问的一致性。
- 利用当前目录引用： href="./" 可以有效地指向当前PATH_INFO下的根目录。
- 优先使用根相对路径或动态生成绝对路径： 对于大型或复杂的项目，使用 / 开头的根相对路径或通过服务器端语言动态生成完整的URL路径是最健壮的方法，可以避免因URL结构变化而导致的链接失效问题。
深入理解URL解析规范是构建健壮Web应用的基础。通过精心设计URL布局和链接策略，可以确保网站在不同路由机制下都能提供流畅的用户体验。
