萬盛學電腦網

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

CodeIgniter _remap() 方法深度解析:路由重寫與權限控制實戰

什麼是 _remap()?

CodeIgniter 預設路由規則:URL 第二段決定調用控制器的哪個方法(如 example.com/blog/say 調用 Blog::say())。_remap() 方法允許完全接管此路由邏輯——若控制器存在 _remap(),**所有**請求將優先進入該方法,原本的「方法名路由」規則失效。

public function _remap($method = '', $params = []) {
    // $method 為 URI 第二段內容,$params 為後續片段數組
    // 此處編寫自定義路由分發邏輯
}

核心用例一:URL 美化與方法名隱藏

場景:原方法名 say() 語義不清,希望對外暴露為 hello(),但內部邏輯不變。

public function _remap($method, $params = []) {
    $map = [
        'hello' => 'say',      // 公開 hello -> 內部 say
        'list'  => 'index',    // 公開 list  -> 內部 index
        'view'  => 'detail',   // 公開 view  -> 內部 detail
    ];

    $internalMethod = $map[$method] ?? $method; // 未映射則保持原名
    if (method_exists($this, $internalMethod)) {
        return call_user_func_array([$this, $internalMethod], $params);
    }
    show_404(); // 方法不存在拋 404
}

效果:訪問 /blog/hello 實際執行 say(),外部完全感知不到內部方法名,便於重構與 API 版本兼容。

核心用例二:方法級權限控制(RBAC 簡易實現)

場景:不同角色用戶可訪問不同控制器方法,需在進入具體業務方法前攔截校驗。

public function _remap($method, $params = []) {
    // 1. 獲取當前用戶角色(假設存於 Session)
    $userType = $this->session->userdata('user_type') ?? 'guest';

    // 2. 定義權限矩陣:角色 -> 允許的方法列表(* 代表全部)
    $accessControl = [
        'admin'  => ['*'],
        'editor' => ['index', 'create', 'edit', 'publish'],
        'author' => ['index', 'create', 'edit'],
        'guest'  => ['index', 'view'],
    ];

    $allowed = $accessControl[$userType] ?? [];
    $hasAccess = in_array('*', $allowed) || in_array($method, $allowed);

    // 3. 權限判定與分發
    if ($hasAccess && method_exists($this, $method)) {
        return call_user_func_array([$this, $method], $params);
    }

    // 4. 無權限或方法不存在:統一處理
    if (!$hasAccess) {
        $this->load->view('errors/forbidden', ['method' => $method]);
    } else {
        show_404();
    }
}

進階技巧與注意事項

1. 參數傳遞透傳

$params 自動包含 URI 第三段以後的所有片段,配合 call_user_func_array 完美透傳,業務方法簽名無需改動。

2. 保留預設行為的混合模式

若僅想攔截特定前綴(如 api_*),其餘走預設路由:

public function _remap($method, $params = []) {
    if (strpos($method, 'api_') === 0) {
        return $this->handleApi($method, $params); // 統一 API 入口
    }
    // 非 api_ 開頭,手動觸發預設路由行為
    if (method_exists($this, $method)) {
        return call_user_func_array([$this, $method], $params);
    }
    show_404();
}

3. 避免遞歸調用陷阱

在 _remap() 內部調用 $this->$method() 時,**不會再次觸發 _remap()**,框架內部已做保護,但若手動 call_user_func([$this, '_remap'], ...) 會導致無限遞歸。

4. 結合 _output() 實現統一響應格式化

_remap() 負責「調度」,_output() 負責「輸出封裝」,兩者配合可構建極簡的 RESTful 基礎框架。

總結

_remap() 是 CodeIgniter 靈活路由的核心鉤子,善用它可實現:

  • 對外 API 與內部實現解耦
  • 集中式權限攔截,避免每個方法重複 if (!$this->auth->check())
  • 舊版本 API 兼容層(映射舊方法名到新實現)
  • 統一異常處理、日誌記錄、性能埋點

掌握 _remap(),即掌握了控制器層的「總開關」。

copyright © 萬盛學電腦網 all rights reserved