做过phpcms开发人的一定知道,phpcms提供了大量内置的变量供我们在模版中调用,比如{$position} {$title}分别代表当前的位置与文章的标题。在方便使用的同时,我们不禁要问,为什么我们可以使用这些变量?在什么情况下,这些变量才有意义?
其实,我们可以将这几个问题归结为phpcms中html文件的生成过程。一切都是从admin.php开始的,我们在后台进行不同的操作(如生成文件,图片等)将会导致admin.php包含(include)不同的文件。而被包含者又会根据传给它参数的不同而包含不同的文件,这样一路包含下去,直到调用到我们的模版。这一路上所经过的文件和admin.php本身组成了最终的admin.php。而我们可以调用的变量就是在这些文件中出现过的变量,这也是我们判断变量是否可用的标准。这不难理解,因为我们的模版文件最终也被包含在了admin.php中,而它调用的变量或许原先不在admin.php中,但此刻却也被包含了进来。
下面以模版中自定义标签如何被翻译来解释上面的内容。这个标签实现了上一篇下一篇的功能,标签名为{tag_上一篇下一篇}。点击生成文章后的链接为:http://127.0.0.1/phpcms2007_sp6_gbk/phpcms/admin.php?mod=article&file=createhtml&action=create_show&channelid=1&referer=****标签代码如下:
1 php
2 defined ( ' in_phpcms ' ) or exit ( ' access denied ' );
3 ?>
4 php
5 global $articleid , $db ;
6 $sqlpre = select * from phpcms_article_1 where articleid 7 $sqlaft = select * from phpcms_article_1 where articleid>' $articleid ' order by articleid asc ;
8 $preart = $db -> get_one( $sqlpre );
9 $afart = $db -> get_one( $sqlaft );
10 if ( ! $preart [ ' title ' ])
11 $preart = $db -> get_one( select * from phpcms_article_1 order by articleid desc );
12 if ( ! $afart [ ' title ' ])
13 $afart = $db -> get_one( select * from phpcms_article_1 where articleid=1 );
14 $preurl = $preart [ ' linkurl ' ];
15 $afurl = $afart [ ' linkurl ' ];
16 $pretitle = $preart [ ' title ' ];
17 $aftitle = $afart [ ' title ' ];
18 $url = $php_scheme . $php_domain . phpcms_path;
19 echo
上一篇: $pretitle ;
20 echo 下一篇: $aftitle ;
21 ?> 原理很简单,根据当前页面的索引($articleid)通过数据库($db)查询它的上一篇和下一篇,并最终通过echo打印的页面上。但是,我们如何得知$articleid,$db的存在呢?这就需要我们理解在点击生成文章后后台都做了些什么?通过分析,执行这一命令后,消息路由如下:
admin . php -> phpcms module article admin.inc.php->phpcms module article admin createhtml.inc.php(case 'create_show':)->golbal.func.php(createhtml)->phpcms module article include createhtm show . php
消息路由到了这个文件,通过:
ob_start ();
include template( $mod , $templateid );
$data = ob_get_contents ();
ob_clean ();
file_put_contents($filename, $data);完成了html文件的创建与写入。如果深究下去,可以发现template()调用了template_refresh(),而template_refresh()则调用template_parse()对phpcms的标签进行解释,并翻译了纯php。
之后template()函数返回,被输出到了浏览器缓冲区(由ob_start()打开),与被输出到屏幕一样,此时文件中内嵌的php会被翻译成html的形式。对于自定义标签来讲,它被template_parse()翻译成,因此,在输出时会调用phpcms_mytag()函数。而正是由这个函数将最终的自定义标签的文件给包含了进来。这样一来,自定义标签的文件和包含$articleid,$db的文件结合在了一起,因此,此时便可以在自定义标签文件中使用这两个变量了。