Discuz的MySQL Class

PHP代码

<?php
class MySQL{
    //一些常量的的设定
    public $version = '';
    public $querynum = 0;
    public $link;
    //定义链接方法
    function connect($dbhost, $dbuser, $dbpw, $dbname = '', $pconnect = 0, $halt = TRUE, $dbcharset2 = '') {
    //在方法定义传递参数时候就设置的pconnect=0.这个参数用来判断是否是个持续链接。
    //$func变量用来存储，判断$pconnect是否为空，如果是，则存储php到mysql的链接（非持续性）的方法名。反之，则存储php到mysql的持续链接的方法名。
        $func = emptyempty($pconnect) ? 'mysql_connect' : 'mysql_pconnect';
        //建立一个链接给类的属性link之中。并且在建立链接的时候就设定编码方式是如何的。
        if(!$this->link = @$func($dbhost, $dbuser, $dbpw, 1)) {
            $halt && $this->halt('Can not connect to MySQL server');
        } else {
            if($this->version() > '4.1') {
                global $charset, $dbcharset;
                $dbcharset = $dbcharset2 ? $dbcharset2 : $dbcharset;
                $dbcharset = !$dbcharset && in_array(strtolower($charset), array('gbk', 'big5', 'utf-8')) ? str_replace('-', '', $charset) : $dbcharset;
                $serverset = $dbcharset ? 'character_set_connection='.$dbcharset.', character_set_results='.$dbcharset.', character_set_client=binary' : '';
                $serverset .= $this->version() > '5.0.1' ? ((emptyempty($serverset) ? '' : ',').'sql_mode=\'\'') : '';
                $serverset && mysql_query("SET $serverset", $this->link);
            }
            $dbname && @mysql_select_db($dbname, $this->link);
        }

    }
    //定义一个选择数据库的方法
    function select_db($dbname) {
        return mysql_select_db($dbname, $this->link);
    }
    //定义一个数据库执行后的返回方法
    function fetch_array($query, $result_type = MYSQL_ASSOC) {
        return mysql_fetch_array($query, $result_type);
    }
    //定义一个方法，方法中返回fetch_array方法执行后的返回值
    function fetch_first($sql) {
        return $this->fetch_array($this->query($sql));
    }
    //定义一个方法，方法中返回result方法执行后的返回值
    function result_first($sql) {
        return $this->result($this->query($sql), 0);
    }
    //定义一个方法。方法中执行对数据库的操作。
    function query($sql, $type = '') {

        //数据库操作。。不明具体的判断。
        $func = $type == 'UNBUFFERED' && @function_exists('mysql_unbuffered_query') ?
            'mysql_unbuffered_query' : 'mysql_query';
        if(!($query = $func($sql, $this->link))) {
            if(in_array($this->errno(), array(2006, 2013)) && substr($type, 0, 5) != 'RETRY') {
                $this->close();
                $this->connect($dbhost, $dbuser, $dbpw, $dbname, $pconnect, true, $dbcharset);
                $this->query($sql, 'RETRY'.$type);
            } elseif($type != 'SILENT' && substr($type, 5) != 'SILENT') {
                $this->halt('MySQL Query Error', $sql);
            }
        }

        $this->querynum++;
        return $query;
    }
    //mysql_affected_rows -- 取得前一次 MySQL 操作所影响的记录行数
    function affected_rows() {
        return mysql_affected_rows($this->link);
    }
    //数据库的文本错误提示
    function error() {
        return (($this->link) ? mysql_error($this->link) : mysql_error());
    }
    //mysql_errno --  返回上一个 MySQL 操作中的错误信息的数字编码
    function errno() {
        return intval(($this->link) ? mysql_errno($this->link) : mysql_errno());
    }
    //返回数据库操作结果
    function result($query, $row = 0) {
        $query = @mysql_result($query, $row);
        return $query;
    }
    //返回数据库查询等操作的数目
    function num_rows($query) {
        $query = mysql_num_rows($query);
        return $query;
    }
    //mysql_num_fields-取得结果集中字段的数目
    function num_fields($query) {
        return mysql_num_fields($query);
    }
    //释放结果内存
    function free_result($query) {
        return mysql_free_result($query);
    }
    //mysql_insert_id --  取得上一步 INSERT 操作产生的 ID
    function insert_id() {
        return ($id = mysql_insert_id($this->link)) >= 0 ? $id : $this->result($this->query("SELECT last_insert_id()"), 0);
    }
    //以数组的形式返回查询结果
    function fetch_row($query) {
        $query = mysql_fetch_row($query);
        return $query;
    }
    //mysql_fetch_field --  从结果集中取得列信息并作为对象返回
    function fetch_fields($query) {
        return mysql_fetch_field($query);
    }
    //获取版本信息，mysql_get_server_info()返回mysql服务器信息
    function version() {
        if(emptyempty($this->version)) {
            $this->version = mysql_get_server_info($this->link);
        }
        return $this->version;
    }
    //关闭链接
    function close() {
        return mysql_close($this->link);
    }
    //错误提示
    function halt($message = '', $sql = '') {
        return "run mysql have a error.";
    }
}