Yii2建立控制器(createController)方法詳解_php執行個體

本文執行個體講述了Yii2建立控制器(createController)方法。分享給大家供大家參考，具體如下：

yii中建立控制器的是在application中的request通過UrlManager解析得出路由資訊的，然後再由yii\base\Module中的

public function runAction($route, $params = [])

方法來建立控制器，最後由控制器再執行相應的動作。

首先得明確，Yii中的路由分三種情況：

第一種是帶有模組的(module id/controller id/action id)，

第二種是帶有命名空間（子目錄）的（sub dir）/controller id/action id)

第三種是只有控制器和動作的(controller id/action id)

這三個有優先順序，所以在建立控制器的時候，也是先查看是否是模組類型的路由，如果是，則擷取這個模組，再由這個模組來建立控制器

接著再判斷是否是第二種帶有命名空間的。

public function createController($route){  //如果路由為空白，則使用預設的路由  if ($route === '') {    $route = $this->defaultRoute;  }  // double slashes or leading/ending slashes may cause substr problem  //去掉首尾的反斜線（“/”），如果路由中包含有“//”，則返回false建立失敗。  $route = trim($route, '/');  if (strpos($route, '//') !== false) {    return false;  }  /*   * 路由分三種情況，   * 一種是帶模組id的(module id/controller id/action id)，   * 一種是有命名空間（子目錄）的（sub dir）/controller id/action id)   * 一種是只有控制器和動作的(controller id/action id)   * 所以在這裡要根據第一個“/”分隔成兩部分，$id和$route資訊，   */  if (strpos($route, '/') !== false) {    list ($id, $route) = explode('/', $route, 2);  } else {    $id = $route;    $route = '';  }  // module and controller map take precedence  /*   * 查看這個id是否是模組，如果是模組，則再用這個模組來建立控制器。   * 所以，在如果一個控制器的名稱和模組名稱重複的話會優先建立模組裡面的控制器。   *   * 如果有url： http://www.yii2.com/index.php?r=test/index   * 本來是打算訪問application中的控制器裡面的test控制器，執行index動作的。   *   * 然而如果有個模組的名字為test，裡面有個IndexController   *   * 根據上面會產生$id=test，$route=index   *   * 由於在下面尋找存在這個模組，所以會執行這個test模組下面的index控制器，   * 而不會執行application裡面的test控制器的index動作   */  $module = $this->getModule($id);  if ($module !== null) {    return $module->createController($route);  }  //如果在controllerMap數組中指定了控制器映射，會優先根據這個裡面的映射來建立控制器  if (isset($this->controllerMap[$id])) {    $controller = Yii::createObject($this->controllerMap[$id], [$id, $this]);    return [$controller, $route];  }  /*   * 如果這個時候$route中還有“/”,也就是說原來的路由為home/index/aa   * $id:home（不是模組）   * $route:index/aa   * 由於經過上面得知home不為模組，所以這個為命名空間（子目錄），   *   * 再經過下面處理後為   * $id:home/index 命名空間（子目錄）home下面的index控制器   * $route:aaa   *   */  if (($pos = strrpos($route, '/')) !== false) {    $id .= '/' . substr($route, 0, $pos);    $route = substr($route, $pos + 1);  }    /*     * $id:home/index     * $route:aaa     */  $controller = $this->createControllerByID($id);  if ($controller === null && $route !== '') {      //如果建立失敗，再加上route作為id再次建立    $controller = $this->createControllerByID($id . '/' . $route);    $route = '';  }  return $controller === null ? false : [$controller, $route];}

在這個函數中$id就有兩種情況，一種是前面帶有命名空間的，一種是直接就一個控制器ID的。

public function createControllerByID($id){    if (!preg_match('%^[a-z0-9\\-_/]+$%', $id)) {      return null;    }    /*     * 如果$id中有“/”，則前面的為目錄，後面的為類     *     */    $pos = strrpos($id, '/');    if ($pos === false) {      $prefix = '';      $className = $id;    } else {      $prefix = substr($id, 0, $pos + 1);      $className = substr($id, $pos + 1);    }    //組建控制器的類IndexController    $className = str_replace(' ', '', ucwords(str_replace('-', ' ', $className))) . 'Controller';    //如果有首碼（也就是有目錄、命名空間），則在類前面加上命名空間    $className = ltrim($this->controllerNamespace . '\\' . str_replace('/', '\\', $prefix) . $className, '\\');    //如果類不存在，或者類名稱包含“-”，則出錯，    if (strpos($className, '-') !== false || !class_exists($className)) {      return null;    }    //下面就是建立類了    if (is_subclass_of($className, 'yii\base\Controller')) {      return new $className($id, $this);    } elseif (YII_DEBUG) {      throw new InvalidConfigException("Controller class must extend from \\yii\\base\\Controller.");    } else {      return null;    }}

這個過程就結束了，然後再由建立出來的控制器執行它裡面的動作

public function runAction($route, $params = []){  $parts = $this->createController($route);  if (is_array($parts)) {    /** @var Controller $controller */    list($controller, $actionID) = $parts;    $oldController = Yii::$app->controller;    Yii::$app->controller = $controller;    //控制器執行相應的動作    $result = $controller->runAction($actionID, $params);    Yii::$app->controller = $oldController;    return $result;  } else {    $id = $this->getUniqueId();    throw new InvalidRouteException('Unable to resolve the request "' . ($id === '' ? $route : $id . '/' . $route) . '".');  }}

更多關於Yii相關內容感興趣的讀者可查看本站專題：《Yii架構入門及常用技巧總結》、《php優秀開發架構總結》、《smarty模板入門基礎教程》、《php物件導向程式設計入門教程》、《php字串(string)用法總結》、《php+mysql資料庫操作入門教程》及《php常見資料庫操作技巧匯總》

希望本文所述對大家基於Yii架構的PHP程式設計有所協助。

