PHP.MVC のテンプレート タグ システムの最初の紹介

模板

PHP.MVC的模板标签系统(PhpMVC_Tags)现在提供了3种类型的标签:包含指令，声明和表达式。

　　 包含指令能让我们将内容分隔为许多模块，比如:页眉，页脚或者内容.包含的页面可以是HTML，或者其他标签模板页.据个例子，下面的包含指令能用来包含一个页眉:

＜@ include ’pageHeader.ssp’ @＞ 
　　声明允许我们在模板种声明一个页面级别的变量，或者甚至其他包含页面.一个声明看起来像以下代码:

＜@ salesAreaID = "Central District" @＞ 
　　表达式标签允许我们在模板页中执行表达式.表达式的结果将被包含进模板页.以下表达式将被用来显示一个简单的字符串(salesAreaID)，也可以找回框架配置类的属性:

＜@ =salesAreaID @＞
＜@ =viewConfig.getAreaManager @＞ 
　　 PHP.MVC beta 0.4.0引进了一个新配置类叫做ViewResourcesConfig.这个类能被用来定义能被用在VIEW资源(模板)中的全局参数，并且也能去配置模板标签系统，它将在下面显示.phpmvc-config.xml配置文件中的view-resources元素在下面的显示:

＜view-resources
appTitle = "Flash Jacks’ Sleek Tab Site"
copyright = "Copyright @ 2010 Flash Jack. All rights reserved."
contactInfo = "flash.jack@jackshost.com"
processTags = "true"
compileAll = "true"
className = "MyViewResourcesConfig"＞ 
＜!-- We can set some properties on our custom ViewResourcesConfig class --＞
＜set-property property="areaManager" value="Joe J. Blogs Esq."/＞ 
＜/view-resources＞ 
　　模板页面处理使用模板标签系统能被＜view-resources＞结点来控制.首先我们能定义是模板标签系统编译所有模板页面还是只编译修改过的.其次，我们能定义模板标签系统是否真的要处理标签页面，处理标签页面在应用程序配置当中和配置之后很有用.下面单元显示的＜view-resources＞是将compileAll和processTags属性设置为真(总是处理标签页并且处理所有标签页):

＜view-resources
...
processTags = "true"
compileAll = "true"
...
＜/view-resources＞ 
　　 Action Dispatcher

　　 PHP.MVC版本beta 0.4.0以上ActionDispatcher类用来负责使FormBean，Errors，Value(商务数据)和ViewResourcesConfig对象在我们的VIEW(模板)中可以使用。

　　在检查模板标签系统之前我们应该快速的看一下ActionObjects和ViewResourcesConfig类，当在使用标准的ActionDispatcher时.

　　 ActionObjects

　　 ActionDispatcher使一些对象在我们所使用的模板页面中的应用程序VIEW资源可用.3种标准的ActionObjects为:FormBean，Errors，和Value(商务数据)对象。

　　一下表格显示了在FormAction和Action类中如何使用FormBean，Errors和Value对象:

Saving ActionObjects in ActionForm Classes 
ActionErrors $this-＞saveErrors($request， $actionErrors) 
　 FormBeans $this-＞saveFormBean($request， $this) 
ValueObjects $this-＞saveValueObject($request， $valueObject) 

Saving ActionObjects in Action Classes 
ActionErrors $this-＞saveErrors($request， $actionErrors) 
FormBeans $this-＞saveFormBean($request， $form) 
ValueObjects $this-＞saveValueObject($request， $valueObject) 

Retrieving ActionObjects in View Resources (Templates) 
ActionErrors $errors-＞getItemString(’logon_username_reqd’) 
FormBeans $form-＞username 
ValueObjects $data-＞salesNorth 
　　一个ActionObject将被初始化为NULL如果对象没有在之前被创建和保存.要想得到ActionObjects的详细信息请看这里:http://www.phpmvc.net/docs/guides/guidesIdx.php?doc=action-objects

　　 View Resources

　　 ActionDispatcher也能暴露ViewResourcesConfig对象到我们的模板页面中。ViewResourcesConfig对象被phpmvc-config.xml配置文件中的＜view-resources＞元素所配置的.如果ViewResourcesConfig对象还没有被配置，那么一个新的实例将使用默认的ViewResourcesConfig类的属性。

次のコードは、テンプレート タグ システムの式を使用して HTML ヘッダー テンプレートの ViewResourcesConfig プロパティにアクセスする方法を示しています:

＜!-- Page Header --＞
＜span＞
＜@ =viewConfig .getAppTitle @ ＞
＜/span＞

Action Dispatcher の設定

ActionDispatcher はデフォルトの PHP.MVC (beta 0.4.0 以降) の Dispatcher クラスであり、フレームワークに含まれており、デフォルトで使用されます。ただし、Dispatcher クラスを置き換えるクラスを定義しない限り。次のセクションでは、代替クラスである TagActionDispatcher クラスを使用するようにアプリケーションを構成する方法を説明します。