如何将URL路径参数传递到PHP文件？自定义PHP路由问题

我编写了一个基础的PHP路由系统，但遇到了参数传递的难题：当路由指向PHP文件时（比如Router::get("/user/:username", "user.php");），无法将URL中的username参数传递到user.php文件内，用$_GET['username']也无效，因为URL不含?查询字符串。以下是我的实现代码：

<?php

class Router{

    public static $routes = [];

    public static function get($route, $callback){
        self::$routes[] = [
            'route' => $route,
            'callback' => $callback,
            'method' => 'GET'
        ];
    }

    public static function resolve(){
        $path = $_SERVER['REQUEST_URI'];
        $httpMethod = $_SERVER['REQUEST_METHOD'];

        $routeMatch = false;

        foreach(self::$routes as $route){
            $pattern = "@^" . preg_replace('/\\:[a-zA-Z0-9\_\-]+/', '([a-zA-Z0-9\-\_]+)', preg_quote($route['route'])) . "$@D";
            $matches = Array();

            if(preg_match($pattern, $path, $matches) && $httpMethod === $route['method']) {
                $routeMatch = true;
                array_shift($matches);

                if(is_callable($route['callback'])){
                    call_user_func_array($route['callback'], $matches);
                }else{
                    self::render($route['callback']);
                }
            }
        }

        if(!$routeMatch){
            self::notFound();
        }
    }

    public static function render($file, $viewsFolder='./views/'){
        include($viewsFolder . $file);
    }

    public static function notFound(){
        http_response_code(400);
        include('./views/404.php');
        exit();
    }
}

Router::get("/", "home.php");
Router::get("/user/:id", function($val1) {
    $data = array(
        "Nicole",
        "Sarah",
        "Jinx",
        "Sarai"
    );

    echo $data[$val1] ?? "No data";
});
Router::get("/user/:username", "user.php");
Router::get("/user/profile/:id", "admin.php");
Router::resolve();

解决方法 #

要实现路由参数到PHP文件的传递，你可以通过以下两种方式修改代码：

1. 注入参数到$_GET全局变量 #

修改路由解析逻辑，提取路由中的参数名称，将匹配到的参数值赋值给$_GET，这样被包含的PHP文件就能直接通过$_GET访问参数：

<?php

class Router{

    public static $routes = [];

    public static function get($route, $callback){
        self::$routes[] = [
            'route' => $route,
            'callback' => $callback,
            'method' => 'GET'
        ];
    }

    public static function resolve(){
        $path = $_SERVER['REQUEST_URI'];
        // 移除URL中的查询字符串（如果存在）
        $path = strtok($path, '?');
        $httpMethod = $_SERVER['REQUEST_METHOD'];

        $routeMatch = false;

        foreach(self::$routes as $route){
            // 提取路由中的参数名（如:username中的username）
            preg_match_all('/\:([a-zA-Z0-9\_\-]+)/', $route['route'], $paramNames);
            $paramNames = $paramNames[1];
            
            // 转换路由为正则表达式
            $pattern = "@^" . preg_replace('/\\:[a-zA-Z0-9\_\-]+/', '([a-zA-Z0-9\-\_]+)', preg_quote($route['route'])) . "$@D";
            $matches = [];

            if(preg_match($pattern, $path, $matches) && $httpMethod === $route['method']) {
                $routeMatch = true;
                array_shift($matches);
                
                if(is_callable($route['callback'])){
                    call_user_func_array($route['callback'], $matches);
                }else{
                    // 将参数绑定到$_GET
                    if(!empty($paramNames)){
                        foreach($paramNames as $index => $name){
                            $_GET[$name] = $matches[$index];
                        }
                    }
                    self::render($route['callback']);
                }
            }
        }

        if(!$routeMatch){
            self::notFound();
        }
    }

    public static function render($file, $viewsFolder='./views/'){
        include($viewsFolder . $file);
    }

    public static function notFound(){
        http_response_code(404); // 修正为404状态码，符合语义
        include('./views/404.php');
        exit();
    }
}

// 路由定义不变
Router::get("/", "home.php");
Router::get("/user/:id", function($val1) {
    $data = array(
        "Nicole",
        "Sarah",
        "Jinx",
        "Sarai"
    );
    echo $data[$val1] ?? "No data";
});
Router::get("/user/:username", "user.php");
Router::get("/user/profile/:id", "admin.php");
Router::resolve();

此时在user.php中，直接使用$_GET['username']就能获取URL中的参数值。

2. 在render方法中直接传递变量 #

另一种方式是将参数作为变量传递给被包含的文件，无需依赖全局变量：

// 修改resolve方法中调用render的逻辑
self::render($route['callback'], $matches, $paramNames);

// 修改render方法
public static function render($file, $params = [], $paramNames = [], $viewsFolder='./views/'){
    // 将参数名与值对应，生成可直接使用的变量
    if(!empty($paramNames) && !empty($params)){
        foreach($paramNames as $index => $name){
            $$name = $params[$index];
        }
    }
    include($viewsFolder . $file);
}

这种方式下，在user.php中可以直接使用$username变量访问参数值，无需调用$_GET。

内容的提问来源于stack exchange，提问作者mitas1c