前言

之前写的《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'>点击此完成安装 &gt;&gt;</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'>点击此完成安装 &gt;&gt;</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'>点击此进行下一步操作 &gt;&gt;</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'>点击此进行下一步操作 &gt;&gt;</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的样式脚本文件了，都没什么好说的。

总结

安装文件，到此真的结束了。简单来说，就是预定义-》替换-》获取-》储存。