dedecms5.7(织梦)源码解析之程序安装补全篇

青叶

前言

之前写的《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的样式脚本文件了,都没什么好说的。

总结

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

阅读 3.7k

The code
The code

一个phper

1.5k 声望
108 粉丝
0 条评论
你知道吗?

一个phper

1.5k 声望
108 粉丝
文章目录
宣传栏