萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP RESTful 路由分發類實作

輕量級 RESTful 路由器 Router 類

透過路由表匹配 HTTP 方法與 URI 模式,自動提取參數並分發至對應 Action 類別方法。支援動態參數 :id、:slug 等。

核心程式碼

<?php
class Router {
    private $routers = [
        ['name'=>'userlist', 'pattern'=>'get /user',        'action'=>'User#get'],
        ['name'=>'userinfo', 'pattern'=>'get /user/:id',     'action'=>'User#getById'],
        ['name'=>'useradd',  'pattern'=>'post /user',        'action'=>'User#add'],
        ['name'=>'userupd',  'pattern'=>'put /user/:id',      'action'=>'User#update'],
        ['name'=>'userdel',  'pattern'=>'delete /user/:id',   'action'=>'User#delete'],
    ];

    public function dispatch() {
        $url    = $_SERVER['REQUEST_URI'];
        $method = $_SERVER['REQUEST_METHOD'];

        foreach ($this->routers as $router) {
            [$patternMethod, $patternUri] = explode(' ', $router['pattern']);
            if (strcasecmp($patternMethod, $method) !== 0) continue;

            $params = $this->checkUrl($url, $patternUri);
            if ($params !== null) {
                array_shift($params); // 移除完整匹配項
                return $this->invoke($router['action'], $params);
            }
        }
        header('HTTP/1.0 404 Not Found');
        echo '404 error';
    }

    private function invoke($action, $params) {
        [$className, $methodName] = explode('#', $action);
        $className .= 'Action';
        $file = __DIR__ . '/action/' . $className . '.php';

        if (!file_exists($file)) { echo '404: Action not found'; return; }
        require $file;

        $rc = new ReflectionClass($className);
        if (!$rc->hasMethod($methodName)) { echo '404: Method not found'; return; }

        $instance = $rc->newInstance();
        $method = $rc->getMethod($methodName);
        $method->invokeArgs($instance, $params);
    }

    private function checkUrl($url, $pattern) {
        $pattern = '/' . str_replace('/', '\/', trim($pattern, '/')) . '/?$/';
        $pattern = str_replace(':id', '([^/]+)', $pattern);
        $pattern = str_replace(':slug', '([^/]+)', $pattern);

        if (preg_match($pattern, $url, $matches)) {
            return $matches;
        }
        return null;
    }
}
?>

使用方式

$router = new Router();
$router->dispatch(); // 放在 index.php 入口

Action 類別範例 action/UserAction.php

<?php
class UserAction {
    public function get() { echo '用戶列表'; }
    public function getById($id) { echo "用戶詳情 ID: $id"; }
    public function add() { echo '新增用戶'; }
    public function update($id) { echo "更新用戶 ID: $id"; }
    public function delete($id) { echo "刪除用戶 ID: $id"; }
}
?>

擴展建議

  • 加入中介軟體(Middleware)陣列支援認證、限流
  • 路由表改為從設定檔載入(YAML/JSON)
  • 支援正則群組、可選參數、子域名路由
  • 整合 PSR-7 Request/Response 物件

此類別僅 80 行核心代碼,適合中小型專案或教學理解路由原理。

copyright © 萬盛學電腦網 all rights reserved