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

摘要：前言众所周知，在第一次运行时会检测是否安装，如果没有，则自动跳转到安装界面，进行用户友好的安装步骤，下面我们就来从源码看看这一切是如何完成的。总结安装的话，到此结束了，基本都是接收表单参数，操作文件和数据库的东西。

众所周知，dedecms在第一次运行时会检测是否安装，如果没有，则自动跳转到安装界面，进行用户友好的安装步骤，下面我们就来从源码看看这一切是如何完成的。

默认服务器配置入口文件是index.html,index.php等，织梦uploads文件夹中仅有index.php,遂直接运行index.php文件啊，源码如下：

GetOne("Select * From `#@__homepageset`");
    $row["templet"] = MfTemplet($row["templet"]);
    $pv = new PartView();
    $pv->SetTemplet($cfg_basedir . $cfg_templets_dir . "/" . $row["templet"]);
    $row["showmod"] = isset($row["showmod"])? $row["showmod"] : 0;
    if ($row["showmod"] == 1)
    {
        $pv->SaveToHtml(dirname(__FILE__)."/index.html");
        include(dirname(__FILE__)."/index.html");
        exit();
    } else { 
        $pv->Display();
        exit();
    }
}
else
{
    header("HTTP/1.1 301 Moved Permanently");
    header("Location:index.html");
}
?>

纵观整个文件，其中代码大概分成了两部分：

判断是存在全局配置文件（是否安装）

判断根目录是否存在index.html文件，没有则生成

具体请看下面带有注释的代码：

GetOne("Select * From `#@__homepageset`");
    // 模板目录规则
    $row["templet"] = MfTemplet($row["templet"]);
    // 创建视图对象
    $pv = new PartView();
    // 设置要解析的模板
    $pv->SetTemplet($cfg_basedir . $cfg_templets_dir . "/" . $row["templet"]);
    // 这里接收的应该是模块参数，方便后面进行判断
    $row["showmod"] = isset($row["showmod"])? $row["showmod"] : 0;
    // 判断当前模块
    if ($row["showmod"] == 1)
    {
        // 生成index.html文件
        $pv->SaveToHtml(dirname(__FILE__)."/index.html");
        // 生成后包含进来（注意不是跳转哦）
        include(dirname(__FILE__)."/index.html");
        // 终止
        exit();
    } else { 
        // 直接执行
        $pv->Display();
        // 终止
        exit();
    }
}
else
{
    // 设置301header跳啊转
    header("HTTP/1.1 301 Moved Permanently");
    // 跳转进入index.html页面
    header("Location:index.html");
}
?>

好，index.php入口文件我们从上面的注释中已经能够大概明白他的内容和作用了，下面就顺着安装步骤找安装文文件install/index.php吧，由于这个文件内容太多，源码我就不放了，直接放上我注释过的源码内容：

 $_v) ${$_k} = RunMagicQuotes($_v);
}

// 包含进入系统核心函数文件
require_once(DEDEINC."/common.func.php");

// 检测安装锁文件是否已经存在，如果存在终止程序执行，并提示文件已经安装
if(file_exists($insLockfile))
{
    exit(" 程序已运行安装，如果你确定要重新安装，请先从FTP中删除 install/install_lock.txt！");
}

// 初始化文件安装步骤
if(empty($step))
{
    $step = 1;
}
/*------------------------
使用协议书
function _1_Agreement()
------------------------*/
// 如果为第一步，则引入使用协议书页面
if($step==1)
{
    // 引入第一个页面（使用协议书）
    include("./templates/step-1.html");
    // 终止当前执行
    exit();
}
/*------------------------
环境测试
function _2_TestEnv()
------------------------*/
// 如果为第二部，则引入环境测试页面
else if($step==2)
{
    // 获取php版本
    $phpv = phpversion();
    // 获取当前操作系统类型
    $sp_os = PHP_OS;
    // 获得GD的版本
    $sp_gd = gdversion();
    // 获取服务器标识的字串
    $sp_server = $_SERVER["SERVER_SOFTWARE"];
    // 获取当前host-如果ip不存在，则直接获取主机名，否则为ip
    $sp_host = (empty($_SERVER["REMOTE_ADDR"]) ? $_SERVER["REMOTE_HOST"] : $_SERVER["REMOTE_ADDR"]);
    // 获取当前服务器主机名称
    $sp_name = $_SERVER["SERVER_NAME"];
    // 获取当前配置最大执行时间
    $sp_max_execution_time = ini_get("max_execution_time");
    // 获取当前在函数调用时参数被按照引用传递时是否发出警告-php5.4以上已经移除
    $sp_allow_reference = (ini_get("allow_call_time_pass_reference") ? "[√]On" : "[×]Off");
    // 获取当前是否 URL 形式的 fopen 封装协议
    $sp_allow_url_fopen = (ini_get("allow_url_fopen") ? "[√]On" : "[×]Off");
    // 获取当前是否已经打开php的安全模式
    $sp_safe_mode = (ini_get("safe_mode") ? "[×]On" : "[√]Off");
    // 获取当前是否打开gd库
    $sp_gd = ($sp_gd>0 ? "[√]On" : "[×]Off");
    // 获取当前是否打开mysql扩展
    $sp_mysql = (function_exists("mysql_connect") ? "[√]On" : "[×]Off");

    // 判断并定义mysql错误
    if($sp_mysql=="[×]Off")
    $sp_mysql_err = TRUE;
    else
    $sp_mysql_err = FALSE;

    // 定义测试目录
    $sp_testdirs = array(
        "/",
        "/plus/*",
        "/dede/*",
        "/data/*",
        "/a/*",
        "/install",
        "/special",
        "/uploads/*"
    );
    // 包含第二部文件
    include("./templates/step-2.html");
    // 终止本次执行
    exit();
}
/*------------------------
设置参数
function _3_WriteSeting()
------------------------*/
// 第三部设置参数
else if($step==3)
{
    // 取得当前URL的 路径地址
    if(!empty($_SERVER["REQUEST_URI"]))
    $scriptName = $_SERVER["REQUEST_URI"]; // 如果存在，则直接写入
    else
    $scriptName = $_SERVER["PHP_SELF"]; // 获取正在执行脚本的文件名

    // 通过正则替换，获得基础目录-根目录路径
    $basepath = preg_replace("#/install(.*)$#i", "", $scriptName);

    // 获取当前请求的 Host: 头部的内容。
    if(!empty($_SERVER["HTTP_HOST"]))
        $baseurl = "http://".$_SERVER["HTTP_HOST"]; // 存在则写入
    else
        $baseurl = "http://".$_SERVER["SERVER_NAME"]; // 获取服务器主机的名称

    // 大小写字母和阿拉伯数字
    $chars="abcdefghigklmnopqrstuvwxwyABCDEFGHIGKLMNOPQRSTUVWXWY0123456789";
    // 随机cookie编码
    $rnd_cookieEncode="";
    // 随机长度
    $length = rand(28,32);
    // $chars最大长度
    $max = strlen($chars) - 1;
    // 按随机生成的长度进行for循环
    for($i = 0; $i < $length; $i++) {
        // 每次存入$chars中一个随机字符
        $rnd_cookieEncode .= $chars[mt_rand(0, $max)];
    }
    // 初始化数据体验包为关闭
    $isdemosign = 0;
    // 判断如果存在初始化体验包的文件，则数据体验包设置为开启
    if(file_exists($install_demo_name) && file_get_contents($install_demo_name)) $isdemosign = 1;
    // 定义数据模块目录
    $module_local = DEDEDATA."/module/";
    // 包含第三个页面文件
    include("./templates/step-3.html");
    // 终止执行
    exit();
}
/*------------------------
普通安装
function _4_Setup()
------------------------*/
// 进入普通安装步骤
else if($step==4)
{
    // 按照用户输入连接mysql数据库
    $conn = mysql_connect($dbhost,$dbuser,$dbpwd) or die("");
    // 如果数据库不存在，则创建数据库
    mysql_query("CREATE DATABASE IF NOT EXISTS `".$dbname."`;",$conn);
    // 选择数据库
    mysql_select_db($dbname, $conn) or die("");

    //获得数据库版本信息
    $rs = mysql_query("SELECT VERSION();",$conn);
    // 从结果集中取得一行作为数组
    $row = mysql_fetch_array($rs);
    // 按.分割
    $mysqlVersions = explode(".",trim($row[0]));
    // 重组，只要前两个主要和次要版本即可
    $mysqlVersion = $mysqlVersions[0].".".$mysqlVersions[1];
    // 设置字符集
    mysql_query("SET NAMES "$dblang",character_set_client=binary,sql_mode="";",$conn);
    // 创建全局配置文件
    $fp = fopen(dirname(__FILE__)."/common.inc.php","r");
    // 读取全局配置文件
    $configStr1 = fread($fp,filesize(dirname(__FILE__)."/common.inc.php"));
    // 关闭文件资源
    fclose($fp);

    // 打开安装配置缓存文件
    $fp = fopen(dirname(__FILE__)."/config.cache.inc.php","r");
    // 读取安装配置缓存文件
    $configStr2 = fread($fp,filesize(dirname(__FILE__)."/config.cache.inc.php"));
    // 关闭资源
    fclose($fp);

    //common.inc.php 定义部分需要写入全局配置文件的内容
    $configStr1 = str_replace("~dbhost~",$dbhost,$configStr1);
    $configStr1 = str_replace("~dbname~",$dbname,$configStr1);
    $configStr1 = str_replace("~dbuser~",$dbuser,$configStr1);
    $configStr1 = str_replace("~dbpwd~",$dbpwd,$configStr1);
    $configStr1 = str_replace("~dbprefix~",$dbprefix,$configStr1);
    $configStr1 = str_replace("~dblang~",$dblang,$configStr1);

    // 设置根目录data目录权限
    @chmod(DEDEDATA,0777);
    // 打开全局配置文件（创建），如果无法创建，则说明目录没有写入权限
    $fp = fopen(DEDEDATA."/common.inc.php","w") or die("");
    // 将自带的缓存配置文件中部分相应内容写入全局配置文件中
    fwrite($fp,$configStr1);
    // 关闭文件资源
    fclose($fp);

    //config.cache.inc.php
    // CMS安装目录，匹配至少一个/
    $cmspath = trim(preg_replace("#/{1,}#", "/", $cmspath));
    // 如果匹配到了至少一个/而且也没有匹配到以/开头的（加上/,即加上根目录）
    if($cmspath!="" && !preg_match("#^/#", $cmspath)) $cmspath = "/".$cmspath;

    // 如果cms路径为空，则indexUrl为/
    if($cmspath=="") $indexUrl = "/";
        // 否则indexUrl等于cms路径
    else $indexUrl = $cmspath;

    // 从安装配置缓存文件中读取部分配置用于后面写入
    $configStr2 = str_replace("~baseurl~",$baseurl,$configStr2);
    $configStr2 = str_replace("~basepath~",$cmspath,$configStr2);
    $configStr2 = str_replace("~indexurl~",$indexUrl,$configStr2);
    $configStr2 = str_replace("~cookieEncode~",$cookieencode,$configStr2);
    $configStr2 = str_replace("~webname~",$webname,$configStr2);
    $configStr2 = str_replace("~adminmail~",$adminmail,$configStr2);

    // 创建data目录下的缓存配置文件
    $fp = fopen(DEDEDATA."/config.cache.inc.php","w");
    // 写入
    fwrite($fp,$configStr2);
    // 关闭资源
    fclose($fp);

    // 创建data目录下的缓存配置备份文件
    $fp = fopen(DEDEDATA."/config.cache.bak.php","w");
    // 写入
    fwrite($fp,$configStr2);
    // 关闭资源
    fclose($fp);

    // 检测mysql版本是否大于4.1
    if($mysqlVersion >= 4.1)
    {
        // 如果大于，则将引擎设置为MyISAM，字符集设置为$dblanag内容
        $sql4tmp = "ENGINE=MyISAM DEFAULT CHARSET=".$dblang;
    }

    //创建数据表
    // 初始化定义变量
    $query = "";
    // 以只读方式打开数据表文件
    $fp = fopen(dirname(__FILE__)."/sql-dftables.txt","r");
    // while循环-如果文件没有到达末尾 则执行while中的代码
    while(!feof($fp))
    {
        // 从文件指针中读取一行,并去除首尾空格
        $line = rtrim(fgets($fp,1024));
        // 正则匹配出;号
        if(preg_match("#;$#", $line))
        {
            // 将每行末尾加上
换行符
            $query .= $line."
";
            // 将#@__替换成数据库表前缀
            $query = str_replace("#@__",$dbprefix,$query);
            // 如果数据库版本小于4.1的情况下
            if($mysqlVersion < 4.1)
            {
                // 直接执行查询
                $rs = mysql_query($query,$conn);
            } else {
                // 否则匹配出query中是否存在create创建语句
                if(preg_match("#CREATE#i", $query))
                {
                    // 如果有，则将其中的TYPE=MyISAM替换成上面定义的$sql4tmp内容，并且执行创建
                    $rs = mysql_query(preg_replace("#TYPE=MyISAM#i",$sql4tmp,$query),$conn);
                }
                else
                {
                    // 否则直接执行
                    $rs = mysql_query($query,$conn);
                }
            }
            // while末尾，清空$query,方便下一次存入数据
            $query="";
        } else if(!preg_match("#^(//|--)#", $line))
        { // 正则匹配是否存在//或者--，如果不存在，则赋值$query，方便下一次连接执行
            $query .= $line;
        }
    }
    // 关闭文件资源
    fclose($fp);

    //导入默认数据
    // 初始化定义变量
    $query = "";
    // 以只读方式打开数据表内容文件
    $fp = fopen(dirname(__FILE__)."/sql-dfdata.txt","r");
    // while循环-如果文件没有到达末尾 则执行while中的代码
    while(!feof($fp))
    {
        // 读取第一行，并清空两边空格
        $line = rtrim(fgets($fp, 1024));
        // 正则匹配;号
        if(preg_match("#;$#", $line))
        {
            // 接入
            $query .= $line;
            // 替换前缀符号
            $query = str_replace("#@__",$dbprefix,$query);
            // 如果mysql版本小于4.1,直接执行
            if($mysqlVersion < 4.1) $rs = mysql_query($query,$conn);
                // 否则将文件中的lang换成$dblang内容
            else $rs = mysql_query(str_replace("#~lang~#",$dblang,$query),$conn);
            // 重置 $query
            $query="";
        } else if(!preg_match("#^(//|--)#", $line))
        { // 不到末尾，继续拼接
            $query .= $line;
        }
    }
    // 关闭资源
    fclose($fp);

    //更新配置
    // 下面是按照页面中的变量，更新刚才插入数据库中的一些数据
    $cquery = "Update `{$dbprefix}sysconfig` set value="{$baseurl}" where varname="cfg_basehost";";
    mysql_query($cquery,$conn);
    $cquery = "Update `{$dbprefix}sysconfig` set value="{$cmspath}" where varname="cfg_cmspath";";
    mysql_query($cquery,$conn);
    $cquery = "Update `{$dbprefix}sysconfig` set value="{$indexUrl}" where varname="cfg_indexurl";";
    mysql_query($cquery,$conn);
    $cquery = "Update `{$dbprefix}sysconfig` set value="{$cookieencode}" where varname="cfg_cookie_encode";";
    mysql_query($cquery,$conn);
    $cquery = "Update `{$dbprefix}sysconfig` set value="{$webname}" where varname="cfg_webname";";
    mysql_query($cquery,$conn);
    $cquery = "Update `{$dbprefix}sysconfig` set value="{$adminmail}" where varname="cfg_adminemail";";
    mysql_query($cquery,$conn);

    //增加管理员帐号
    $adminquery = "INSERT INTO `{$dbprefix}admin` VALUES (1, 10, "$adminuser", "".substr(md5($adminpwd),5,20)."", "admin", "", "", 0, "".time()."", "127.0.0.1");";
    mysql_query($adminquery,$conn);

    //关连前台会员帐号
    $adminquery = "INSERT INTO `{$dbprefix}member` (`mid`,`mtype`,`userid`,`pwd`,`uname`,`sex`,`rank`,`money`,`email`,
                   `scores` ,`matt` ,`face`,`safequestion`,`safeanswer` ,`jointime` ,`joinip` ,`logintime` ,`loginip` )
               VALUES ("1","个人","$adminuser","".md5($adminpwd)."","$adminuser","男","100","0","","10000","10","","0","","".time()."","","0",""); ";
    mysql_query($adminquery,$conn);

    $adminquery = "INSERT INTO `{$dbprefix}member_person` (`mid`,`onlynet`,`sex`,`uname`,`qq`,`msn`,`tel`,`mobile`,`place`,`oldplace`,`birthday`,`star`,
                   `income` , `education` , `height` , `bodytype` , `blood` , `vocation` , `smoke` , `marital` , `house` ,`drink` , `datingtype` , `language` , `nature` , `lovemsg` , `address`,`uptime`)
                VALUES ("1", "1", "男", "{$adminuser}", "", "", "", "", "0", "0","1980-01-01", "1", "0", "0", "160", "0", "0", "0", "0", "0", "0","0", "0", "", "", "", "","0"); ";
    mysql_query($adminquery,$conn);

    $adminquery = "INSERT INTO `{$dbprefix}member_tj` (`mid`,`article`,`album`,`archives`,`homecount`,`pagecount`,`feedback`,`friend`,`stow`)
                     VALUES ("1","0","0","0","0","0","0","0","0"); ";
    mysql_query($adminquery,$conn);

    $adminquery = "Insert Into `{$dbprefix}member_space`(`mid` ,`pagesize` ,`matt` ,`spacename` ,`spacelogo` ,`spacestyle`, `sign` ,`spacenews`)
                Values("1","10","0","{$adminuser}的空间","","person","",""); ";
    mysql_query($adminquery,$conn);

    //安装体验数据
    if($installdemo == 1)
    {
        // 获取体验数据内容
        if($setupsql = file_get_contents($install_demo_name))
        {
            // 替换引擎
            $setupsql = preg_replace("#ENGINE=MyISAM#i", "TYPE=MyISAM", $setupsql);
            // 定义大于4.1时的创建sql
            $sql41tmp = "ENGINE=MyISAM DEFAULT CHARSET=".$cfg_db_language;
            if($mysql_version >= 4.1) {
                // 如果mysql版本大于4.1,则执行此替换
                $setupsql = preg_replace("#TYPE=MyISAM#i", $sql41tmp, $setupsql);
            }
            // 替换rooturl
            $setupsql = preg_replace("#_ROOTURL_#i", $rooturl, $setupsql);
            // 替换换行符
            $setupsql = preg_replace("#[
]{1,}#", "
", $setupsql);
            // 替换表前缀
            $setupsql = preg_replace("/#@__/i",$dbprefix,$setupsql);
            // 按制表符分割
            $sqls = preg_split("#;[ 	]{0,}
#", $setupsql);
            // 遍历执行sql代码
            foreach($sqls as $sql) {
                if(trim($sql)!="") mysql_query($sql,$conn);
            }
            // 更新栏目缓存
            UpDateCatCache();
        } else {
            // 没有体验包，提示下载
            die("没有体验数据包文件,请检查是否下载.");
        }
    }

    //不安装任何可选模块
    if(!isset($modules) || !is_array($modules))
    {
        //锁定安装程序
        // 开始创建锁文件
        $fp = fopen($insLockfile,"w");
        // 写入内容ok
        fwrite($fp,"ok");
        // 关闭资源
        fclose($fp);
        // 包含最后提示文件内容
        include("./templates/step-5.html");
        // 终止程序执行，如果不安装模块，则程序到此结束
        exit();
    }
    else // 安装模块
    {
        // 按照逗号分割模块
        $module = join(",",$modules);
        // 以写入形式打开模块缓存文件
        $fp = fopen($moduleCacheFile,"w");
        // 写入 ");
        //如果不能写入缓存文件，退出模块安装
        if(!$fp) // 如果无法写入
        {
            //锁定安装程序
            $fp = fopen($insLockfile,"w");
            // 写入内容ok
            fwrite($fp,"ok");
            // 关闭资源
            fclose($fp);
            // 错误信息
            $errmsg = "由于无法写入模块缓存，安装可选模块失败，请登录后在模块管理处安装。";
            // 包含最后提示文件内容
            include("./templates/step-5.html");
            // 终止程序
            exit();
        }
        // 关闭资源
        fclose($fp);
        // 包含第4
        include("./templates/step-4.html");
        // 终止
        exit();
    }
    // 终止
    exit();
}
/*------------------------
安装可选模块
function _5_SetupModule()
------------------------*/
else if($step==5)
{
    // 跳转进入模块安装文件啊
    header("location:module-install.php");
    exit();
}
/*------------------------
检测数据库是否有效
function _10_TestDbPwd()
------------------------*/
else if($step==10)
{
    // 不缓存页面
    header("Pragma:no-cache
");
    // 不留下页面备份
    header("Cache-Control:no-cache
");
    // 不过期
    header("Expires:0
");
    // 连接数据库
    $conn = @mysql_connect($dbhost,$dbuser,$dbpwd);
    // 如果连接成功
    if($conn)
    {
        // 数据库名称不为空
        if(empty($dbname)){
            echo "信息正确";
        }else{
            // 否则提示信息
            $info = mysql_select_db($dbname,$conn)?"数据库已经存在，系统将覆盖数据库":"数据库不存在,系统将自动创建";
            echo $info;
        }
    }
    else
    {
        // 连接失败时提示信息
        echo "数据库连接失败！";
    }
    // 关闭数据库
    @mysql_close($conn);
    // 终止程序执行
    exit();
}
// 远程获取体验包
else if($step==11)
{
    // 包含更新服务器配置文件
    require_once("../data/admin/config_update.php");
    // 定义文件名，拼接url
    $rmurl = $updateHost."dedecms/demodata.{$s_lang}.txt";

    // 按照文件url获取资源
    $sql_content = file_get_contents($rmurl);
    // 以写入方式创建文件
    $fp = fopen($install_demo_name,"w");
    // 写入资源内容
    if(fwrite($fp,$sql_content))
        // 写入成功提示
        echo "  [√] 存在(您可以选择安装进行体验)";
    else
        // 写入失败提示
        echo "  [×] 远程获取失败";
    // 释放$sql_content变量
    unset($sql_content);
    // 关闭资源
    fclose($fp);
    // 终止程序
    exit();
}

由上面代码可以看出，主要的安装都是在这个文件中进行的，至于其他的都是辅助性文件，比如sql-dfdata.sql存放数据库数据内容等文件。

安装的话，到此结束了，基本都是接收表单参数，操作文件和数据库的东西。其他的辅助性文件，大家可以自己看看，有空的话，我也会写一些关于那些文件的详解。