Template类实现HTML及PHP代码分离-阳飞.doc

使用PHP4中的 IntegratedTemplate类实现HTML和PHP代码分离作者:jacklondon 使用PHP编程的人都会碰到这样一个问题：当PHP代码和HTML代码在一起的时候，看PHP代码很费劲，整个文件也无法用Dreamweaver来编辑，这对于PHP程序员和美工来讲，修改这样的文件就象一个噩梦。 PHP中的模板(Template)技术就是为了解决这个问题而出现的。PHP模板类有很多，比较常见的是 FastTemplate 和 PHPLib， 因为出现得早，在PHP编程界名声很大。PHP程序员不知道这两个类，就象VB程序员不知道MsgBox函数一样，是一件不可思议的事情。 以前我们需要去下载PHP模板类，现在PHP4有了自己的模板类 IntegratedTemplate 和 IntegratedTemplateExtension，功能和PHPLib 差不多。这两个类是子类和父类的关系。一般我们用 IntegratedTemplateExtension 就可以了。让人感到不可思议的是 IntegratedTemplate 不是从 PEAR 类继承过来，无法用到 PEAR 类的 debug 功能。 以下举例子说明它们的用法，假设 IntegratedTemplate 类和 IntegratedTemplateExtension 类分别在 C:php4pearHTMLITX.php 和 C:php4pearHTMLITX.php 中。我们写的代码放在C:TestPHPPHP4Welcome.htm 和 C:TestPHPHTMLWelcome.php 中。将C:TestPHPPHP4 在Web Server 上设成虚拟目录 /testphp 并且给与脚本执行权限，确认C:TestPHPHTMLWelcome.htm 无法通过远端浏览器访问。在 php.ini 里面设置 include_path = .;C:php4pear 例1： 我们在HTML文件中放置变量的标记，用PHP代码设置变量的值，然后将HTML中的标记替换掉，最后输出到客户浏览器。 以下是 Welcome.htm 代码，我们放了三个PHP tag(变量标记)为： WelcomeTitle、UserName、WelcomeMessage WelcomeTitle 您好，UserName WelcomeMessage 以下是Welcome.php代码 loadTemplatefile(Welcome.htm); 替换HTML 文件中的 tag $tpl-setVariable( array ( WelcomeTitle = $WelcomeTitle, UserName =$UserName, WelcomeMessage =$WelcomeMessage ) ); 输出替换后的 HTML $tpl-show(); ? 这样写好后，Welcome.htm 仍然可以使用网页编辑器如Dreamweaver、FrontPage 进行编辑，Welcome.php中是纯粹的PHP代码，不含HTML，方便以后的代码修改和维护。 如果将 IntegratedTemplateExtension 类和 PHP4中的 Cache 类 联合使用，在速度上可以得到很好的效果。 PHP4 模板类还可以使用 Block，配合其他 PHP4 中的类 可以很轻松地实现数据库数据检索的翻页，可以很轻松写出论坛之类的软件。 补充说明：为了防止用户直接用 Welcome.htm 看网页，将 Welcome.htm 放在客户访问不到的目录（只要不在Web Server 的虚拟目录下即可）。对于大型的PHP项目，图片、PHP代码、HTML文件、多语言字符串文件都应该放在不同的目录，这样在多人共同做一个项目时不至于混乱。(责任编辑:超越PHP)有时候使用require_once()书写php语句时，会出现找不到包含文件的错误。但我们仍然可以使用fopen()打开欲包含的文件，这说明权限和路径看起来是正确的。为什么会出现这种奇怪的情况呢？起初我认为require_once(filename)函数中的参数filename采用了相对路径，是以当前php文件为参照物的，但我查阅了相关资料后，推翻了自己的观点。在php.ini中有个参数叫做include_path，它类似DOS和UNIX中的PATH环境变量，为require/include_once()、require/include()提供了供搜索的路径列表，例如：include_path = .:/usr/local/lib/php:./include在UNIX下我们用冒号分隔每个路径，在Windows下则用分号分隔。我们看到在include_path的默认值中包含.的路径，它就是造成人们“相对路径”假象的“罪魁祸首”，另外我们可以加上/的搜索路径，在架设了虚拟主机的服务器上，这个路径是很有用的。当我们辛辛苦苦架好第一个php环境后，都会沉浸在无比的兴奋当中，从而忘记了对php.ini的进一步研究；事实上，一旦某些参数设置不当导致错误，我们就会花很长的时间去找原因，这个代价足以让很多电脑爱好者望而生畏。其实UNIX/LINUX的难，也就“难”在这里。Paths and Directories表格 H-5. 路径和目录配置选项名称默认值类型include_pathPHP_INCLUDE_PATHPHP_INI_ALLdoc_rootPHP_INCLUDE_PATHPHP_INI_SYSTEMuser_dirNULLPHP_INI_SYSTEMextension_dirPHP_EXTENSION_DIRPHP_INI_SYSTEMcgi.fix_pathinfo0PHP_INI_SYSTEMcgi.force_redirect1PHP_INI_SYSTEMcgi.redirect_status_envPHP_INI_SYSTEMfastcgi.impersonate0PHP_INI_SYSTEMcgi.rfc2616_headers0PHP_INI_SYSTEM以下是该配置选项的简要解释。include_path string 指定一组目录用于 require()，include() 和 fopen_with_path() 函数来寻找文件。格式和系统的 PATH 环境变量类似：一组目录的列表，在 UNIX 下用冒号分隔，在 Windows 下用分号分隔。 例子 H-1. UNIX include_pathinclude_path=.:/php/includes例子 H-2. Windows include_pathinclude_path=.;c:phpincludes在包含路径中使用 . 可以允许相对路径，它代表当前目录。 doc_root string PHP 在服务器上的根目录。仅在非空时使用。如果 PHP 被配置为安全模式，则此目录之外的文件一概不被解析。如果 PHP 编译时没有指定 FORCE_REDIRECT，并且在任何 web 服务器（除了 IIS）中以 CGI 方式运行 PHP，则应该设定 doc_root。替代方案是使用下面的 cgi.force_redirect 配置选项。 user_dir string 在用户目录之下使用 PHP 文件的基本目录名，例如 public_html。 extension_dir string PHP 用来寻找动态连接扩展库的目录。参见 enable_dl 和 dl()。 extension string 当 PHP 启动时所加载的动态连接扩展库。 cgi.fix_pathinfo boolean 对 CGI 提供了真正的 PATH_INFO/PATH_TRANSLATED 支持。以前 PHP 的行为是将 PATH_TRANSLATED 设为 SCRIPT_FILENAME，而不管 PATH_INFO 是什么。有关 PATH_INFO 的更多信息见 cgi 规格。将此值设为 1 将使 PHP CGI 修正其路径以遵守规格。设为 0 将使 PHP 的行为和从前一样。默认为零。用户应该修正其脚本使用 SCRIPT_FILENAME 而不是 PATH_TRANSLATED。 cgi.force_redirect boolean 在大多数 web 服务器中以 CGI 方式运行 PHP 时很有必要用 cgi.force_redirect 提供安全。PHP 默认其为 On。可以将其关闭，但风险自担。 注: Windows 用户：可以安全地在 IIS 之下将其关闭，事实上必须这么做。要在 OmniHTTPD 或 Xitami 之下使用也必须将其关闭。 cgi.redirect_status_env string 如果打开了 cgi.force_redirect，并且不是在 Apache 或 Netscape（iPlanet）web 服务器之下运行，可能需要设定一个环境变量名，PHP 将去寻找它来知道可以继续执行下去。 注: 设定此变量可能会导致安全问题，首先要知道自己在做什么。 fastcgi.impersonate string IIS（在基于 WINNT 的操作系统上）中的 FastCGI 支持模仿客户端安全令牌的能力。这使得 IIS 能够定义运行时所基于的请求的安全上下文。Apache 中的 mod_fastcgi 不支持此特性（03/17/2002）。如果在 IIS 中运行则设为 1。默认为 0。 cgi.rfc2616_headers int 指定 PHP 在发送 HTTP 响应代码时使用何种报头。如果设定为 0，PHP 发送一个 Status: 报头，Apache 和其它 web server 都支持。如果此选项设定为 1，PHP 将发送 RFC 2616 兼容的报头。除非你知道自己在做什么，否则保留其值为 0实例学习PHP之FastTemplate模板篇作者:地藏来源:ASP酷 如果你从来没有接触过PHP,那么还是先看看这个吧，当然即使是你已经对PHP有所了解，但一本PHP4的的使用手册也还是需要的，：）。此外一本HTML语法手册当然也是不可缺少的啦。 在网站开发过程中你是不是经常面对改版的苦恼？几百几千个文件因为版式上的一点小变化就需要全部重新处理，是不是让你头痛无比？唉，如果能够把内容和表现形式分开就好了，这可是我们一直翘首等待的。但可惜用于处理这个问题的XML还未完全的成熟。难道除此之外就没有办法了吗？正所谓东西是死的，人却是活的，我们今天要学习的这个php库，就可以帮助我们在一定程度上处理这个问题。：） FastTemplate是什么？从PHP语言上来讲它是一个PHP库；从它的起源来说它源于一个同样名称的Perl软件包；从用途上来讲是一个可以让你在几秒内改变整个站点外观的实用工具。用最通俗的语言来说，它就是一个模板，一个类似DreamWaver中的模板。现在FastTemplate在你心里是一个问号？还是一个感叹号？又或是一个句号？（编辑：靠，在这骗稿费呀，我扁!）算了，不管那么多，你只要知道他是好东西就成，：） 首先在我们使用这个库以前当然要先下载它，大家可以在下面这个网址 FastTemplate-1.1.0/ FastTemplate-1.1.0/README - 这个文件就不用说了吧？ FastTemplate-1.1.0/class.FastTemplate.php3 - 这个文件最重要，它就库文件，核心耶！ FastTemplate-1.1.0/example_1.phtml - 一个例子 FastTemplate-1.1.0/example_2.phtml - 第二个例子 FastTemplate-1.1.0/example_3.phtml - 第三个例子 FastTemplate-1.1.0/dynamic_example.phtml - 第四个例子 FastTemplate-1.1.0/docs/ - 文档目录 FastTemplate-1.1.0/docs/FastTemplate.3 - Unix man page FastTemplate-1.1.0/docs/FastTemplate.html - HTML documentation FastTemplate-1.1.0/templates/ - 模板例子的目录 FastTemplate-1.1.0/templates/begin.tpl FastTemplate-1.1.0/templates/header.tpl FastTemplate-1.1.0/templates/main.tpl FastTemplate-1.1.0/templates/row.tpl FastTemplate-1.1.0/templates/test.tpl FastTemplate-1.1.0/templates/footer.tpl FastTemplate-1.1.0/templates/htaccess.tpl FastTemplate-1.1.0/templates/middle.tpl FastTemplate-1.1.0/templates/table.tpl 注意哟，这个目录一定要是php程序可以访问的目录哟，换句话说就是php.ini里那个include目录。然后呢，使用php4编程的朋友注意了，你现在还不能直接使用这个库，还需要人工做些修改！等下注意看下面。php3的读者就不用管那么多，现在就可以试一下它带的那几个例子了，（嘿嘿，不过呢，它那些例子的后缀名全是phtml，如果你没办法设置web的话。你可以尝试把后缀名改改看，应该也可以用，地藏没有试过不敢打包票。）那！接着呢，php4的兄弟可千万要注意哟，如果不你不按下面的修改的话，这个库可是没有办法用的哟！ - class.FastTemplate.php3 Sun Jun 27 13:44:47 1999 + php4.FastTemplate.php3 Tue Jul 20 10:49:25 1999 -196,8 +196,10 settype($val,string); - $template = ereg_replace($key,$val,$template); - /$template = str_replace($key,$val,$template); + / php4 doesnt like $ combinations. + $key = .$key.; + $template = ereg_replace($key,$val,$template); + /$template = str_replace($key,$val,$template); -410,7 +412,7 if($end) - $newParent .= $MacroName ; + $newParent .= .$MacroName ; / Next line please if($end) $end = false; 大家用文本编辑器打开class.FastTemplate.php3文件，找到上面的部分。-减号代表消除这行，+加号代表加入这行。另外windows系统下的朋友注意哟！你们还需要改点小东西，把下面的那个$win32变量的值改成true，不改的话，用不了可别骂我，；）。 var $WIN32 = true; / Set to true if this is a WIN32 server 改好后，大家就可以试试他的那几个例子了。 如何？成功了吧。嘿嘿嘿嘿，地藏不会骗大家的啦。 OK，现在这个库已经可以用啦，我们准备进行下面的学习吧，：） 如何使用这个库？简单哟，首先要把这个库包含进来。也就是说呢，要 include class.FastTemplate.php3; 然后？呵呵 然后我也不知道啦！（编辑：嘿！找扁啊，你！）啊，啊！Sorry，我想起来了（在地藏被众编辑海扁一顿之后）。然后是学习这个库的使用原理。在这里呢我们先做个假设。 我们假设一个页面是由很多的小的部分组成（比如：每个网站都有分栏目导航等等），而且每个小的部分都有一个唯一的标识符（比如：我们把分栏每个小项定义为一个名字） 我们首先以这个库自带的example_1为例，让大家可以尽快的学会这个库的基本用法，；），不过大家要注意哟，这几个文件在服务器上的位置要按解压时的相对路径来存，千万不要忘记，就象不要忘记你女朋友的生日一样。呵呵 define( array( main = main.tpl, table = table.tpl, row = row.tpl ) ); $tpl- assign( array( TITLE = FastTemplate Test) ); for ($n=1; $n assign( array( NUMBER = $Number, BIG_NUMBER = $BigNum ) ); $tpl- parse(ROWS,.row); $tpl- parse(MAIN, array(table,main); $tpl- FastPrint(); exit; ? TITLE MAIN ROWS NUMBER BIG_NUMBER 使用这个库首先要如前面所说的 include class.FastTemplate.php3; 然后是定义模板所在目录$tpl = new FastTemplate(./templates)；注意哟！这里因为我是在windows系统运行，所以用的是./templates，在Linux或UNIX中可能不一样，大家根据具体情况来设定。然后呢，我们对应不同的模板，定义下面这个矩阵数组。$tpl- define( array( main = main.tpl, table = table.tpl, row = row.tpl ) ); define是这个类中的一个函数。下面是它的语法：define( array( key,value pairs) ) ，define（）函数映射一个名字到模板文件上，这个新的名字将是你用来代表模板的唯一名字，因为除此之外再不会有模板文件名出现。而且大家注意，这是使用类时决不能缺少的步骤，不能少的哟，如果少了那就和你不带生日礼物去你女朋友的生日Party有异曲同工之妙，嘿嘿嘿 现在！关键的，最有个性的东西来了！assign( (key,value pair) 或 assign ( array(key value pairs) ) 这个函数将把你在模板中定义的标识符定义为你网页上真正想要的东西。比如就象是上面$tpl- assign( array( TITLE = FastTemplate Test) ); 这句，将模板main.tpl里的TITLE替换为 FastTemplate Test 看不懂想不明的朋友多看看上面的那些代码。接着呢！接着是另外一个很有特色的东东。parse(RETURN, FileHandle(s) ) 将一个已定义模板插入的定义到另外一个模板文件中。大家仔细研究下面的代码，相信会比较容易了解。 for ($n=1; $n assign( array( NUMBER = $Number, BIG_NUMBER = $BigNum ) ); $tpl- parse(ROWS,.row); parse这个函数有三种用法 $tpl- parse(MAIN, main); / 标准 $tpl- parse(MAIN, array ( table, main) ); / 简洁 $tpl- parse(MAIN, .row); / 增加 其中以第三种最有意思，它表示的是在原来已经有的基础上再加上一个新数据。呵呵，这么说大家可能无法明白，我们还是看看再多研究一下上面的源代码吧，毕竟编程这东西有很多是只可意会不可言传的！（下面附上英文的说明，不是地藏想偷懒不翻译，实在是有些东西看原味的比翻译的更加容易理解呀， In the regular version, the template named main is loaded if it hasnt been already, all the variables are interpolated, and the result is then stored in FastTemplate as the value MAIN. If the variable MAIN shows up in a later template, it will be interpolated to be the value of the parsed main template. This allows you to easily nest templates, which brings us to the compound style. The compound style is designed to make it easier to nest templates. The following are equivalent: $tpl- parse(MAIN, table); $tpl- parse(MAIN, .main); / is the same as: $tpl- parse(MAIN, array(table, main); / this form saves function calls and makes your code cleaner It is important to note that when you are using the compound form, each template after the first, must contain the variable that you are parsing the results into. In the above example, main must contain the variable MAIN, as that is where the parsed results of table is stored. If main does not contain the variable MAIN then the parsed results of table will be lost. The append style allows you to append the parsed results to the target variable. Placing a leading dot . before a defined file handle tells FastTemplate to append the parsed results of this template to the returned results. This is most useful when building tables that have an dynamic number of rows - such as data from a database query. ） 最后在完成上面的过程后，就可以进行输出了，FastTemplate库使用使用FastPrint(HANDLE) 来进行输出。 $tpl- FastPrint(); 在经过上面的这些步骤后，大家对使用FastTemplate库的过程是否清楚明白呢？地藏试试把上面的过程总结一下，看看对各位朋友是否有帮助： 首先：将库用include加进来 其次：定义一个类变量，在上例中是$tpl 再次：定义各种最小元素，比如上面的$tpl = new FastTemplate(./templates); 然后：利用parse函数将各种最小元素进行组合起来 最后：用FastPrint()进行输出 本站注:现在PHP领域中最著名的模板非Fasttemplate莫属了。除了FastTemplate外，还有一个很著名的(也是本站现在在用的)模板是PHPlib中的一个。这两个模板虽然作者不一样，但是其核心及用法都大同小异，有关文章请参考: ?phplib附:Fasttemplate本站下载地址:(责任编辑:超越PHP)推荐给朋友 显示打印版本 更新日期:2002-10-29浏览次数: 6339用户评论点击这里添加新评论voodgen17-Nov-2003 10:44按照上面的说明。怎么运行不了。能否有高手给我指点。在下不胜感激！beyond09-Dec-2003 05:48Fatal error: Cannot redeclare clear_parse() inc:apachehtdocstesttemplate-tableclass.FastTemplate.php3 on line666提示这样的信息。Kelphen11-Dec-2003 11:17666行注释掉就OK了wanghaozi19-Dec-2003 12:51我没有按照他的方法修改Class.Fasttemplate.php3还是照样可以用呀,难道非要修改吗?graymice09-Feb-2004 06:39我也没按照上边的修改class.fasttemplate.php3,只是把后缀名改为.php就能运行了.uuq23-Feb-2004 01:20不错,我改那为win32=true;uuq25-Feb-2004 04:35我只注释掉666行即可by01-Apr-2004 10:14谢谢，怎么会出现这个问题。不过注释掉那一行就好了lanhuizi23-Sep-2004 03:34注释666 是因为函数重复定义了至于其它的不修改可以使用php4中$这个也是支持的, 可能php4最初的版本在这方面有问题. 另外还可以用preg_replace这个而不使用ereg_replace ,主要是效率方面的原因許多讀者在用了 FastTemplate 之後出現類似這樣的錯誤訊息或是其它奇怪的錯誤：Warning: Invalid content of in class.FastTemplate.php3 on line 213也有時候會出現一堆奇怪的字元、小數點等。據悉應該是版本的問題所造成的，建議有這個問題的讀者更新 PHP 至 4.0.2 以上，並換上 Jollen 修改過的 FastTemplate 版本。下載：FastTemplate