改造自discuz的mysql查询类(带注释)

  1<?php
  2/**
  3 * mysql查询类
  4 *
  5 */
  6class dbQuery {
  7    /**
  8     * 查询总次数
  9     *
 10     * @var int
 11     */
 12    var $querynum = 0;
 13    /**
 14     * 连接句柄
 15     *
 16     * @var object
 17     */
 18    var $link;
 19    
 20    /**
 21     * 构造函数
 22     *
 23     * @param string $dbhost 主机名
 24     * @param string $dbuser 用户
 25     * @param string $dbpw   密码
 26     * @param string $dbname 数据库名
 27     * @param int $pconnect 是否持续连接
 28     */
 29    function dbQuery($dbhost, $dbuser, $dbpw, $dbname = '', $pconnect = 0) {
 30        if($pconnect) {
 31            if(!$this->link = @mysql_pconnect($dbhost, $dbuser, $dbpw)) {
 32                $this->halt('Can not connect to MySQL server');
 33            }
 34        } else {
 35            if(!$this->link = @mysql_connect($dbhost, $dbuser, $dbpw)) {
 36                $this->halt('Can not connect to MySQL server');
 37            }
 38        }
 39        if($this->version() > '4.1') {
 40            global $dbcharset;
 41            if($dbcharset) {
 42                mysql_query("SET character_set_connection=$dbcharset, character_set_results=$dbcharset, character_set_client=binary", $this->link);
 43            }
 44
 45            if($this->version() > '5.0.1') {
 46                mysql_query("SET sql_mode=''", $this->link);
 47            }
 48        }
 49
 50        if($dbname) {
 51            mysql_select_db($dbname, $this->link);
 52        }
 53
 54    }
 55    /**
 56     * 选择数据库
 57     *
 58     * @param string $dbname
 59     * @return 
 60     */
 61    function select_db($dbname) {
 62        return mysql_select_db($dbname, $this->link);
 63    }
 64    /**
 65     * 取出结果集中一条记录
 66     *
 67     * @param object $query
 68     * @param int $result_type
 69     * @return array
 70     */
 71    function fetch_array($query, $result_type = MYSQL_ASSOC) {
 72        return mysql_fetch_array($query, $result_type);
 73    }
 74    
 75    /**
 76     * 查询SQL
 77     *
 78     * @param string $sql
 79     * @param string $type
 80     * @return object
 81     */
 82    function query($sql, $type = '') {
 83        
 84        $func = $type == 'UNBUFFERED' && @function_exists('mysql_unbuffered_query') ?
 85            'mysql_unbuffered_query' : 'mysql_query';
 86        if(!($query = $func($sql, $this->link)) && $type != 'SILENT') {
 87            $this->halt('MySQL Query Error', $sql);
 88        }
 89
 90        $this->querynum++;
 91        return $query;
 92    }
 93    /**
 94     * 取影响条数
 95     *
 96     * @return int
 97     */
 98    function affected_rows() {
 99        return mysql_affected_rows($this->link);
    }
    /**
     * 返回错误信息
     *
     * @return array
     */
    function error() {
        return (($this->link) ? mysql_error($this->link) : mysql_error());
    }
    /**
     * 返回错误代码
     *
     * @return int
     */
    function errno() {
        return intval(($this->link) ? mysql_errno($this->link) : mysql_errno());
    }
    /**
     * 返回查询结果
     *
     * @param object $query
     * @param string $row
     * @return mixed
     */
    function result($query, $row) {
        $query = @mysql_result($query, $row);
        return $query;
    }
    /**
     * 结果条数
     *
     * @param object $query
     * @return int
     */
    function num_rows($query) {
        $query = mysql_num_rows($query);
        return $query;
    }
    /**
     * 取字段总数
     *
     * @param object $query
     * @return int
     */
    function num_fields($query) {
        return mysql_num_fields($query);
    }
    /**
     * 释放结果集
     *
     * @param object $query
     * @return bool
     */
    function free_result($query) {
        return mysql_free_result($query);
    }
    /**
     * 返回自增ID
     *
     * @return int
     */
    function insert_id() {
        return ($id = mysql_insert_id($this->link)) >= 0 ? $id : $this->result($this->query("SELECT last_insert_id()"), 0);
    }
    /**
     * 从结果集中取得一行作为枚举数组
     *
     * @param object $query
     * @return array
     */
    function fetch_row($query) {
        $query = mysql_fetch_row($query);
        return $query;
    }
    /**
     * 从结果集中取得列信息并作为对象返回
     *
     * @param object $query
     * @return object
     */
    function fetch_fields($query) {
        return mysql_fetch_field($query);
    }
    /**
     * 返回mysql版本
     *
     * @return string
     */
    function version() {
        return mysql_get_server_info($this->link);
    }
    /**
     * 关闭连接
     *
     * @return bool
     */
    function close() {
        return mysql_close($this->link);
    }
    /**
     * 输出错误信息
     *
     * @param string $message
     * @param string $sql
     */
    function halt($message = '', $sql = '') {
        echo $message . ' ' . $sql;
        exit;

    }
}

?>