编辑“Xoops全局变量”

__NOTOC__
<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[Xoops模块开发|上一页]] | {{Template:Xoops导航}}</span>
<div style="clear:both;"></div>

每次读取一个[[XOOPS]]页面时，一些全局变量被自动定义并可在你的模块中使用。注意这些不是对象就是数组。

特别是每个数组，每个可用的元素都被被列出、描述。对每个对象，成员变量（通过$object->getVar('varname')得到）都应被描述。以及任何可得到的方法。注意'getVar'获取一个可选的二次变元[立刻被描述]。 

===$xoopsUser===
若当前访问者注册了的话，这是显示当前用户的对象。（若没注册，这个变量将不被定义。）例如：
<pre>
<?php
$xoopsUser->getVar('uname')
//获取用户名 

$xoopsUser->getVar('uid')
//获取用户ID

$username = !empty($xoopsUser) ? $xoopsUser->getVar('uname') : $xoopsConfig['anonymous']; 

$userid = !empty($xoopsUser) ? $xoopsUser->getVar('uid') : 0;
?>
</pre>

===$xoopsDB===
这是显示Xoops[[数据库]]的对象。如果数据库没有正确初始化，这个变量不被设置。

例如：
* $xoopsDB->query($sql): 执行安全方式查询，即当对数据库做写操作时，只允许POST提交的数据
* $xoopsDB->queryF($sql): 执行强制方式查询，即当对数据库做写操作时不检查数据提交方式
* $xoopsDB->prefix($table): 在表格名称前加上管理员选择的前缀 

===$xoopsConfig (XOOPS Global ConfigurationVariable)===
这个数组包含了Xoops的配置信息。通过$xoopsConfig['name_of_config_option']在'name_of_config_option'里访问其值。如下所示（不完全列表）：
* 'language': 当前语言
* 'anonymous': 匿名用户名称
* 'theme_set': 当前设置的主题名称
* 'template_set': 当前设置的模板名称
* 'sitename' : 站点名称
* 'slogan':站点标题
* 'adminmail':站点管理员[[电子邮件]]地址
* 'closesite':若站点被关闭则设为1
* 'closesite_text':当你的站点被关闭时对用户显示的信息
* 'theme_fromfile' :当设为1时，xoops自动检测你的主题文件是否已经更新；若是，数据库模板被更新
* 'anonpost':设为1则匿名用户可发表评论
* 'use_ssl' :告诉xoops用户登陆是否加密
* 'sslpost_name' :
* 'debug_mode':不同的数字代表调试模式是否打开
* 'com_order':邮件的排序(升序或降序)
* 'com_mode' :邮件查看方式 (Threaded或Flat)
* 'enable_badips':如果IP可被禁止
* 'badips' :被禁止的[[IP]]列表
* 'use_mysession' :如果允许定制[[session]]
* 'session_name':定制session的名称(只在use_mysession为真时才设置)
* 'session_expire' :定制session的有效时间(只在use_mysession为真时才设置)
* 'default_TZ' :缺省时区 


===$xoopsModule===
这是显示当前模块的对象。如果当前在系统模块，这个变量不被定义。

例如:

* $xoopsModule->getVar('dirname'):获取当前模块的目录名 ( XOOPS_ROOT_PATH . '/modules/' . $xoopsModule->getVar('dirname') ) 


===$xoopsModuleConfig===
这是包含了当前模块配置选项的数组。这些值由管理员为模块列在$xoops_version.php中的选项设置。

===$xoopsTpl===
这是显示当前页面模板的对象。

例如:

* $xoopsTpl->assign('varname', $value):在smarty模板中给变量分配一个值 

===$xoopsOption===
这是显示一些特殊的Xoops选项的数组。 









[[category:Xoops模块开发指南]]