编辑“Xoops模块安装/更新的执行脚本”（章节）

===模块安装===
'''配置文件声明'''

首先你需要在xoops_version.php中加入下面这行命令
<pre>
$modversion['onInstall'] = 'include/installscript.php';
</pre>

'''创建函数'''

它会告诉模块的安装[[程序]]运行和xoops_version.php在同一目录下的脚本installscript.php。现在我们需要使用实际安装前后后的脚本。例如我们想为新的模块foo创建一个上传文件目录。在/modules/foo/include/目录下创建 installscript.php的文件，然后加入下面的语句：
<pre>
<?
function xoops_module_install_foo(&$module)
{
	// Create a folder “foo” inside XOOPS_ROOT_PATH/uploads/
	
	return true;
}
?>
</pre>

说明：上面的代码是什么意思？让我们看仔细一点。
<pre>
function xoops_module_install_foo(&$module)
</pre>

当[[XOOPS]]安装一个模块时，会在我们安装后的脚本中找一个叫做xoops_module_install_<module directory>的函数。如果找到这个函数就会运行它，为我们最近安装的模块的xoopsModule对象提供一个参考。如果XOOPS找不到这个文件或里面的函数，那么模块的初始化例行程序会再次重新出现并且继续执行。

'''执行结果'''

在结束了初始化任务后，如果成功函数应该返回true，否则返回false。如果返回true你应该在安装上看到这个信息：

xoops_module_install_foo executed successfully.

如果返回false你将看到：

Failed to execute xoops_module_install_foo

同样，阻止从安装函数发出输出状态信息。这些信息不在页面信息流显示，但可能在管理标题上--不是正好是你得到的。

'''预执行命令'''

模块安装开始前系统会自动检查是否定义了xoops_module_pre_install_foo函数。如果定义了则自动执行。可用于模块安装的预处理，比如检查模块所需的系统条件是否满足，如果不满足则提示并停止安装。
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*