别名(Aliases).pdfVIP

别名 （Aliases） 别名 （Aliases） 别名⽤来表⽰⽂件路径和 URL ，这样就避免了在代码中硬编码⼀些绝对路径和 URL 。⼀个别名必 以 @ 字符开头，以区别于传统的⽂件路径和 URL 。Yii 预定义了 ⼤量可⽤的别名。例如，别名 @yii 指的是 Yii 框架本⾝的安装⽬录，⽽ @web 表⽰ 的是当前运⾏应⽤的根 URL 。 定义别名 你可以调⽤ Yii::setAlias() 来给⽂件路径或 URL 定义别名： // ⽂件路径的别名 Yii::setAlias(@foo, /path/to/foo); // URL 的别名 Yii::setAlias(@bar, http://www .example. om); 注意：别名所指向的⽂件路径或 URL 不⼀定是真实存在的⽂件或资源。 可以通过在⼀个别名后⾯加斜杠 / 和⼀⾄多个路径分段⽣成新别名 （⽆需调⽤ Yii::setAlias() ）。我们把通过 Yii::setAlias() 定义的别名称为根别名，⽽⽤他们衍⽣出 去的别名成为衍⽣别名。例如，@foo 就是根别名，⽽ @foo/bar/file.php 是⼀个 衍⽣别名。 你还可以⽤别名去定义新别名 （根别名与衍⽣别名均可）： Yii::setAlias(@foobar, @foo/bar); 根别名通常在引导阶段定义。⽐如你可以在⼊⼜脚本⾥调⽤ Yii::setAlias() 。为了⽅便 起见，应⽤提供了⼀个名为 aliases 的可写属性，你可以在应⽤配置中设置它，就 像这样： return [ // ... aliases = [ @foo = /path/to/foo, @bar = http://www .example. om, ], ]; 解析别名 你可以调⽤ Yii::getAlias() 命令来解析根别名到对应的⽂件路径或 URL 。同样的页⾯ 也可以⽤于解析衍⽣别名。例如： e ho Yii::getAlias(@foo); // 输出：/path/to/foo e ho Yii::getAlias(@bar); // 输出：http://www .examp e ho Yii::getAlias(@foo/bar/file.php); // 输出：/path/to/foo/bar 由衍⽣别名所解析出的⽂件路径和 URL 是通过替换掉衍⽣别名中的根别名部分得到 的。 注意：Yii::getAlias() 并不检查结果路径/URL 所指向的资源是否真实存 在。 根别名可能也会包含斜杠 /。Yii::getAlias() ⾜够智能到判断⼀个别名中的哪部分是根 别名，因此能正确解析⽂件路径/URL 。例如： Yii::setAlias(@foo, /path/to/foo); Yii::setAlias(@foo/bar, /path2/bar); e ho Yii::getAlias(@foo/test/file.php); // 输出：/path/to/foo/te e ho Yii::getAlias(@foo/bar/file.php); // 输出：/path2/bar/file 若 @foo/bar 未被定义为根别名，最后⼀⾏语句会显⽰ 为 /path/to/foo/bar/file.php。 使⽤别名 别名在 Yii 的很多地⽅都会被正确识别，⽆需调⽤ Yii::getAlias() 来把它们转换为路 径/URL 。例如，yii\caching\FileCache::cachePath 能同时接受⽂件路径或是指向⽂件路 径的别名，因为通过 @ 前缀能区分它们。 use yii\ a hing\FileCa he; $ a he = new FileCa he([ a hePath = @runtime/ a he, ]); 请关注 API ⽂档了解特定属性或⽅法参数是否⽀持别名。 预定义的别名 Yii 预定义了⼀系列别名来简化常⽤路径和 URL 的使⽤： @yii - BaseYii.php ⽂件所在的⽬录 （也被称为框架安装⽬录） @app - 当前运⾏的应⽤ yii\base\Application::basePath @runtime - 当前运⾏