萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 高效能資料庫連線類:支援多字元集、自動重連、查詢除錯與緩衝控制

類別架構概覽

此類別封裝 mysql_* 函數 (註:PHP 7.0+ 已移除,建議遷移至 PDO/MySQLi),提供:

  • 連線管理:一般/持久連線、字元集自動協商 (utf8/gbk/big5)、SQL 模式重設
  • 查詢執行:緩衝/非緩衝模式、自動重連 (斷線錯誤 2006/2013)、靜默/除錯模式
  • 結果集操作:關聯/數值/混合陣列、首行/單值快取、影響行數、插入 ID
  • 錯誤處理:統一 halt() 機制、錯誤代碼/訊息封裝

核心方法解析

connect() - 智慧型連線建立

function connect($host, $user, $pw, $dbname='', $pconnect=0, $halt=true, $charset='') {
    $func = $pconnect ? 'mysql_pconnect' : 'mysql_connect';
    if (!$this->link = @$func($host, $user, $pw, true)) {
        $halt && $this->halt('Can not connect to MySQL server');
        return;
    }
    
    // MySQL 4.1+ 字元集與 SQL 模式自動配置
    if ($this->version() > '4.1') {
        $charset = $charset ?: $GLOBALS['dbcharset'];
        $set = $charset ? "character_set_connection=$charset, character_set_results=$charset, character_set_client=binary" : '';
        $set .= $this->version() > '5.0.1' ? (($set ? ',' : '') . "sql_mode=''") : '';
        $set && mysql_query("SET $set", $this->link);
    }
    $dbname && @mysql_select_db($dbname, $this->link);
}

query() - 企業級查詢執行

function query($sql, $type='') {
    global $debug, $discuz_starttime, $sqldebug, $sqlspenttimes;
    if (defined('SYS_DEBUG') && SYS_DEBUG) {
        include_once DISCUZ_ROOT.'./include/debug.func.php';
        sqldebug();
    }
    
    $func = ($type=='UNBUFFERED' && function_exists('mysql_unbuffered_query')) 
            ? 'mysql_unbuffered_query' : 'mysql_query';
    
    if (!($query = $func($sql, $this->link))) {
        // 自動重連機制
        if (in_array($this->errno(), [2006, 2013]) && strpos($type, 'RETRY') !== 0) {
            $this->close();
            require DISCUZ_ROOT.'./config.inc.php';
            $this->connect($dbhost, $dbuser, $dbpw, $dbname, $pconnect, true, $dbcharset);
            return $this->query($sql, 'RETRY'.$type);
        }
        if ($type != 'SILENT' && strpos($type, 'SILENT') === false) {
            $this->halt('MySQL Query Error', $sql);
        }
    }
    $this->querynum++;
    return $query;
}

結果集便利方法

fetch_array($query, MYSQL_ASSOC)  // 關聯陣列
fetch_first($sql)                  // 單行關聯陣列
result_first($sql)                 // 單一欄位值
num_rows($query)                   // 列數
affected_rows()                    // 影響行數
insert_id()                        // 自增 ID (支援 last_insert_id())
free_result($query)                // 釋放資源

現代化遷移建議 (PHP 7+/8+)

此類別基於已移除的 mysql 擴展,建議重構為 PDO 版本:

class Database {
    private PDO $pdo;
    
    public function __construct(string $dsn, string $user, string $pass, array $options=[]) {
        $this->pdo = new PDO($dsn, $user, $pass, $options + [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES => false,
        ]);
    }
    
    public function query(string $sql, array $params=[]): PDOStatement {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt;
    }
    
    // 其餘方法對應 PDOStatement::fetchAll(), rowCount(), lastInsertId() 等
}

關鍵優化特性保留

  • 準備語句:防 SQL 注入、執行計畫重用
  • 交易控制:beginTransaction()/commit()/rollBack()
  • 連線池:PHP-FPM 配合持久連線 PDO::ATTR_PERSISTENT
  • 查詢日誌:PDO::ATTR_ERRMODE + 自訂事件監聽
copyright © 萬盛學電腦網 all rights reserved