前言
之前写的《dedecms5.7(织梦)源码解析之程序安装》一文中，还有几个值得讲解的文件没有提到，这里说明一下。
代码
templates目录
该文件夹中，一共有step-1.html、step-2.html、step-3.html、step-4.html、step-5.html五个文件，其作用主要为版权信息提示、系统环境检测、数据库和网站基本信息填写、提交表单信息进入index.php文件处理、提示安装成功等功能，可以说是引导用户一步步安装的页面。
module-install.php文件
该文件主要作用为安装模块，具体作用请见如下代码和注释：
<?php
/**
* @version $Id: module-install.php 1 13:41 2010年7月26日Z tianya $
* @package DedeCMS.Install
* @copyright Copyright (c) 2007 - 2010, DesDev, Inc.
* @license http://help.dedecms.com/usersguide/license.html
* @link http://www.dedecms.com
*/
// 包含进入全局配置文件
require_once(dirname(__FILE__).'/../include/common.inc.php');
// 设定时间永不过期
@set_time_limit(0);
// 定义版本
$verMsg = ' V5.7 GBK';
// 初始化错误信息
$errmsg = '';
// 安装锁文件
$insLockfile = dirname(__FILE__).'/install_lock.txt';
// 模块缓存文件
$moduleCacheFile = dirname(__FILE__).'/modules.tmp.inc';
// 模块数据目录
$moduleDir = DEDEROOT.'/data/module';
// 系统后台目录
$AdminBaseDir = DEDEROOT.'/dede/';
// 判断是否存在安装锁文件
if(file_exists($insLockfile))
{
// 如果已经存在则提示已经安装
exit(" 程序已运行安装，如果你确定要重新安装，请先从FTP中删除 install/install_lock.txt！");
}
// 包含模块类
require_once(DEDEINC.'/dedemodule.class.php');
// 包含模块缓存文件
require_once(dirname(__FILE__).'/modulescache.php');
// 包含安装配置文件
require_once(dirname(__FILE__).'/install.inc.php');
// 初始化安装步骤为0
if(empty($step)) $step = 0;
//完成安装
if($step==9999)
{
// 写入配置文件
ReWriteConfigAuto();
// 更新栏目缓存
UpDateCatCache();
// 包含步骤5文件，提示用户完成信息
include('./templates/step-5.html');
// 终止程序执行
exit();
}
//用户选择的模块列表缓存文件
// 判断是否存在该缓存文件
if(!file_exists($moduleCacheFile))
{
// 如果不存在，则提示出错信息
$msg = "<font color='red'>由于无法找到模块缓存文件，安装可选模块失败，请登录后在模块管理处安装。</font><br /><br />";
$msg .= "<a href='module-install.php?step=9999' target='_top'>点击此完成安装 >></a>";
// 输出出错信息
ShowMsg($msg,'javascript:;');
exit();
}
//模块文件夹权限
if(!TestWrite($moduleDir))
{
// 如果没有权限，则定义出错信息和输出出错信息
$msg = "<font color='red'>目录 {$moduleDir} 不支持写入，不能安装模块，请登录后在模块管理处安装。</font><br /><br />";
$msg .= "<a href='module-install.php?step=9999' target='_top'>点击此完成安装 >></a>";
ShowMsg($msg,"javascript:;");
exit();
}
// 包含模块缓存文件
include($moduleCacheFile);
// 按照逗号进行分割
$modules = split(',',$selModule);
// 统计数量
$totalMod = count($modules);
// 如果当前步骤大于数量
if($step >= $totalMod)
{
// 则完成了所有安装并且提示信息
$msg = "<font color='red'>完成所有模块的安装！</font><br /><br />";
$msg .= "<a href='module-install.php?step=9999' target='_top'>点击此进行下一步操作 >></a>";
ShowMsg($msg,'javascript:;');
exit();
}
// 模块hash
$moduleHash = $modules[$step];
// 模块文件
$moduleFile = $allmodules[$moduleHash];
// 实例化模块类
$dm = new DedeModule($moduleDir);
// 获得$moduleHash模块的基本信息
$minfos = $dm->GetModuleInfo($moduleHash);
// 将数组中变量导入到当前符号表中
extract($minfos, EXTR_SKIP);
// 获得系统文件的内容后进行转义
$menustring = addslashes($dm->GetSystemFile($moduleHash,'menustring'));
// 构建插入语句
$query = "INSERT INTO `#@__sys_module`(`hashcode` , `modname` , `indexname` , `indexurl` , `ismember` , `menustring` )
VALUES ('$moduleHash' , '$name' , '$indexname' , '$indexurl' , '$ismember' , '$menustring' ) ";
// 执行删除语句
$rs = $dsql->ExecuteNoneQuery("Delete From `#@__sys_module` where hashcode like '$moduleHash' ");
// 执行上方插入语句
$rs = $dsql->ExecuteNoneQuery($query);
// 如果执行失败
if(!$rs)
{
// 提示并输出错误信息
$msg = "<font color='red'>保存数据库信息失败，无法完成你选择的模块安装！</font><br /><br />";
$msg .= "<a href='module-install.php?step=9999' target='_top'>点击此进行下一步操作 >></a>";
exit();
}
//写文件
$dm->WriteFiles($moduleHash,1);
// 写系统文件
$dm->WriteSystemFile($moduleHash,'readme');
// 获得系统文件
$setupsql = $dm->GetSystemFile($moduleHash,'setupsql40');
//运行SQL
$mysql_version = $dsql->GetVersion(TRUE);
$setupsql = preg_replace("#ENGINE=MyISAM#i", 'TYPE=MyISAM', $setupsql);
$sql41tmp = 'ENGINE=MyISAM DEFAULT CHARSET='.$cfg_db_language;
// 如果版本大于4.1，则执行此中替换
if($mysql_version >= 4.1) {
$setupsql = preg_replace("#TYPE=MyISAM#i", $sql41tmp, $setupsql);
}
//_ROOTURL_ 定义根目录
if($cfg_cmspath=='/') $cfg_cmspath = '';
// 定义根目录路径url
$rooturl = $cfg_basehost.$cfg_cmspath;
// 将预定义的字符替换成根目录url
$setupsql = preg_replace("#_ROOTURL_#i", $rooturl, $setupsql);
// 替换换行符
$setupsql = preg_replace("#[\r\n]{1,}#", "\n", $setupsql);
// 按照;进行分割
$sqls = preg_split("#;[ \t]{0,}\n#", $setupsql);
// 遍历进行执行
foreach($sqls as $sql) {
if(trim($sql)!='') $dsql->executenonequery($sql);
}
// 清理
$dm->Clear();
// 步骤+1，（方便执行下一步）
$step = $step + 1;
// 提示信息
ShowMsg("模块 {$name} 安装完成，准备下一模块安装...", "module-install.php?step={$step}");
exit();module_autos.php文件
该文件在步骤5（安装完成）页面会以iframe的形式展示给用户，当然，在用户看来，是step-5.html页面中，它的作用主要是提示用户访问页面和自动安装畅言模块，请看下面代码和注释：
<?php
// 包含全局配置文件
require_once(dirname(__FILE__).'/../include/common.inc.php');
// 包含模块临时配置文件
$moduleCacheFile = dirname(__FILE__).'/modules.tmp.inc';
// 包含模块缓存配置文件
include($moduleCacheFile);
// 逗号分割
$modules = split(',',$selModule);
// 包含安装锁文件
$insLockfile = dirname(__FILE__).'/install_lock.txt';
// 如果存在安装锁文件，则提示信息，方便用户访问前台or后台
if(file_exists($insLockfile))
{
echo <<<EOT
<link href="style.css" rel="stylesheet" type="text/css" />
<div class="over-link fs-14" style="padding:0px;">
<a href="../index.php?upcache=1" target='_top'>访问网站首页</a>
<a href="../dede" target='_top'>登录网站后台</a>
</div>
EOT;
exit();
}
// 初始化畅言模块信息
$module_autos=array(
'606c658db048ea7328ffe1c7ae2a732f'=>array(
'name'=>'changyan_autoreg',
'title'=>'畅言模块'
)
);
$logs = '';
foreach($module_autos as $hh=>$module_auto)
{
// 判断当前键是否在modules中，如果不存在，则直接跳过
if(!in_array($hh, $modules)) continue;
// 包含安装畅言文件的路径
$autofile = dirname(__FILE__).'/module_autos/'.$module_auto['name'].'.php';
// 检测存在，则包含
if(file_exists($autofile)) require_once($autofile);
// 否则跳过
else continue;
// 将$module_auto['name']第一个字母转大写,方便下面创建实例
$clsname = ucfirst($module_auto['name']);
// 创建实例
$macls = new $clsname();
// 如果执行失败，则提示出错
if(!$macls->run()) $logs .= "初始化{$module_auto['title']}出错：".$macls->errmsg."<br/>";
// 否则提示成功
else $logs .= "成功初始化{$module_auto['title']}<br/>";
}
// 以写入的方式打开文件锁文件
$fp = fopen($insLockfile,'w');
// 写入ok
fwrite($fp,'ok');
fclose($fp);
// 删除模块临时配置文件
@unlink('./modules.tmp.inc');
// 输出提示信息
echo <<<EOT
<link href="style.css" rel="stylesheet" type="text/css" />
<div class="over-link fs-14" style="padding:0px;">
<a href="../index.php?upcache=1" target='_top'>访问网站首页</a>
<a href="../dede" target='_top'>登录网站后台</a>
</div>
EOT;
?>module_autos/changyan_autoreg.php文件
该文件主要作用为安装畅言插件类文件，在install/module.autos.php文件中有引用和创建实例，请看下面代码和注释：
<?php
/**
* Class Changyan_autoreg 畅言插件自动安装注册类
*/
class Changyan_autoreg
{
var $errmsg='';
/**
* 运行方法
* 也是该类中唯一一个方法
*
* @param int $step
*
* @return bool
*/
function run($step=0)
{
// 初始化全局变量
global $dsql,$update_sqls,$cfg_db_language,$cfg_webname;
// 判断畅言助手文件是否存在
if(!file_exists(DEDEINC.'/helpers/changyan.helper.php'))
{
// 如果不存在，则提示安装失败信息
$this->errmsg = '未成功安装畅言模块文件';
return FALSE;
}
// 载入助手
helper('changyan');
// 检测是否存在plus_changyan_setting数据表
if( !$dsql->IsTable("#@__plus_changyan_setting") )
{
$this->errmsg = '未成功初始化畅言模块所需数据库';
return FALSE;
}
// 定义版本信息
if (empty($version)) $version = '0.0.1';
// 比较版本
if (version_compare($version, CHANGYAN_VER, '<')) {
// 获得MySql的版本号
$mysql_version = $dsql->GetVersion(TRUE);
// 遍历更新sql语句
foreach ($update_sqls as $ver => $sqls) {
// 如果小于指定版本，则跳过
if (version_compare($ver, $version,'<')) {
continue;
}
// 遍历执行
foreach ($sqls as $sql) {
// 替换预定义字符串
$sql = preg_replace("#ENGINE=MyISAM#i", 'TYPE=MyISAM', $sql);
$sql41tmp = 'ENGINE=MyISAM DEFAULT CHARSET='.$cfg_db_language;
// mysql版本小于4.1的操作
if($mysql_version >= 4.1)
{
$sql = preg_replace("#TYPE=MyISAM#i", $sql41tmp, $sql);
}
// 执行sql语句，不返回结果
$dsql->ExecuteNoneQuery($sql);
}
// 设置版本
changyan_set_setting('version', $ver);
$version=changyan_get_setting('version');
}
// 获取key
$isv_app_key = changyan_get_isv_app_key();
}
// 获取用户
$db_user = changyan_get_setting('user');
if(!empty($db_user))
{
$this->errmsg = '已经初始化畅言账号，无需再进行初始化';
return FALSE;
}
/**
* 按照api规则发送消息到畅言
*/
$sign=changyan_gen_sign(CHANGYAN_CLIENT_ID);
$url = $_SERVER['SERVER_NAME'];
$isv_name = cn_substr($cfg_webname,20);
$paramsArr=array(
'client_id'=>CHANGYAN_CLIENT_ID,
'isv_name'=>changyan_autoCharset($isv_name),
'url'=>'http://'.$url,
'sign'=>$sign);
$rs=changyan_http_send(CHANGYAN_API_AUTOREG,0,$paramsArr);
$result=json_decode($rs,TRUE);
/**
* 接收返回结果，并储存
*/
if($result['status']==0)
{
// 保存appid,id信息
changyan_set_setting('user', $result['user']);
changyan_set_setting('appid', $result['appid']);
changyan_set_setting('id', $result['id']);
changyan_set_setting('isv_app_key', $result['isv_app_key']);
changyan_set_setting('isv_id', $result['isv_id']);
changyan_clearcache();
$passwd = changyan_mchStrCode($result['passwd'], 'ENCODE');
changyan_set_setting('pwd', $passwd);
return TRUE;
} else {
if($step > 3)
{
$this->errmsg = '无法成功初始化畅言模块';
return FALSE;
}
$step++;
return $this->run($step);
}
}
}
?>其他文件
其他诸如*.inc.php都是配置文件，cache.php都是缓存文件，还要就是.css和.js的样式脚本文件了，都没什么好说的。
总结
安装文件，到此真的结束了。简单来说，就是预定义-》替换-》获取-》储存。
