PHP简单路由实现教程详解

本文详细介绍了如何使用PHP实现一个简单的路由系统，旨在提升URL美观性、代码可维护性和安全性，为构建MVC架构和RESTful API打下基础。文章从统一入口文件index.php入手，通过.htaccess配置重写规则，将所有请求导向该文件。随后，解析URI，定义包含路径与控制器方法映射的路由表，并使用正则表达式处理动态路由参数。此外，还探讨了如何区分GET和POST请求，以及如何利用`call_user_func_array`将参数传递给控制器方法。该方案不仅提升了URL的专业性和易记性，还实现了业务逻辑、数据处理和视图展示的分离，为Web应用的健壮性、可维护性和安全性提供了保障。

答案：PHP简单路由通过统一入口index.php解析URL，结合.htaccess重写规则，将请求路径映射到对应控制器方法。首先配置重写规则，使所有请求经由index.php处理；接着在index.php中获取URI并清理参数，定义包含路径与控制器方法映射的路由表；然后遍历路由表匹配当前URI，找到对应类和方法后实例化调用；为支持不同HTTP方法，路由表按GET、POST等分类，匹配时先判断请求方式；对于带参数的动态路由，使用正则表达式捕获路径中的变量，并通过call_user_func_array传递给控制器方法。该机制提升URL美观性、代码可维护性及安全性，是实现MVC架构与RESTful API的基础。

PHP实现简单路由，核心在于将用户请求的URL路径，通过一个统一的入口文件（通常是index.php），解析并映射到后端特定的控制器方法上。这就像给你的应用建立了一个交通指挥中心，所有的请求都先到这里报到，然后根据预设的规则被引导到正确的处理逻辑，而非直接访问某个PHP文件。在我看来，这是构建任何稍具规模的Web应用的基础，也是实现MVC（Model-View-Controller）架构的关键一步。

解决方案

要实现一个简单的PHP路由功能，我们通常会遵循以下几个步骤。这并非唯一解法，但对于理解路由机制而言，这是一个非常直观且实用的起点。

首先，我们需要一个统一的入口点，这意味着所有请求都应该被重定向到这个文件。这通常通过Apache的.htaccess或Nginx的配置来实现。以Apache为例，在项目根目录下创建一个.htaccess文件，内容大致如下：

# .htaccess
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.php [L]
</IfModule>

这段配置的意思是，如果请求的文件或目录不存在，就将请求重写到index.php。这样，所有的“不存在”的路径，比如/user/profile，都会被index.php接收。

接下来，我们创建index.php作为应用的“前置控制器”（Front Controller）。在这个文件中，我们需要：

1. 获取当前请求的URI。
2. 定义一个路由规则集合。
3. 根据URI匹配对应的规则，并执行相应的处理逻辑。

// index.php

// 1. 获取请求URI
// 这里需要清理掉查询字符串，确保只拿到路径部分
$uri = $_SERVER['REQUEST_URI'];
$uri = strtok($uri, '?'); // 移除查询字符串

// 简单处理基路径，如果你的应用不在根目录
$basePath = '/'; // 根据实际情况调整
if (strpos($uri, $basePath) === 0) {
    $uri = substr($uri, strlen($basePath));
}
$uri = trim($uri, '/'); // 移除首尾斜杠，方便匹配

// 2. 定义路由规则
// 这是一个非常基础的路由表，键是URI模式，值是对应的控制器和方法
$routes = [
    '' => ['HomeController', 'index'], // 访问 / 或 /index.php
    'about' => ['HomeController', 'about'], // 访问 /about
    'user/profile' => ['UserController', 'profile'], // 访问 /user/profile
    // 更多路由...
];

// 3. 匹配路由并分发
$foundRoute = false;
foreach ($routes as $pattern => $handler) {
    if ($pattern === $uri) {
        $controllerName = $handler[0];
        $methodName = $handler[1];
        $foundRoute = true;
        break;
    }
}

if ($foundRoute) {
    // 引入控制器文件（根据你的文件组织结构调整）
    $controllerFile = __DIR__ . '/controllers/' . $controllerName . '.php';
    if (file_exists($controllerFile)) {
        require_once $controllerFile;
        // 实例化控制器并调用方法
        if (class_exists($controllerName)) {
            $controller = new $controllerName();
            if (method_exists($controller, $methodName)) {
                $controller->$methodName();
            } else {
                // 方法不存在
                header("HTTP/1.0 404 Not Found");
                echo "Error: Method {$methodName} not found in {$controllerName}.";
            }
        } else {
            // 类不存在
            header("HTTP/1.0 404 Not Found");
            echo "Error: Controller {$controllerName} not found.";
        }
    } else {
        // 控制器文件不存在
        header("HTTP/1.0 404 Not Found");
        echo "Error: Controller file {$controllerFile} not found.";
    }
} else {
    // 404 Not Found
    header("HTTP/1.0 404 Not Found");
    echo "404 Not Found - The page you requested could not be found.";
}

为了让上述代码能够运行，我们需要创建相应的控制器文件。例如，在项目根目录下创建一个controllers文件夹，并在其中创建HomeController.php和UserController.php：

// controllers/HomeController.php
<?php

class HomeController
{
    public function index()
    {
        echo "Welcome to the homepage!";
    }

    public function about()
    {
        echo "This is the about page.";
    }
}

// controllers/UserController.php
<?php

class UserController
{
    public function profile()
    {
        echo "This is the user profile page.";
    }
}

通过这些步骤，一个非常基础的PHP路由功能就搭建起来了。它能够根据不同的URL路径，调用不同的控制器和方法来处理请求。当然，这只是冰山一角，实际应用中还需要考虑更多复杂情况。

为什么我们需要路由？难道直接访问文件不行吗？

在我刚接触Web开发时，也曾疑惑过，为什么不直接通过example.com/pages/about.php这样的方式访问文件呢？直接了当，多好。但随着项目复杂度的提升，我逐渐体会到路由的不可替代性。直接访问文件确实简单，但它带来了几个显而易见的问题。

首先是URL美观度和用户体验。example.com/about比example.com/pages/about.php?id=123看起来更简洁、专业，也更容易记忆和分享。更重要的是，它隐藏了后端实现细节，让用户感觉应用更像一个整体，而不是一堆散落的文件。

其次是代码结构和维护性。当你的应用有几十甚至上百个页面时，如果每个页面都对应一个PHP文件，那么文件的组织和管理将变得非常混乱。路由配合MVC模式，能强制你将业务逻辑（控制器）、数据处理（模型）和视图展示（视图）分离，这让代码职责清晰，模块化程度高，无论是多人协作还是后期维护，效率都会大大提升。我记得有次接手一个老项目，就是那种没有路由，直接文件访问的，找一个功能点对应的代码简直是噩梦。

再者是安全性。直接访问文件可能会暴露你的文件结构，甚至让攻击者更容易猜测到敏感文件的路径。通过路由，所有请求都经过统一的入口进行过滤和处理，你可以在这个入口处做权限验证、输入过滤等安全措施，形成一道统一的防线。

最后，它也为RESTful API设计奠定了基础。通过路由，你可以轻松地将GET /users、POST /users、GET /users/{id}等请求映射到不同的控制器方法，实现资源的增删改查，这在现代Web开发中几乎是标配。

所以，路由不仅仅是为了“好看”，更是为了构建健壮、可维护、安全的现代Web应用而生的。

如何让我的简单路由也能区分GET和POST请求？

仅仅根据URI来匹配路由，在很多场景下是远远不够的。比如，你可能希望/user路径在GET请求时显示用户列表，而在POST请求时则创建新用户。这时，我们就需要让路由系统能够区分HTTP请求方法。

实现这个功能，其实就是在我们原有的路由规则中，增加一个维度：HTTP方法。我们可以对路由表进行改造，让每个路由项不仅包含控制器和方法，还包含允许的HTTP方法。

// index.php (路由规则部分改造)

$routes = [
    'GET' => [
        '' => ['HomeController', 'index'],
        'about' => ['HomeController', 'about'],
        'user/profile' => ['UserController', 'profile'],
        'user/list' => ['UserController', 'listUsers'], // GET /user/list 获取用户列表
    ],
    'POST' => [
        'user/create' => ['UserController', 'createUser'], // POST /user/create 创建用户
    ],
    // 更多方法，如 'PUT', 'DELETE'
];

// 获取当前请求的HTTP方法
$requestMethod = $_SERVER['REQUEST_METHOD'];

$foundRoute = false;
$handler = null;

// 检查当前请求方法是否有对应的路由表
if (isset($routes[$requestMethod])) {
    foreach ($routes[$requestMethod] as $pattern => $currentHandler) {
        if ($pattern === $uri) {
            $handler = $currentHandler;
            $foundRoute = true;
            break;
        }
    }
}

if ($foundRoute) {
    $controllerName = $handler[0];
    $methodName = $handler[1];
    // 后续的控制器加载和方法调用逻辑保持不变
    // ...
} else {
    // 404 Not Found 或 405 Method Not Allowed
    // 如果URI存在但HTTP方法不匹配，可以返回405
    $uriExistsForOtherMethods = false;
    foreach ($routes as $method => $methodRoutes) {
        if ($method !== $requestMethod && isset($methodRoutes[$uri])) {
            $uriExistsForOtherMethods = true;
            break;
        }
    }

    if ($uriExistsForOtherMethods) {
        header("HTTP/1.0 405 Method Not Allowed");
        echo "405 Method Not Allowed - The requested URI exists, but not for this HTTP method.";
    } else {
        header("HTTP/1.0 404 Not Found");
        echo "404 Not Found - The page you requested could not be found.";
    }
}

相应地，你的UserController.php可能需要增加listUsers和createUser方法：

// controllers/UserController.php
<?php

class UserController
{
    public function profile()
    {
        echo "This is the user profile page.";
    }

    public function listUsers()
    {
        echo "Displaying a list of users.";
        // 这里可以从数据库获取用户列表并展示
    }

    public function createUser()
    {
        echo "Handling user creation via POST request.";
        // 这里可以处理 $_POST 数据，创建新用户
        var_dump($_POST);
    }
}

通过这种方式，你的路由系统就具备了区分HTTP方法的能力，能够更好地支持RESTful风格的API设计和更精细的请求处理。这让我的应用在处理表单提交和API请求时变得更加灵活和强大。

路由里带参数，比如/user/123，这要怎么处理？

在实际应用中，我们经常需要从URL中提取动态参数。例如，/user/123可能表示查看ID为123的用户，/posts/edit/456可能表示编辑ID为456的帖子。我们之前那种硬编码的路由表显然无法应对这种动态性。这时候，就需要引入正则表达式来匹配URL模式并捕获参数。

要实现这个，我们需要对路由规则的定义和匹配逻辑进行一次升级。

// index.php (路由规则和匹配逻辑再次改造)

$routes = [
    'GET' => [
        // 静态路由优先
        '' => ['HomeController', 'index'],
        'about' => ['HomeController', 'about'],
        'user/profile' => ['UserController', 'profile'],
        'user/list' => ['UserController', 'listUsers'],
        // 动态路由，使用正则表达式
        // '/user/(\d+)' 匹配 /user/123，(\d+) 捕获数字ID
        '#^user/(\d+)$#' => ['UserController', 'showUser'], // GET /user/{id}
        // '/posts/edit/(\d+)' 匹配 /posts/edit/456
        '#^posts/edit/(\d+)$#' => ['PostController', 'editPost'], // GET /posts/edit/{id}
    ],
    'POST' => [
        'user/create' => ['UserController', 'createUser'],
    ],
];

// ... (获取 $uri 和 $requestMethod 保持不变) ...

$foundRoute = false;
$handler = null;
$params = []; // 用于存储捕获到的URL参数

if (isset($routes[$requestMethod])) {
    foreach ($routes[$requestMethod] as $pattern => $currentHandler) {
        // 尝试进行正则匹配
        if (preg_match($pattern, $uri, $matches)) {
            $handler = $currentHandler;
            $foundRoute = true;
            // 移除第一个匹配项（整个URI），只保留捕获到的参数
            array_shift($matches);
            $params = $matches; // 捕获到的参数
            break;
        }
        // 如果不是正则表达式，按原样匹配
        if ($pattern === $uri) {
            $handler = $currentHandler;
            $foundRoute = true;
            break;
        }
    }
}

if ($foundRoute) {
    $controllerName = $handler[0];
    $methodName = $handler[1];
    // ... (控制器加载和实例化) ...

    if (class_exists($controllerName)) {
        $controller = new $controllerName();
        if (method_exists($controller, $methodName)) {
            // 将捕获到的参数传递给控制器方法
            call_user_func_array([$controller, $methodName], $params);
        } else {
            header("HTTP/1.0 404 Not Found");
            echo "Error: Method {$methodName} not found in {$controllerName}.";
        }
    } else {
        header("HTTP/1.0 404 Not Found");
        echo "Error: Controller {$controllerName} not found.";
    }
} else {
    // ... (404/405 错误处理) ...
}

现在，我们需要一个新的控制器PostController.php以及更新UserController.php来接收这些参数：

// controllers/UserController.php (新增 showUser 方法)
<?php

class UserController
{
    // ... 其他方法 ...

    public function showUser($id)
    {
        echo "Displaying user profile for ID: " . htmlspecialchars($id);
        // 这里可以根据 $id 从数据库获取用户信息并展示
    }
}

// controllers/PostController.php
<?php

class PostController
{
    public function editPost($id)
    {
        echo "Editing post with ID: " . htmlspecialchars($id);
        // 这里可以根据 $id 从数据库获取帖子信息，并展示编辑表单
    }
}

通过preg_match和call_user_func_array，我们成功地让路由系统能够识别带有动态参数的URL，并将这些参数传递给对应的控制器方法。这极大地提升了路由的灵活性和实用性，让我们可以构建出更符合语义化、更强大的Web应用。虽然正则表达式写起来可能有点烧脑，但一旦掌握，它能解决绝大多数的URL匹配需求。我个人觉得，理解了这一步，才算是真正迈入了路由系统的大门。

本篇关于《PHP简单路由实现教程详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！