検索
ホームページバックエンド開発PHPチュートリアルyii2 ソースコード学習メモ (セブンティーン)、yii2 ソースコード学習メモ_PHP チュートリアル

yii2源码学习笔记(十七),yii2源码学习笔记

Theme 类,应用的主题,通过替换路径实现主题的应用,方法为获取根路径和根链接:yii2\base\Theme.php

<span>  1</span> <?<span>php
</span><span>  2</span> <span>/*</span><span>*
</span><span>  3</span> <span> * @link </span><span>http://www.yiiframework.com/</span>
<span>  4</span> <span> * @copyright Copyright (c) 2008 Yii Software LLC
</span><span>  5</span> <span> * @license </span><span>http://www.yiiframework.com/license/</span>
<span>  6</span>  <span>*/</span>
<span>  7</span> 
<span>  8</span> <span>namespace</span> yii\<span>base</span><span>;
</span><span>  9</span> 
<span> 10</span> <span>use Yii;
</span><span> 11</span> <span>use yii\helpers\FileHelper;
</span><span> 12</span> 
<span> 13</span> <span>/*</span><span>*
</span><span> 14</span> <span> * Theme represents an application theme.
</span><span> 15</span> <span> * Theme 类,应用的主题
</span><span> 16</span> <span> * When [[View]] renders a view file, it will check the [[View::theme|active theme]]
</span><span> 17</span> <span> * to see if there is a themed version of the view file exists. If so, the themed version will be rendered instead.
</span><span> 18</span> <span> * 视图对象[[View]]渲染视图文件的时候,会检查视图的主题是否存在,如果存在则渲染主题取代默认样式
</span><span> 19</span> <span> * A theme is a directory consisting of view files which are meant to replace their non-themed counterparts.
</span><span> 20</span> <span> *
</span><span> 21</span> <span> * Theme uses [[pathMap]] to achieve the view file replacement:
</span><span> 22</span> <span> *
</span><span> 23</span> <span> * 1. It first looks for a key in [[pathMap]] that is a substring of the given view file path;
</span><span> 24</span> <span> *  首先查找关键字,关键字是一个给定的视图路径的字符串
</span><span> 25</span> <span> * 2. If such a key exists, the corresponding value will be used to replace the corresponding part
</span><span> 26</span> <span> *    in the view file path;关键字存在,则用对应值替换给定的视图文件路径中对应的部分
</span><span> 27</span> <span> * 3. It will then check if the updated view file exists or not. If so, that file will be used
</span><span> 28</span> <span> *    to replace the original view file.检查替换后的路径对应的文件是否存在,存在就替换原文件
</span><span> 29</span> <span> * 4. If Step 2 or 3 fails, the original view file will be used.
</span><span> 30</span> <span> * 2和3失败的话,返回原来的路径
</span><span> 31</span> <span> * For example, if [[pathMap]] is `['@app/views' => '@app/themes/basic']`,
</span><span> 32</span> <span> * then the themed version for a view file `@app/views/site/index.php` will be
</span><span> 33</span> <span> * `@app/themes/basic/site/index.php`.
</span><span> 34</span> <span> *
</span><span> 35</span> <span> * It is possible to map a single path to multiple paths. For example,
</span><span> 36</span> <span> *
</span><span> 37</span> <span> * ~~~
</span><span> 38</span> <span> * 'pathMap' => [
</span><span> 39</span> <span> *     '@app/views' => [
</span><span> 40</span> <span> *         '@app/themes/christmas',
</span><span> 41</span> <span> *         '@app/themes/basic',
</span><span> 42</span> <span> *     ],
</span><span> 43</span> <span> * ]
</span><span> 44</span> <span> * ~~~
</span><span> 45</span> <span> *
</span><span> 46</span> <span> * In this case, the themed version could be either `@app/themes/christmas/site/index.php` or
</span><span> 47</span> <span> * `@app/themes/basic/site/index.php`. The former has precedence over the latter if both files exist.
</span><span> 48</span> <span> *
</span><span> 49</span> <span> * To use a theme, you should configure the [[View::theme|theme]] property of the "view" application
</span><span> 50</span> <span> * component like the following:
</span><span> 51</span> <span> *
</span><span> 52</span> <span> * ~~~
</span><span> 53</span> <span> * 'view' => [
</span><span> 54</span> <span> *     'theme' => [
</span><span> 55</span> <span> *         'basePath' => '@app/themes/basic',
</span><span> 56</span> <span> *         'baseUrl' => '@web/themes/basic',
</span><span> 57</span> <span> *     ],
</span><span> 58</span> <span> * ],
</span><span> 59</span> <span> * ~~~
</span><span> 60</span> <span> *
</span><span> 61</span> <span> * The above configuration specifies a theme located under the "themes/basic" directory of the Web folder
</span><span> 62</span> <span> * that contains the entry script of the application. If your theme is designed to handle modules,
</span><span> 63</span> <span> * you may configure the [[pathMap]] property like described above.
</span><span> 64</span> <span> *
</span><span> 65</span> <span> * @property string $basePath The root path of this theme. All resources of this theme are located under this
</span><span> 66</span> <span> * directory.
</span><span> 67</span> <span> * @property string $baseUrl The base URL (without ending slash) for this theme. All resources of this theme
</span><span> 68</span> <span> * are considered to be under this base URL. This property is read-only.
</span><span> 69</span> <span> *
</span><span> 70</span> <span> * @author Qiang Xue <qiang.xue@gmail.com>
</span><span> 71</span> <span> * @since 2.0
</span><span> 72</span>  <span>*/</span>
<span> 73</span> <span>class</span><span> Theme extends Component
</span><span> 74</span> <span>{
</span><span> 75</span>     <span>/*</span><span>*
</span><span> 76</span> <span>     * @var array the mapping between view directories and their corresponding themed versions.
</span><span> 77</span> <span>     * This property is used by [[applyTo()]] when a view is trying to apply the theme.
</span><span> 78</span> <span>     * Path aliases can be used when specifying directories.
</span><span> 79</span> <span>     * 路径映射属性 设置替换映射关系
</span><span> 80</span> <span>     * If this property is empty or not set, a mapping [[Application::basePath]] to [[basePath]] will be used.
</span><span> 81</span>      <span>*/</span>
<span> 82</span>     <span>public</span><span> $pathMap;
</span><span> 83</span> 
<span> 84</span>     <span>private</span> $_baseUrl;<span>//</span><span>设置要访问资源的url</span>
<span> 85</span> 
<span> 86</span>     <span>/*</span><span>*
</span><span> 87</span> <span>     * @return string the base URL (without ending slash) for this theme. All resources of this theme are considered
</span><span> 88</span> <span>     * to be under this base URL. 返回当前主题的基础链接,其他资源都在链接里
</span><span> 89</span>      <span>*/</span>
<span> 90</span>     <span>public</span><span> function getBaseUrl()
</span><span> 91</span> <span>    {
</span><span> 92</span>         <span>return</span> $<span>this</span>-><span>_baseUrl;
</span><span> 93</span> <span>    }
</span><span> 94</span> 
<span> 95</span>     <span>/*</span><span>*
</span><span> 96</span> <span>     * @param $url string the base URL or path alias for this theme. All resources of this theme are considered
</span><span> 97</span> <span>     * to be under this base URL. 设置基础链接
</span><span> 98</span>      <span>*/</span>
<span> 99</span>     <span>public</span><span> function setBaseUrl($url)
</span><span>100</span> <span>    {
</span><span>101</span>         $<span>this</span>->_baseUrl = rtrim(Yii::getAlias($url), <span>'</span><span>/</span><span>'</span><span>);
</span><span>102</span> <span>    }
</span><span>103</span> 
<span>104</span>     <span>private</span> $_basePath;<span>//</span><span>根路径</span>
<span>105</span> 
<span>106</span>     <span>/*</span><span>*
</span><span>107</span> <span>     * @return string the root path of this theme. All resources of this theme are located under this directory.
</span><span>108</span> <span>     * 得到当前主题的根路径
</span><span>109</span> <span>     * @see pathMap
</span><span>110</span>      <span>*/</span>
<span>111</span>     <span>public</span><span> function getBasePath()
</span><span>112</span> <span>    {
</span><span>113</span>         <span>return</span> $<span>this</span>-><span>_basePath;
</span><span>114</span> <span>    }
</span><span>115</span> 
<span>116</span>     <span>/*</span><span>*
</span><span>117</span> <span>     * @param string $path the root path or path alias of this theme. All resources of this theme are located
</span><span>118</span> <span>     * under this directory. 设置当前主题根路径
</span><span>119</span> <span>     * @see pathMap
</span><span>120</span>      <span>*/</span>
<span>121</span>     <span>public</span><span> function setBasePath($path)
</span><span>122</span> <span>    {
</span><span>123</span>         $<span>this</span>->_basePath =<span> Yii::getAlias($path);
</span><span>124</span> <span>    }
</span><span>125</span> 
<span>126</span>     <span>/*</span><span>*
</span><span>127</span> <span>     * Converts a file to a themed file if possible. 将一个文件替换主题文件
</span><span>128</span> <span>     * If there is no corresponding themed file, the original file will be returned.
</span><span>129</span> <span>     * 没有相应的主题文件,返回原文件。
</span><span>130</span> <span>     * @param string $path the file to be themed
</span><span>131</span> <span>     * @return string the themed file, or the original file if the themed version is not available.
</span><span>132</span> <span>     * @throws InvalidConfigException if [[basePath]] is not set
</span><span>133</span>      <span>*/</span>
<span>134</span>     <span>public</span><span> function applyTo($path)
</span><span>135</span> <span>    {
</span><span>136</span>         $pathMap = $<span>this</span>->pathMap; <span>//</span><span>取得路径映射</span>
<span>137</span>         <span>if</span> (empty($pathMap)) {<span>//</span><span>没有设置值 抛出异常</span>
<span>138</span>             <span>if</span> (($basePath = $<span>this</span>->getBasePath()) === <span>null</span><span>) {
</span><span>139</span>                 <span>throw</span> <span>new</span> InvalidConfigException(<span>'</span><span>The "basePath" property must be set.</span><span>'</span><span>);
</span><span>140</span> <span>            }
</span><span>141</span>             <span>//</span><span>设置值为[模块根路径=>主题根路径]的形式</span>
<span>142</span>             $pathMap = [Yii::$app->getBasePath() =><span> [$basePath]];
</span><span>143</span> <span>        }
</span><span>144</span> 
<span>145</span>         $path = FileHelper::normalizePath($path);<span>//</span><span>对路径中的"/"."\"进行统一</span>
<span>146</span> 
<span>147</span>         <span>foreach</span> ($pathMap <span>as</span> $<span>from</span> =><span> $tos) {
</span><span>148</span>             <span>//</span><span>映射数组中的来源</span>
<span>149</span>             $<span>from</span> = FileHelper::normalizePath(Yii::getAlias($<span>from</span><span>)) . DIRECTORY_SEPARATOR;
</span><span>150</span>             <span>if</span> (strpos($path, $<span>from</span>) === <span>0</span>) {<span>//</span><span>如果在$path中有可替换的旧值</span>
<span>151</span>                 $n = strlen($<span>from</span><span>);
</span><span>152</span>                 <span>foreach</span> ((array) $tos <span>as</span><span> $to) {
</span><span>153</span>                     $to =<span> FileHelper::normalizePath(Yii::getAlias($to)) . DIRECTORY_SEPARATOR;
</span><span>154</span>                     $file = $to . substr($path, $n);<span>//</span><span>把$path中的$from替换为$to</span>
<span>155</span>                     <span>if</span><span> (is_file($file)) {
</span><span>156</span>                         <span>return</span> $file; <span>//</span><span>是文件直接返回</span>
<span>157</span> <span>                    }
</span><span>158</span> <span>                }
</span><span>159</span> <span>            }
</span><span>160</span> <span>        }
</span><span>161</span> 
<span>162</span>         <span>return</span><span> $path;
</span><span>163</span> <span>    }
</span><span>164</span> 
<span>165</span>     <span>/*</span><span>*
</span><span>166</span> <span>     * Converts a relative URL into an absolute URL using [[baseUrl]].
</span><span>167</span> <span>     * 将一个相对URL转换为绝对URL
</span><span>168</span> <span>     * @param string $url the relative URL to be converted.要转换的相对URL
</span><span>169</span> <span>     * @return string the absolute URL  替换后的绝对URL
</span><span>170</span> <span>     * @throws InvalidConfigException if [[baseUrl]] is not set
</span><span>171</span>      <span>*/</span>
<span>172</span>     <span>public</span><span> function getUrl($url)
</span><span>173</span> <span>    {
</span><span>174</span>         <span>if</span> (($baseUrl = $<span>this</span>->getBaseUrl()) !== <span>null</span>) {<span>//</span><span>URL存在,进行转换</span>
<span>175</span>             <span>return</span> $baseUrl . <span>'</span><span>/</span><span>'</span> . ltrim($url, <span>'</span><span>/</span><span>'</span><span>);
</span><span>176</span>         } <span>else</span> {<span>//</span><span>不存在抛出异常</span>
<span>177</span>             <span>throw</span> <span>new</span> InvalidConfigException(<span>'</span><span>The "baseUrl" property must be set.</span><span>'</span><span>);
</span><span>178</span> <span>        }
</span><span>179</span> <span>    }
</span><span>180</span> 
<span>181</span>     <span>/*</span><span>*
</span><span>182</span> <span>     * Converts a relative file path into an absolute one using [[basePath]].
</span><span>183</span> <span>     * 通过相对路径生成绝对路径
</span><span>184</span> <span>     * @param string $path the relative file path to be converted. 要转换的相对文件路径。
</span><span>185</span> <span>     * @return string the absolute file path 转换后的绝对路径
</span><span>186</span> <span>     * @throws InvalidConfigException if [[baseUrl]] is not set
</span><span>187</span>      <span>*/</span>
<span>188</span>     <span>public</span><span> function getPath($path)
</span><span>189</span> <span>    {
</span><span>190</span>         <span>if</span> (($basePath = $<span>this</span>->getBasePath()) !== <span>null</span><span>) {
</span><span>191</span>             <span>//</span><span>返回拼接的路径</span>
<span>192</span>             <span>return</span> $basePath . DIRECTORY_SEPARATOR . ltrim($path, <span>'</span><span>/\\</span><span>'</span><span>);
</span><span>193</span>         } <span>else</span><span> {
</span><span>194</span>             <span>throw</span> <span>new</span> InvalidConfigException(<span>'</span><span>The "basePath" property must be set.</span><span>'</span><span>);
</span><span>195</span> <span>        }
</span><span>196</span> <span>    }
</span><span>197</span> }

 

www.bkjia.comtruehttp://www.bkjia.com/PHPjc/1134780.htmlTechArticleyii2源码学习笔记(十七),yii2源码学习笔记 Theme 类,应用的主题,通过替换路径实现主题的应用,方法为获取根路径和根链接:yii2\base\T...
声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
php如何使用Yii3框架?php如何使用Yii3框架?May 31, 2023 pm 10:42 PM

随着互联网的不断发展,Web应用程序开发的需求也越来越高。对于开发人员而言,开发应用程序需要一个稳定、高效、强大的框架,这样可以提高开发效率。Yii是一款领先的高性能PHP框架,它提供了丰富的特性和良好的性能。Yii3是Yii框架的下一代版本,它在Yii2的基础上进一步优化了性能和代码质量。在这篇文章中,我们将介绍如何使用Yii3框架来开发PHP应用程序。

如何使用PHP框架Yii开发一个高可用的云备份系统如何使用PHP框架Yii开发一个高可用的云备份系统Jun 27, 2023 am 09:04 AM

随着云计算技术的不断发展,数据的备份已经成为了每个企业必须要做的事情。在这样的背景下,开发一款高可用的云备份系统尤为重要。而PHP框架Yii是一款功能强大的框架,可以帮助开发者快速构建高性能的Web应用程序。下面将介绍如何使用Yii框架开发一款高可用的云备份系统。设计数据库模型在Yii框架中,数据库模型是非常重要的一部分。因为数据备份系统需要用到很多的表和关

Yii2 vs Phalcon:哪个框架更适合开发显卡渲染应用?Yii2 vs Phalcon:哪个框架更适合开发显卡渲染应用?Jun 19, 2023 am 08:09 AM

在当前信息时代,大数据、人工智能、云计算等技术已经成为了各大企业关注的热点。在这些技术中,显卡渲染技术作为一种高性能图形处理技术,受到了越来越多的关注。显卡渲染技术被广泛应用于游戏开发、影视特效、工程建模等领域。而对于开发者来说,选择一个适合自己项目的框架,是一个非常重要的决策。在当前的语言中,PHP是一种颇具活力的语言,一些优秀的PHP框架如Yii2、Ph

Symfony vs Yii2:哪个框架更适合开发大型Web应用?Symfony vs Yii2:哪个框架更适合开发大型Web应用?Jun 19, 2023 am 10:57 AM

随着Web应用需求的不断增长,开发者们在选择开发框架方面也越来越有选择的余地。Symfony和Yii2是两个备受欢迎的PHP框架,它们都具有强大的功能和性能,但在面对需要开发大型Web应用时,哪个框架更适合呢?接下来我们将对Symphony和Yii2进行比较分析,以帮助你更好地进行选择。基本概述Symphony是一个由PHP编写的开源Web应用框架,它是建立

Yii框架中的数据查询:高效地访问数据Yii框架中的数据查询:高效地访问数据Jun 21, 2023 am 11:22 AM

Yii框架是一个开源的PHPWeb应用程序框架,提供了众多的工具和组件,简化了Web应用程序开发的流程,其中数据查询是其中一个重要的组件之一。在Yii框架中,我们可以使用类似SQL的语法来访问数据库,从而高效地查询和操作数据。Yii框架的查询构建器主要包括以下几种类型:ActiveRecord查询、QueryBuilder查询、命令查询和原始SQL查询

yii如何将对象转化为数组或直接输出为json格式yii如何将对象转化为数组或直接输出为json格式Jan 08, 2021 am 10:13 AM

yii框架:本文为大家介绍了yii将对象转化为数组或直接输出为json格式的方法,具有一定的参考价值,希望能够帮助到大家。

Yii2编程指南:运行Cron服务的方法Yii2编程指南:运行Cron服务的方法Sep 01, 2023 pm 11:21 PM

如果您问“Yii是什么?”查看我之前的教程:Yii框架简介,其中回顾了Yii的优点,并概述了2014年10月发布的Yii2.0的新增功能。嗯>在这个使用Yii2编程系列中,我将指导读者使用Yii2PHP框架。在今天的教程中,我将与您分享如何利用Yii的控制台功能来运行cron作业。过去,我在cron作业中使用了wget—可通过Web访问的URL来运行我的后台任务。这引发了安全问题并存在一些性能问题。虽然我在我们的启动系列安全性专题中讨论了一些减轻风险的方法,但我曾希望过渡到控制台驱动的命令

Yii框架中的表单构建器:构建复杂表单Yii框架中的表单构建器:构建复杂表单Jun 21, 2023 am 10:09 AM

随着互联网的快速发展,Web应用越来越成为人们生活中不可或缺的一部分。而表单是Web应用中不可或缺的元素之一,其用于收集用户数据,让Web应用能够更好地为用户服务。Yii框架是一个快速、高效、灵活的PHP框架,可以帮助开发人员更加快速地开发Web应用。Yii框架中的表单构建器(FormBuilder)可以让开发人员轻松地构建复杂的表单,让Web应用具有更好

See all articles

ホットAIツール

Undresser.AI Undress

Undresser.AI Undress

リアルなヌード写真を作成する AI 搭載アプリ

AI Clothes Remover

AI Clothes Remover

写真から衣服を削除するオンライン AI ツール。

Undress AI Tool

Undress AI Tool

脱衣画像を無料で

Clothoff.io

Clothoff.io

AI衣類リムーバー

AI Hentai Generator

AI Hentai Generator

AIヘンタイを無料で生成します。

ホットツール

MantisBT

MantisBT

Mantis は、製品の欠陥追跡を支援するために設計された、導入が簡単な Web ベースの欠陥追跡ツールです。 PHP、MySQL、Web サーバーが必要です。デモおよびホスティング サービスをチェックしてください。

DVWA

DVWA

Damn Vulnerable Web App (DVWA) は、非常に脆弱な PHP/MySQL Web アプリケーションです。その主な目的は、セキュリティ専門家が法的環境でスキルとツールをテストするのに役立ち、Web 開発者が Web アプリケーションを保護するプロセスをより深く理解できるようにし、教師/生徒が教室環境で Web アプリケーションを教え/学習できるようにすることです。安全。 DVWA の目標は、シンプルでわかりやすいインターフェイスを通じて、さまざまな難易度で最も一般的な Web 脆弱性のいくつかを実践することです。このソフトウェアは、

SublimeText3 英語版

SublimeText3 英語版

推奨: Win バージョン、コードプロンプトをサポート!

SAP NetWeaver Server Adapter for Eclipse

SAP NetWeaver Server Adapter for Eclipse

Eclipse を SAP NetWeaver アプリケーション サーバーと統合します。

Dreamweaver Mac版

Dreamweaver Mac版

ビジュアル Web 開発ツール