Module类中的辅助功能方法:

     /**
      * Returns an ID that uniquely identifies this module among all modules within the current application.
      * 返回模块的唯一标识
      * Note that if the module is an application, an empty string will be returned.
      * @return string the unique ID of the module.
      */
     public function getUniqueId()
     {
         //三元运算符,如果当前模块有父模块,则返回[父模块ID/当前模块ID]的格式作为唯一ID,否则只返回当前模块ID
         return $this->module ? ltrim($this->module->getUniqueId() . '/' . $this->id, '/') : $this->id;
     }

     /**
      * Returns the root directory of the module.
      * 返回当前模块的根路径
      * It defaults to the directory containing the module class file.
      * @return string the root directory of the module.
      */
     public function getBasePath()
     {
         if ($this->_basePath === null) {
             $class = new \ReflectionClass($this);//生成当前类的反射对象
             $this->_basePath = dirname($class->getFileName());//getFileName()取得类定义的路径
         }

         return $this->_basePath;
     }

     /**
      * Sets the root directory of the module.
      * 设置当前模块的根路径
      * This method can only be invoked at the beginning of the constructor.
      * @param string $path the root directory of the module. This can be either a directory name or a path alias.
      * @throws InvalidParamException if the directory does not exist.
      */
     public function setBasePath($path)
     {
         $path = Yii::getAlias($path);
         $p = realpath($path);
         if ($p !== false && is_dir($p)) {
             $this->_basePath = $p;
         } else {
             throw new InvalidParamException("The directory does not exist: $path");
         }
     }

     /**
      * Returns the directory that contains the controller classes according to [[controllerNamespace]].
      * 根据控制器的命名空间返回控制器的目录路径
      * Note that in order for this method to return a value, you must define
      * an alias for the root namespace of [[controllerNamespace]].
      * 为了使该方法返回正确的值,必须为[[controllerNamespace]]定义一个根别名
      * @return string the directory that contains the controller classes.
      * @throws InvalidParamException if there is no alias defined for the root namespace of [[controllerNamespace]].
      */
     public function getControllerPath()
     {
         //通过将命名空间转换为路径构造别名路径,然后通过getAlias方法取得控制器的绝对路径
         return Yii::getAlias('@' . str_replace('\\', '/', $this->controllerNamespace));
     }

     /**
      * Returns the directory that contains the view files for this module.
      * 取得当前模块的视图文件目录路径
      * @return string the root directory of view files. Defaults to "[[basePath]]/views".
      */
     public function getViewPath()
     {
         if ($this->_viewPath === null) {
             $this->_viewPath = $this->getBasePath() . DIRECTORY_SEPARATOR . 'views';//getBasePath()返回当前模块的根路径,然后拼接出视图文件路径
         }
         return $this->_viewPath;
     }

     /**
      * Sets the directory that contains the view files.
      * 设置视图文件目录路径
      * @param string $path the root directory of view files.
      * @throws InvalidParamException if the directory is invalid
      */
     public function setViewPath($path)
     {
         $this->_viewPath = Yii::getAlias($path);
     }

     /**
      * Returns the directory that contains layout view files for this module.
      * 取得当前模块的布局文件路径
      * @return string the root directory of layout files. Defaults to "[[viewPath]]/layouts".
      */
     public function getLayoutPath()
     {
         if ($this->_layoutPath === null) {
             $this->_layoutPath = $this->getViewPath() . DIRECTORY_SEPARATOR . 'layouts';//getBasePath()返回当前模块的根路径,然后拼接出布局文件目录路径
         }

         return $this->_layoutPath;
     }

     /**
      * Sets the directory that contains the layout files.
      * 设置当前模块的布局文件路径
      * @param string $path the root directory or path alias of layout files.
      * @throws InvalidParamException if the directory is invalid
      */
     public function setLayoutPath($path)
     {
         $this->_layoutPath = Yii::getAlias($path);
     }

     /**
      * Defines path aliases.
      * 定义路径别名
      * This method calls [[Yii::setAlias()]] to register the path aliases.
      * This method is provided so that you can define path aliases when configuring a module.
      * 通过调用[[Yii::setAlias()]]注册路径别名,方便在配置模块的时候定义路径别名
      * @property array list of path aliases to be defined. The array keys are alias names
      * (must start with '@') and the array values are the corresponding paths or aliases.
      * See [[setAliases()]] for an example.
      * @param array $aliases list of path aliases to be defined. The array keys are alias names
      * (must start with '@') and the array values are the corresponding paths or aliases.
      * For example,
      * 传入测参数的格式,键名为别名名称,以@开始,键值为对应的路径
      * ```php
      * [
      *     '@models' => '@app/models', // an existing alias
      *     '@backend' => __DIR__ . '/../backend',  // a directory
      * ]
      * ```
      */
     public function setAliases($aliases)
     {
         foreach ($aliases as $name => $alias) {
             Yii::setAlias($name, $alias);//调用[[Yii::setAlias()]]注册路径别名
         }
     }

     /**
      * Checks whether the child module of the specified ID exists.
      * This method supports checking the existence of both child and grand child modules.
      * @param string $id module ID. For grand child modules, use ID path relative to this module (e.g. `admin/content`).
      * @return boolean whether the named module exists. Both loaded and unloaded modules
      * are considered.
      */
     public function hasModule($id)
     {
         if (($pos = strpos($id, '/')) !== false) {//如果模块ID格式为 `admin/content`
             // sub-module
             $module = $this->getModule(substr($id, 0, $pos));//取出当前模块的子模块

             return $module === null ? false : $module->hasModule(substr($id, $pos + 1));//如果没有取到,返回false,否则判断子模块的子模块
         } else {//模块ID没有父模块的情况,直接判断_modules数组中是否有值
             return isset($this->_modules[$id]);
         }
     }

Yii源码阅读笔记(二十三)的更多相关文章

  1. Yii源码阅读笔记(十三)

    Model类,集中整个应用的数据和业务逻辑: namespace yii\base; use Yii; use ArrayAccess; use ArrayObject; use ArrayItera ...

  2. Yii源码阅读笔记(一)

    今天开始阅读yii2的源码,想深入了解一下yii框架的工作原理,同时学习一下优秀的编码规范和风格.在此记录一下阅读中的小心得. 每个框架都有一个入口文件,首先从入口文件开始,yii2的入口文件位于we ...

  3. werkzeug源码阅读笔记(二) 下

    wsgi.py----第二部分 pop_path_info()函数 先测试一下这个函数的作用: >>> from werkzeug.wsgi import pop_path_info ...

  4. werkzeug源码阅读笔记(二) 上

    因为第一部分是关于初始化的部分的,我就没有发布出来~ wsgi.py----第一部分 在分析这个模块之前, 需要了解一下WSGI, 大致了解了之后再继续~ get_current_url()函数 很明 ...

  5. Detectron2源码阅读笔记-(二)Registry&build_*方法

    ​ Trainer解析 我们继续Detectron2代码阅读笔记-(一)中的内容. 上图画出了detectron2文件夹中的三个子文件夹(tools,config,engine)之间的关系.那么剩下的 ...

  6. Yii源码阅读笔记(二)

    接下来阅读BaseYii.php vendor/yiisoft/yii2/BaseYii.php—— namespace yii; use yii\base\InvalidConfigExceptio ...

  7. Yii源码阅读笔记(三十三)

    ServiceLocator,服务定位类,用于yii2中的依赖注入,通过以ID为索引的方式缓存服务或则组件的实例来定位服务或者组件: namespace yii\di; use Yii; use Cl ...

  8. Yii源码阅读笔记(三十二)

    web/Application类的注释,继承base/Application类,针对web应用的一些处理: namespace yii\web; use Yii; use yii\base\Inval ...

  9. Yii源码阅读笔记(二十九)

    动态模型DynamicModel类,用于实现模型内数据验证: namespace yii\base; use yii\validators\Validator; /** * DynamicModel ...

随机推荐

  1. sring mvc 返回值至jsp界面的几种方式

    Spring 通过Controller 向 View 传值的方法有以下四种 HttpServletRequest ModelAndView Map<String, Object> map ...

  2. 2014-2015 ACM-ICPC, NEERC, Moscow Subregional Contest D. Do it Right!

    D. Do it Right! time limit per test 2 seconds memory limit per test 256 megabytes input standard inp ...

  3. Windows下查看端口冲突的进程

    在tomcat部署中,经常遇到80端口被占用,下面总结了两条查看端口进程的方法. 查看端口方法: netstat -aon|findstr "80"   如图,使用80端口的进程列 ...

  4. Android Drawable

    1. Shape 属性: (1) solid ( 填充 ) 参数:android:color ( 填充的颜色 ) (2) gradient ( 渐变 ) 参数:android:startColor ( ...

  5. IOS学习笔记25—HTTP操作之ASIHTTPRequest

    IOS学习笔记25—HTTP操作之ASIHTTPRequest 分类: iOS2012-08-12 10:04 7734人阅读 评论(3) 收藏 举报 iosios5网络wrapper框架新浪微博 A ...

  6. URAL 1427. SMS(DP+单调队列)

    题目链接 我用的比较传统的办法...单调队列优化了一下,写的有点搓,不管怎样过了...两个单调队列,存两个东西,预处理一个标记数组存... #include <iostream> #inc ...

  7. Poj 3250 单调栈

    1.Poj 3250  Bad Hair Day 2.链接:http://poj.org/problem?id=3250 3.总结:单调栈 题意:n头牛,当i>j,j在i的右边并且i与j之间的所 ...

  8. MySQL实用技巧

    自增Id重新计数  TRUNCATE TABLE 表名 获取最后插入数据的ID   SELECT LAST_INSERT_ID(); 使用"id1,id2,id3"当参数  FIN ...

  9. nginx 中 PHP 调用PEAR.php遇到的问题

    公司有个老项目,写了很多年了,是在apache 上面跑的,无意间,我想让它跑到nginx上,结果遇到了PEAR.php的问题,先安装pear 基本安富有就是 wget http://pear.php. ...

  10. PHP 下的SSL加密设置

    这个是报的错[Composer\Downloader\TransportException] The . OpenSSL Error messages: error::SSL routines:SSL ...