_remap()?CodeIgniter 預設路由規則:URL 第二段決定調用控制器的哪個方法(如 example.com/blog/say 調用 Blog::say())。_remap() 方法允許完全接管此路由邏輯——若控制器存在 _remap(),**所有**請求將優先進入該方法,原本的「方法名路由」規則失效。
public function _remap($method = '', $params = []) {
// $method 為 URI 第二段內容,$params 為後續片段數組
// 此處編寫自定義路由分發邏輯
}
場景:原方法名 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 版本兼容。
場景:不同角色用戶可訪問不同控制器方法,需在進入具體業務方法前攔截校驗。
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();
}
}
$params 自動包含 URI 第三段以後的所有片段,配合 call_user_func_array 完美透傳,業務方法簽名無需改動。
若僅想攔截特定前綴(如 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();
}
在 _remap() 內部調用 $this->$method() 時,**不會再次觸發 _remap()**,框架內部已做保護,但若手動 call_user_func([$this, '_remap'], ...) 會導致無限遞歸。
_output() 實現統一響應格式化_remap() 負責「調度」,_output() 負責「輸出封裝」,兩者配合可構建極簡的 RESTful 基礎框架。
_remap() 是 CodeIgniter 靈活路由的核心鉤子,善用它可實現:
if (!$this->auth->check())掌握 _remap(),即掌握了控制器層的「總開關」。