本文实例讲述了yii2主题(theme)用法。分享给大家供大家参考,具体如下:
首先看看主要的配置方式:
'components' => [
'view' => [
'theme' => [
'pathmap' => ['@app/views' => '@app/themes/basic'],
'baseurl' => '@web/themes/basic',
],
],
],
yii中的主题功能主要由yiibasetheme类来实现,它的主要思想是:先定义好一个一一对应的字符串映射数组,然后对给定的字符串按照数组中的映射关系进行字符串替换。
有如下映射:
$pathmap=[
'@app/a' => '@app/aaa',
'@app/b' => '@app/bbb',
'@app/c' => [
'@app/ccc/xxx',
'@app/ccc/yyy',
],
];
对字符串 @app/a/site/index.php,由上面的映射关系可知会把@app/a替换为@app/aaa,生成结果为@app/aaa/site/index.php。
但要注意,这个还不是最终的结果。由于在yii中是对文件路径的操作,所以如果@app/aaa/site/index.php这个文件存在的话,则会返回这个路径,否则返回原路径即:@app/a/site/index.php
如果有字符串@app/c/site/index.php,由于上面的映射知道@app/c对应2个替换项,yii会从前开始依次替换,先生成@app/ccc/xxx/site/index.php,如果这个文件存在,则返回这个路径,否则继续替换。
如果所有的替换结果都不存在对应的文件,那么最后返回原路径。
同时写多个替换的目标值有这么一个好处:实现主题的继承。
现在有一套默认的主题default,如果现在要增加一套黑色的主题,有两个办法可以实现。
第一种:把所有的default中的视图全部复制一份到blank目录中。
第二种:只复制一份layout布局文件到blank目录中,然后在布局文件中修改整体颜色。然后设置为
$pathmap=[
'@app/c' => [
'@app/ccc/blank',
'@app/ccc/default',
],
];
好处看到了吧,如果在blank中没有找到文件,会从default中来查找,也就是说blank中的文件会覆盖default中存在的文件,从而实现了主题的继承。
主题中的属性:
$pathmap:这个就是用来设置替换映射关系的。
'pathmap' =>[
'@app/views' => [
'@app/themes/blank',
'@app/themes/default',
],
'@app/modules' => '@app/themes/default/modules',
'@app/widgets' => '@app/themes/default/widgets'
],
这三个分别对views、modules和widgets应用主题。
$baseurl:这个用来设置要访问的资源的url(结尾不加“/”)
$basepath:设置资源所在的文件目录
主题中的方法:
public function init()
public function init()
{
parent::init();
//如果没有设置$pathmap映射,则使用$basepath,
if (empty($this->pathmap)) {
/*
* 如果$basepath也没有设置,则出异常。
* 也就是说 $pathmap和$basepath至少要设置一个,如果两个都设置了,优先使用$pathmap
*/
if (($basepath = $this->getbasepath()) === null) {
throw new invalidconfigexception('the "basepath" property must be set.');
}
//设置当前模块的路径和$basepath的映射关系
$this->pathmap = [yii::$app->getbasepath() => [$basepath]];
}
}
public function applyto($path)
//这个就是按照 $pathmap中的定义的映射关系来对$path进行替换字符串的
public function applyto($path)
{
//对路径中的"/"、“”进行统一替换
$path = filehelper::normalizepath($path);
foreach ($this->pathmap as $from => $tos) {
//映射数组中的来源(旧值)
$from = filehelper::normalizepath(yii::getalias($from)) . directory_separator;
//如果在$path中有可替换的旧值
if (strpos($path, $from) === 0) {
$n = strlen($from);
//对目标值循环,
foreach ((array) $tos as $to) {
$to = filehelper::normalizepath(yii::getalias($to)) . directory_separator;
//把$path中的$from替换为$to
$file = $to . substr($path, $n);
//如果是文件,直接返回
if (is_file($file)) {
return $file;
}
}
}
}
return $path;
}
更多关于yii相关内容感兴趣的读者可查看本站专题:《yii框架入门及常用技巧总结》、《php优秀开发框架总结》、《smarty模板入门基础教程》、《php面向对象程序设计入门教程》、《php字符串(string)用法总结》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》
希望本文所述对大家基于yii框架的php程序设计有所帮助。
【说明】:
本文章由站长整理发布,文章内容不代表本站观点,如文中有侵权行为,请与本站客服联系(QQ:)!