从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中的链接仍使用简单的相对路径，可能会出现意想不到的URL拼接行为。

假设我们有以下链接结构：

主页
图库
添加图片

当用户从 www.example.com/myProject/index.php 导航到图库页面 www.example.com/myProject/index.php/imageGallery 后，如果再点击“主页”链接 (主页)，预期的行为是返回到 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。

1. 服务器端处理： 在你的index.php前端控制器中，检查PATH_INFO是否为空。如果为空，执行一个内部重定向到包含mainPage路径的URL，以保持URL结构的统一性。

   Moved
   Moved
   Click here if not redirected.';
      exit(); // 确保重定向后代码不再执行
   }
   
   // 后续根据 $_SERVER['PATH_INFO'] 处理路由
   $pathInfo = trim($_SERVER['PATH_INFO'], '/');
   switch ($pathInfo) {
       case 'mainPage':
           // 加载主页内容
           echo "
   欢迎来到主页
   ";
           break;
       case 'imageGallery':
           // 加载图库内容
           echo "
   图库页面
   ";
           break;
       case 'addImage':
           // 加载添加图片页面内容
           echo "
   添加图片页面
   ";
           break;
       default:
           // 404 页面或默认主页
           header("HTTP/1.0 404 Not Found");
           echo "
   404 Not Found
   ";
           break;
   }
   ?>

2. HTML链接调整： 将所有的链接调整为只包含路径组件，这样它们都会相对于index.php/进行解析。

   
   主页
   图库
   添加图片

   在这种配置下，当你在 index.php/imageGallery 页面点击 时，浏览器会将其解析为 index.php/mainPage，从而正确导航。

策略二：使用当前目录引用或根相对路径

另一种更简洁的方式是利用相对路径的特性，特别是 ./ 或 /。

易可图

电商人都在用的设计平台

下载

1. 使用 ./ 明确表示当前目录：./ 表示当前目录。当你在 index.php/imageGallery 页面时，./ 就代表 index.php/。因此，链接可以这样写：

   
   主页 
   图库
   添加图片

   或者，对于非主页链接，./ 甚至可以省略，因为它们默认就相对于当前路径解析：

   
   主页
   图库
   添加图片

   这种方式下，点击“主页”链接会导航到 www.example.com/myProject/index.php/。如果你希望主页URL是 www.example.com/myProject/index.php 而没有 /，则需要更复杂的重写规则或使用绝对路径。

2. 使用根相对路径（推荐）： 最健壮的方法是使用根相对路径，即路径以 / 开头。这种路径总是相对于网站的根目录解析，而不受当前页面URL深度的影响。

   假设你的项目根目录是 myProject，并且 index.php 位于 myProject/ 下。

   
   主页
   图库
   添加图片

   这种方法虽然需要你在链接中包含项目路径（如果项目不在域名根目录下），但它能确保链接始终指向预期目标，无论当前页面的URL结构如何。为了避免硬编码项目路径，可以使用PHP动态生成：

   
   
   主页
   图库
   添加图片

总结与最佳实践

当从GET参数路由迁移到PATH_INFO路由时，理解浏览器如何解析相对URL至关重要。核心在于，当URL中引入新的路径组件时，相对链接的解析基准会发生变化。

• 避免简单的相对路径： 尽量不要使用 href="index.php" 这样的链接，因为它会根据当前URL的深度进行拼接。
• 使用一致的路径结构： 为所有页面（包括主页）定义一个明确的PATH_INFO组件，并通过服务器端重定向确保访问的一致性。
• 利用当前目录引用： href="./" 可以有效地指向当前PATH_INFO下的根目录。
• 优先使用根相对路径或动态生成绝对路径： 对于大型或复杂的项目，使用 / 开头的根相对路径或通过服务器端语言动态生成完整的URL路径是最健壮的方法，可以避免因URL结构变化而导致的链接失效问题。

深入理解URL解析规范是构建健壮Web应用的基础。通过精心设计URL布局和链接策略，可以确保网站在不同路由机制下都能提供流畅的用户体验。