请选择 进入手机版 | 继续访问电脑版

SpeedPHP框架

 找回密码
 注册成为新用户

QQ登录

只需一步,快速开始

查看: 7935|回复: 1

[模板引擎] 自动页面输出以及模板高级功能

[复制链接]
发表于 2012-8-4 14:56:17 | 显示全部楼层 |阅读模式
sp框架的模板自动输出可以让我们不需要使用display语句就可以将模板输出,这简化了我们的日常编写的代码,同时也更有利于整理和归类模板,下面我们先介绍一下自动模板输出的方法,然后再介绍几个视图类的高级功能。

在应用程序的开发中,我们会发现程序的模板会渐渐增多,而仅放到一个目录中似乎并不科学,所以我们可以简单的整理一下,将每一个控制器的模板都分别放单独的一个目录,这样模板可以更方便去辨认和使用,同时也有利于项目的协作。

在上例中的main_test.html,我们放到了tpl下面的main文件夹中,改成test.html的文件名。那么,我们便可以使用:$this->display('main/test.html'); 来显示模板了。

main是控制器,test是动作,所以放到main目录下面,文件名为test.html,这样模板从逻辑上就与控制器相对应了。

进一步,我们希望能够更方便的输出模板。先来配置一下应用程序,以开启自动模板输出机制:

  1. $spConfig = array(
  2. ...
  3.         'view' => array(
  4.                 'enabled' => TRUE, // 开启Smarty支持
  5.                 'config' =>array(
  6.                         'template_dir' => APP_PATH.'/tpl', // 模板页面所在的目录
  7.                         'compile_dir' => APP_PATH.'/tmp', // 临时文件编译目录
  8.                         'cache_dir' => APP_PATH.'/tmp', // 临时文件缓存目录
  9.                         'left_delimiter' => '<{',  // Smarty左限定符,默认是{
  10.                         'right_delimiter' => '}>';, // Smarty右限定符,默认是}
  11.                 ),
  12.                 'auto_display' => TRUE, // 是否使用自动输出模板功能
  13.                 'auto_display_sep' => '/', // 自动输出模板的拼装模式,/为按目录方式拼装,_为按下划线方式,以此类推
  14.                 'auto_display_suffix' => '.html', // 自动输出模板的后缀名
  15.         ),
  16. ...               
复制代码

在视图的Smarty配置下面,我们看到加入了auto_display的设置,首先是开启了自动输出('auto_display' => TRUE),然后是配置模板的拼装模式和后缀,以刚才的例子为例:

'auto_display_sep' => '/', 即文件存放的地址是“模板目录/控制器名/动作名.html”,

'auto_display_sep' => '-',则文件存放的地址是“模板目录/控制器名-动作名.html”.

模板后缀名一般默认是.html即可,当然如果改成其他的后缀(如.php)也没问题。

那么,我们配置好后,现在可以直接让它进行输出了:

main目录中的test.html模板:

  1. <html><head></head>
  2. <body>
  3. 大家好,我是test.html。

  4. $sent_ok等于:<{$sent_ok}>
  5. </body>
  6. </html>               
复制代码
在控制器中,
  1. <?php
  2. class main extends spController
  3. {
  4. ...
  5. function test(){
  6.     $ok = "i am ok!";
  7.         $this->sent_ok = $ok;        
  8.         // 这里不需要display了
  9. }
  10. ...
  11. }               
复制代码
访问test动作,将输出:
  1. 大家好,我是test.html。
  2. $sent_ok等于:i am ok!
复制代码
当然,如果我们使用了display方法,那么该动作就不再自动输出模板了。

看起来,sp框架的自动模板输出,好像仅仅是节省一行的代码,但是,千万可不要小看了这一点点的简便,从软件工程角度,它将带给我们的是更智能的开发模式和更高的开发效率。

如果我们使用Enterprise Architect之类的UML建模工具就会知道,Enterprise Architect会自动为我们生成PHP代码的架构。这些没有内部代码的架构,如果配合了sp框架的自动页面输出功能,有相当一部分的PHP页面,我们需要做的仅是制作页面模板,并不需要写PHP代码。

Enterprise Architect是最适合PHP开发者的UML建模工具之一,还可以成为PHP开发者最好的PHP编辑器,同时这也是PHP程序员向PHP系统分析师迈进的必由之路。
如网站上的“关于我们”,我们的控制器是main,动作是about,在Enterprise Architect中是

spview-auto-display[1].jpg

生成代码后是:
  1. <?php
  2. class main extends spController
  3. {
  4.     function about(){
  5.     }
  6. }               
复制代码

当然,main extends spController这个继承语句也是由Enterprise Architect生成的。

这里,我们可以看到,在使用自动模板输出功能时,我们只要在对应的目录中放入about.html模板即可,而并不需要写PHP代码。



下面我们介绍一下关于sp框架的View视图层的一些高级功能:

1. 获取Smarty对象。

在控制器中使用$this->getView(),即可获取到View层的Smarty对象,如下面例子将使用Smarty内置函数fetch来获取模板article_sidebar.html

  1. <?php
  2. class mainextends spController
  3. {
  4.   ...
  5.         function index()
  6.         {
  7.                 $thecodes = $this->getView()->fetch("article_sidebar.htm");
  8.         }
  9.   ...
  10. }               
复制代码

2. 调试模板变量的方法。

在日常开发中,我们经常需要知道对模板的赋值是否正如我们所希望的一样,所以需要在模板输出的同时可以将变量调试输出。那么,我们便可以开启模板调试配置:

  1. $spConfig = array(
  2. ...
  3.         'view' => array(
  4.                 'enabled' => TRUE, // 开启Smarty支持
  5.                 'config' =>array(
  6.                         'template_dir' => APP_PATH.'/tpl', // 模板页面所在的目录
  7.                         'compile_dir' => APP_PATH.'/tmp', // 临时文件编译目录
  8.                         'cache_dir' => APP_PATH.'/tmp', // 临时文件缓存目录
  9.                         'left_delimiter' => '<{',  // Smarty左限定符,默认是{
  10.                         'right_delimiter' => '}>';, // Smarty右限定符,默认是}
  11.                 ),
  12.                 'debugging' => TRUE, // 是否开启视图调试功能,在部署模式下无法开启视图调试功能
  13.         ),
  14. ...               
复制代码

那么,在页面打开的时候,将同时打开一个变量调试的窗口,里面便是我们赋值到模板的变量。

3. 将自定义函数/类的方法注册到模板引擎中——spAddViewFunction

spAddViewFunction是sp框架的扩展应用中经常用到的一个核心函数。

用法:

spAddViewFunction($alias, $callback_function)

参数:

$alias,在模板中使用该函数/类的方法的名称

$callback_function,函数名称或对象的方法数组

例子:

  1. // 这是一个自定义函数,显示当前时间
  2. function showtime(){
  3.   echo date("Y-m-d H:i:s");
  4. }
  5. spAddViewFunction('SHOWTIME', 'showtime'); // 将其注册到模板当中               
复制代码
那么在模板中,我们可以使用该函数了:
  1. <{SHOWTIME}>
复制代码
发表于 2012-8-24 16:36:56 | 显示全部楼层
搜打死内!,哥了了
您需要登录后才可以回帖 登录 | 注册成为新用户

本版积分规则

手机浏览|简版|中文PHP框架|开源协议|SpeedPHP.com ( 粤ICP备08008671号

GMT+8, 2020-4-9 21:46

Powered by Discuz! X3.2

© 2001-2013 Comsenz Inc.

快速回复 返回顶部 返回列表