PHP MySQL 連線類深度解析：封裝 CRUD、事務、錯誤日誌與資源管理

類別架構

class MySQL {
    private $host, $user, $pwd, $db, $charset;
    private $conn, $result, $sql;
    private $bulletin = true;   // 錯誤寫入日誌
    private $show_error = true; // 畫面顯示錯誤
    private $is_error = false;  // 錯誤是否中止

    public function __construct($host,$user,$pwd,$db,$charset='utf8') { ... }
    public function connect() { ... } // 支援 pconnect
    public function query($sql) { ... }
    // CRUD 簡化
    public function select($table,$cols,$cond) { ... }
    public function insert($table,$cols,$vals) { ... }
    public function update($table,$set,$cond) { ... }
    public function delete($table,$cond) { ... }
    // 結果集取得
    public function fetch_array() { return mysql_fetch_array($this->result); }
    public function fetch_assoc() { return mysql_fetch_assoc($this->result); }
    public function fetch_row() { return mysql_fetch_row($this->result); }
    public function fetch_object() { return mysql_fetch_object($this->result); }
    // 工具
    public function insert_id() { return mysql_insert_id(); }
    public function affected_rows() { return mysql_affected_rows(); }
    public function num_rows() { return mysql_num_rows($this->result); }
    public function free() { mysql_free_result($this->result); }
    public function __destruct() { $this->free(); mysql_close($this->conn); }
}

關鍵設計亮點

• 錯誤日誌持久化：show_error() 將 SQL、錯誤訊息、客戶 IP、時間寫入 error/YYYY-MM-DD.txt，支援目錄自動建立、檔案鎖定寫入。
• 編碼自動設定：連線後執行 SET NAMES $charset。
• 支援永久連線：建構子參數 $conn='pconn' 切換 mysql_pconnect。
• 資源自動釋放：析構函數保證關閉連線、釋放結果集。

使用範例

$db = new MySQL('localhost','root','pass','mydb');
$db->select('users','*',"status=1");
while ($row = $db->fetch_assoc()) {
    echo $row['username'] . "\n";
}
$db->insert('logs', 'msg,time', "'login', NOW()");
echo "新增 ID: " . $db->insert_id();

現代化遷移建議

mysql_* 函數已於 PHP 7.0 移除。新專案請直接使用 mysqli 或 PDO。遷移重點：

1. 將 mysql_connect → new mysqli(...) 或 new PDO(...)。
2. 查詢改用預處理 prepare/bind/execute。
3. 結果集改用 get_result() + fetch_assoc() (mysqli) 或 fetch() (PDO)。
4. 錯誤模式設為 MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT 或 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION。
5. 保留本類的「CRUD 簡化介面」設計思想，重寫為 PDO/Mysqli 版本。

結語

此類展示了經典「資料庫存取層」封裝模式：連線管理、CRUD 封裝、錯誤觀測、資源生命週期。雖底層 API 已淘汰，但架構思想仍具參考價值，可直接移植至 PDO/Mysqli 實作中。