本文深入探讨了在php自定义路由中，如何利用正则表达式从url中提取动态参数，并通过`call_user_func_array`机制将这些参数灵活地传递给控制器方法。文章通过构建一个简化的路由系统，详细阐述了路由匹配、参数捕获以及方法调用的全过程，并提供了实用的代码示例和注意事项，旨在帮助开发者理解和实现高效、可扩展的url路由功能。
1. 理解PHP路由与参数传递的需求
在现代Web应用开发中，URL路由是核心组件之一，它负责将用户请求的URL映射到应用程序中相应的控制器方法。一个常见的需求是，URL中包含动态部分（例如ID、名称等），这些动态部分需要作为参数传递给被调用的控制器方法。PHP提供了call_user_func_array函数，它允许我们动态地调用一个函数或对象方法，并将一个数组作为参数传递。结合正则表达式来解析URL，我们可以构建一个强大且灵活的路由系统。
2. 构建基础路由系统
为了实现参数的动态传递，我们需要一个能够定义路由规则、匹配URL并执行相应动作的路由类。
2.1 Router类结构
首先，定义一个Router类，用于管理和分发路由。
<?php
error_reporting(E_ALL);
ini_set('display_errors', 'On');
final class Router
{
/**
* 存储所有路由规则，键为正则表达式，值为可调用对象（callable）
* 示例: (POST|GET)_/testMultiple/(\d+)/(\S+)
* @var array<string, callable>
*/
private array $routes = [];
/**
* 注册路由规则
*
* @param string $path URL路径模式，可包含正则表达式捕获组
* @param callable $action 匹配成功后要执行的可调用对象（通常是控制器方法）
* @param string $methods 允许的HTTP方法，默认为'POST|GET'
* @return void
*/
public function any(string $path, callable $action, string $methods = 'POST|GET'): void
{
// 简单的安全检查，防止路径注入
if (strpos($path, '..') !== false) {
return;
}
// 将HTTP方法和路径模式组合成一个正则表达式键
$this->routes['(' . $methods . ')_' . $path] = $action;
}
/**
* 根据当前请求的URL调用匹配的路由
*
* @param string $path 当前请求的URI
* @return string 路由动作的执行结果
* @throws Exception 如果未找到匹配的路由
*/
public function callRoute(string $path): string
{
// 构造完整的匹配路径，包括HTTP方法和URI
// 示例: GET_/testMultiple/123/test
$requestPath = $_SERVER['REQUEST_METHOD'] . '_' . parse_url($path, PHP_URL_PATH);
// 遍历所有已注册的路由规则
foreach ($this->routes as $routePattern => $action) {
// 构建完整的正则表达式，包括起始和结束锚点，并支持可选的末尾斜杠
$regEx = "~^$routePattern/?$~i";
$matches = [];
// 使用preg_match尝试匹配当前请求路径
if (!preg_match($regEx, $requestPath, $matches)) {
continue; // 不匹配则尝试下一个路由
}
// 如果匹配成功，我们需要从$matches数组中提取真正的URL参数。
// preg_match的结果中：
// $matches[0] 是整个匹配到的字符串
// $matches[1] 是第一个捕获组（在这里是HTTP方法，如'GET'）
// $matches[2] 及以后是URL路径中的参数捕获组
array_shift($matches); // 移除$matches[0] (完整匹配字符串)
array_shift($matches); // 移除$matches[1] (HTTP方法)
// 剩余的$matches元素即为从URL中捕获到的参数
$arguments = $matches;
// 使用call_user_func_array调用控制器方法，并传入捕获到的参数
return call_user_func_array($action, $arguments);
}
// 如果遍历完所有路由都未找到匹配项，则抛出异常
throw new Exception(sprintf('Route %s not found', $requestPath));
}
}2.2 控制器示例
为了演示参数如何被传递，我们创建一个TestController，包含不同签名的方法。
立即学习“PHP免费学习笔记（深入）”；
final class TestController
{
public function indexAction(): string
{
return 'Hello world';
}
public function testPost(): string
{
return 'Hello this is post only';
}
// 接收一个字符串参数
public function testAction(string $parameter1): string
{
return 'Hello ' . $parameter1;
}
// 接收一个可选的字符串参数
public function testOptionalAction(?string $parameter1 = null): string
{
return 'Hello ' . ($parameter1 ?? 'Guest');
}
// 接收多个不同类型的参数
public function testMultiple(int $parameter1, string $parameter2): string
{
return 'The first value is ' . $parameter1 . ' and the second is ' . $parameter2;
}
}3. 路由定义与参数传递实践
现在，我们将Router和TestController结合起来，定义路由并观察参数的传递。
// 简单的服务容器（用于实例化控制器）
$services = [];
$services[TestController::class] = function () use ($services) {
return new TestController();
};
// 实例化路由器
$router = new Router();
// 定义路由规则
// 1. 根路由
$router->any('/', [$services[TestController::class](), 'indexAction']);
// 2. 带有单个字符串参数的路由
// (\S+) 匹配任意非空白字符一次或多次
$router->any('/test/(\S+)', [$services[TestController::class](), 'testAction']);
// 3. 带有可选参数的路由
// /?(\S+)? 匹配可选的斜杠，后面跟着可选的非空白字符
$router->any('/testOptional/?(\S+)?', [$services[TestController::class](), 'testOptionalAction']);
// 4. 带有多个不同类型参数的路由
// (\d+) 匹配一个或多个数字 (int)
// (\S+) 匹配一个或多个非空白字符 (string)
$router->any('/testMultiple/(\d+)/(\S+)', [$services[TestController::class](), 'testMultiple']);
// 5. 仅限POST请求的路由
$router->any('/testJustPost', [$services[TestController::class](), 'testPost'], 'POST');
// 执行路由分发
// $_SERVER['REQUEST_URI'] 包含了完整的请求URI，例如 "/testMultiple/123/example"
echo $router->callRoute($_SERVER['REQUEST_URI']);4. 关键点与注意事项
-
正则表达式：
- (\S+)：匹配一个或多个非空白字符，常用于捕获字符串参数。
- (\d+)：匹配一个或多个数字，常用于捕获整数ID。
- /?(\S+)?：用于匹配可选的路径段和参数。?使前面的模式可选。
- 捕获组()中的内容会被preg_match捕获到$matches数组中。
-
preg_match结果处理：
- $matches[0]始终是完整匹配的字符串。
- 在我们的Router实现中，由于路由模式是('POST|GET')_开头，所以$matches[1]会是HTTP方法。
- 真正的URL参数从$matches[2]开始。因此，通过两次array_shift操作，可以确保$arguments数组中只包含需要传递给控制器方法的参数。
-
call_user_func_array：
- 它接收两个参数：第一个是可调用对象（可以是['ClassName', 'methodName']数组或匿名函数），第二个是参数数组。
- call_user_func_array会将参数数组的每个元素按顺序作为独立参数传递给目标方法。
-
类型提示与强制转换：
- 在TestController的方法签名中，我们使用了PHP 7+的类型提示（如string $parameter1, int $parameter1）。
- 当preg_match捕获到字符串时，PHP会在调用方法时尝试根据类型提示进行隐式类型转换。例如，如果(\d+)捕获到"123"，而方法签名是int $param，PHP会自动将其转换为整数。
-
错误处理：
- 在callRoute方法中，如果所有路由都未匹配，会抛出Exception。在实际应用中，这通常会导向一个404错误页面。
-
安全考虑：
- any方法中简单的strpos($path, '..') !== false检查可以防止一些基本的目录遍历攻击，但对于生产环境，应采用更全面的输入验证和过滤机制。
-
依赖注入：
- 示例中使用了简化的服务容器$services来实例化TestController。在大型应用中，推荐使用更成熟的依赖注入容器（如Symfony的DependencyInjection组件或PHP-DI）来管理控制器及其依赖。
-
生产环境建议：
- 虽然自定义路由有助于理解原理，但对于生产环境，强烈建议使用经过充分测试和优化的第三方路由库，例如nikic/fast-route。这些库通常提供更丰富的功能（如中间件、命名路由、路由缓存等）和更好的性能。
总结
通过结合正则表达式和call_user_func_array，我们可以灵活地构建PHP自定义路由，实现从URL中动态提取参数并将其传递给控制器方法的功能。这种机制是许多现代PHP框架路由系统的核心原理。理解并掌握这一模式，不仅能帮助我们更好地调试和扩展现有框架，也能为开发特定需求的轻量级应用提供坚实的基础。然而，在实际项目中，权衡开发效率和维护成本，选择成熟的第三方路由库往往是更明智的选择。
