由于options作为一个独立模块存在,因此没有放到内置方法列表里。
options是 Options 类(Core\Options) 的对象,有几个用于回显的方法,也可以直接访问属性。
# 属性
严格的来说,Options 里没有任何public的属性,但是得益于PHP的魔术方法,可以用特殊的方法来访问它。我们访问的属性是Options::$options数组里的元素。
$options的数据来自数据表options,里面都是网站、用户、插件和主题的一些配置。例如,要提取网站名称,只要这样访问:$this->options->siteName。此外,为了安全,不支持通过该方式增加或修改属性。
# 方法
下面的方法,大多数都没有返回值。没有返回值的方法主要用于主题中回显一些内容。
调用方法:$this->options->xxx(); 其中xxx为方法名,部分方法可加参数。
## set
原型:`set($key, $value, $uid = 0, $saveNow = false)`
作用:设置options的内容,最后一个参数表示是否马上保存。一般不建议主题直接使用该方法,比较危险。
## get
原型:`get($key, $default = null, $uid = 0)`
作用:获取options的内容,优先读取缓存,若缓存无数据则读数据库。(这里的缓存指的是某一次请求的访问,由于PHP的特性,每次请求时都是一个新的实例,所以不会存在之前请求的缓存)
## gets
原型:`gets($keys, $uid = 0)`
作用:获取多个key的内容,直接读取数据库,不经过缓存。
## title
参数:无
作用:回显网站名称
## siteUrl
参数:后缀,如 /123.html
作用:回显网站URL,加参数可加上对应的后缀,主要用于某些特殊页面或首页的导航。
## description
参数:无
作用:回显网站的描述,一般用于meta标签
## keyword
参数:无
作用:回显网站的关键词,一般用于meta标签
## adminUrl
参数:无
作用:回显后台的URL
## profileUrl
参数:无
作用:回显用户信息页面的URL(其实是后台的user-editor.php)
## loginUrl
参数:无
作用:回显登录页面URL
## logoutUrl
参数:无
作用:回显登出URL
## registerUrl
参数:无
作用:回显注册页面URL