建立模板标签系统应用程序

    建立模板标签系统应用程序只需几个步骤.
    注意:以下步骤假设使用了新的sleek例子应用程序(这个例子可以在www.phpmvc.net上找到).

修改应用程序的boot.ini文件

    应用程序的boot.ini文件包含需要得到php.mvc框架的信息.boot.ini文件通常位于应用程序的"web-inf"目录下.为了设置应用程序使用模板标签类,我们需要在boot.ini文件中定义一些属性.

tagactiondispatcher类

    tagactiondispatcher是actiondispatcher类的标准实现.为了让框架能读取tagactiondispatcher类,我们为变量$appserverrootdir设置值为tagactiondispatcher:
// setup the application specific actiondispatcher (requestdispatcher)
 $actiondispatcher = tagactiondispatcher;

模板标签系统库根目录

    我们也需要设置路径指向我们的php.mvc库(需要文件系统的绝对路径):
// set php.mvc library root directory (no trailing slash).
 $appserverrootdir = c:\www\phpmvc-base;

可选设置

    应用程序定时器可以使用$timerrun属性来设置开或关:
// timer reporting. 1=on, 0=off
 $timerrun = 1;
    还可以指导框架总是(强制)编译应用程序phpmvc-config.xml配置类(最好用在开发阶段,因为会比较慢),我们使用:
// the application xml configuration data set:
  $appxmlcfgs = array();
  $appxmlcfgs[config] = array(name=>phpmvc-config.xml, fc=>true);
    或者仅在phpmvc-config.xml文件被修改的时候重新编译应用程序配置文件(在开发完成后使用此项设置,速度快),我们使用:
// the application xml configuration data set:
  $appxmlcfgs = array();
  $appxmlcfgs[config] = array(name=>phpmvc-config.xml, fc=>false);

设置应用程序模板目录

    当为模板标签应用程序设置模板目录时,我们需要去创建一个目录(和子目录),放置我们的应用程序模板文件.这个目录必须被命名为在view资源配置类的$tpldir属性所定义的值,默认是./web-inf/tpl.比如:例子应用程序有一个模板目录结构设置像这样:
- phpmvc-tags
     index.html
     main.php
     web-inf
        tpl
           pagefooter.ssp
           pageheader.ssp
           salepagebody.ssp
           sale
              pagecontent.ssp
    我们也需要去创建目录放置编译的页面.这个目录必须被命名为在view资源配置类的$tpldirc属性所定义的值.默认是./web-inf/tpl_c.例子应用程序有一个模板目录结构设置像这样:
phpmvc-tags
    index.html
    main.php
    web-inf
       tpl
          ...
          sale
             ...
          tpl_c
             pagefooter.sspc
             pageheader.sspc
             salepagebody.sspc
             sale
                pagecontent.sspc
    注意我们也需要在./web-inf/tpl_c下创建sale目录.

设置php.mvc库的路径和包含

    检查以下路径设置已经被定义在globalpaths.php和globalprepend.php文件在你的框架安装目录下的"/web-inf"目录下:
globalpaths.php
------------------------------------------------
 $appdirs[] = web-inf/lib/phpmvc_tags;

globalprepend.php
------------------------------------------------
 include_once phpmvc_tags.php;
    如果他们没有在添加到路径里,那么就定义这些变量.

安装php.mvc库

    下载最新版的php.mvc库:http://www.phpmvc.net/download/cvsidx.php?doc=cvs-snaps
    解压库文档到一个目录.修改上面所描述过的路径设置和包含设置.

运行例子应用程序

    下载例子应用程序.完整的例子代码文件和这个向导都能在这里下载:http://www.phpmvc.net/download/rel/phpmvc-tags-v1.0.zip
    解压到web服务器目录中.可能像这样:c:/www/phpmvc-tags
    修改应用程序和框架设置.
    为了测试例子程序,需要浏览器例子程序的首页:http://localhost/phpmvc-tags/index.html

附录a:viewresources配置类

    viewresourcesconfig类表现了<view-resource>元素的配置信息.
    下表列出了viewresourcesconfig类的属性,条目描述和默认值:   

name	description	default value
$apptitle	the application title	my web application
$appversion	the application version	1.0
$copyright	the copyright notice	copyright c yyyy my name. all rights reserved.
$contactinfo	the contact information	webmaster@myhost.com
$processtags	do we run the template engine processor (boolean)	false
$compileall	force compile pages (boolean)	false
$tagl	the left tag identifier	<@
$tagr	the right tag identifier	@>
$tpldir	the view resource templates directory	./web-inf/tpl
$tpldirc	the compiled templates directory	./web-inf/tpl_c
$extc	the compiled file notation. eg: "pagecontent.ssp[c]"	c
$maxfilelength	the maximum size of the template files allowed, in bytes (integer)	250000
$tagflagstr	indicates tag template file(s) to be pre-processed. eg: "mypage.ssp"	.ssp
$tagflagcnt	the number of trailing filename characters to sample (".ssp" = -4)	-4