当前位置：首页 > PHP

php路由实现

2026-03-12 21:42:02PHP

路由的基本概念

路由（Routing）是Web开发中将URL请求映射到特定处理逻辑的机制。在PHP中实现路由通常涉及解析URL、匹配预定义规则并执行对应的控制器或闭包函数。

基于原生PHP的路由实现

创建.htaccess文件（Apache环境） 重写规则将所有请求指向入口文件（如index.php）：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?url=$1 [L,QSA]

解析URL参数 在index.php中获取URL路径并拆分：

$request = $_SERVER['REQUEST_URI'];
$url = trim($request, '/');
$urlParts = explode('/', $url);

定义路由表 使用关联数组存储路由映射：

$routes = [
    '' => 'HomeController@index',
    'user/profile' => 'UserController@profile',
    'api/get-data' => function() { return json_encode(['data' => 'value']); }
];

路由匹配与执行 实现简单的路由调度逻辑：

if (array_key_exists($url, $routes)) {
    $handler = $routes[$url];
    if (is_callable($handler)) {
        echo $handler();
    } elseif (is_string($handler)) {
        list($controller, $method) = explode('@', $handler);
        require_once "controllers/$controller.php";
        (new $controller())->$method();
    }
} else {
    http_response_code(404);
    echo '404 Not Found';
}

使用框架的路由实现

Laravel路由示例 定义web.php路由文件：

Route::get('/', 'HomeController@index');
Route::post('/submit', 'FormController@submit');
Route::match(['get', 'post'], '/contact', 'ContactController@handle');

Symfony路由配置 通过注解定义路由：

use Symfony\Component\Routing\Annotation\Route;

class UserController {
    /
     * @Route("/user/{id}", name="user_show", requirements={"id"="\d+"})
     */
    public function show(int $id) { /* ... */ }
}

动态路由参数处理

捕获路径参数 实现带变量的路由模式：

$routes = [
    'user/{id}' => 'UserController@show',
    'post/{slug}' => 'PostController@detail'
];

foreach ($routes as $pattern => $handler) {
    $regex = '#^' . preg_replace('/\{(\w+)\}/', '(?P<$1>[^/]+)', $pattern) . '$#';
    if (preg_match($regex, $url, $matches)) {
        $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
        // 执行handler并传入参数
        break;
    }
}

路由分组与中间件

实现路由分组 通过前缀管理相关路由：

$groupPrefix = 'admin';
if (strpos($url, $groupPrefix) === 0) {
    $url = substr($url, strlen($groupPrefix) + 1);
    // 应用中间件逻辑
    checkAdminAuth();
    // 加载admin相关路由
}

RESTful路由设计

HTTP方法区分 根据请求方法处理不同操作：

php路由实现

$method = $_SERVER['REQUEST_METHOD'];
switch ($method) {
    case 'GET':
        if ($url === 'api/users') { /* 获取列表 */ }
        break;
    case 'POST':
        if ($url === 'api/users') { /* 创建资源 */ }
        break;
}