本文档介绍了所有能用于模板的全局变量,所有AKCMS的模板不管是什么类型的页面都可以调用以下变量:
$charset | 字符编码,一般是gbk或者utf-8,可直接用于<meta>中,不过考虑到字符编码一般很少改变,一般用到的机会不多。 用法举例: <meta http-equiv='Content-Type' content='text/html; charset=<{$charset}>' /> |
$thetime | 当前时间的unix时间戳(如果生成静态文件后,这个时间就不会变化了,就代表生成文件时候的时间),这个时间戳应用了当前系统的时差设置,比如如果当前时区是+8,则比标准时间多8 * 3600秒,此变量一般与javascript配合使用。 |
$page | 这是个特殊的变量,如果是动态页它代表了URL中page参数的值(?page=123);如果是静态页则代表当前分页的页码;如果没有page参数或page参数的值不是整数,则取默认值:1。 |
$home | 用于指向当前网站的首页,大部分情况下网站都安装在根目录下,所以可以用/来代表相对路径。但也有时候模板的制作者不知道站长会把网站安装在哪个子目录下,这时就用到这个了$home了,在调用css、js时可以用到 用法举例: <script language='javascript' type='text/javascript' src='<{$home}>/js/jquery.js'></script> <link rel='stylesheet' href='<{$home}>/css/common.css' /> |
访客变量
浏览器传入的内容也可以作为变量获得,我们称之为访客变量。绝大多数变量在对应页面已经有安全的替代,不到万不得已不要调用用户传入的变量,除非你很清楚你在做什么。警告:严禁直接调用未经处理的原始内容,这相当于自杀!
<{$get_d_abc}> <!--严禁直接调用,上面这样的写法极为危险!!-->
$get_abc | 通过GET方式传入的abc变量(内容经过htmlspecialchars处理) |
$get_d_abc | 通过GET方式传入的abc变量的原始值 |
$get_u_abc | 通过GET方式传入的abc变量(内容经过urlencode处理) |
$cookie_abc | 通过COOKIE传入的abc变量(内容经过htmlspecialchars处理) |
$cookie_d_abc | 通过COOKIE传入的abc变量的原始值 |
$setting_abc | 系统设置的值,用于二次开发(abc代表设置项的key) |