PHP 框架核心：MySQL 資料庫封裝設計指南

設計目標

1. 使用便利性：直接 SQL 操作，零學習成本；提供 Dba 輔助類讓查詢更簡潔。
2. 延遲連線：首次執行 SQL 才建立連線、初始化編碼。
3. 讀寫分離擴展性：區分 read/write 方法，支援未來雲資料庫、中介軟體架構。
4. 長連線支援：偵測連線逾時自動重連，適合 Swoole、Worker 長駐程序。

核心查詢方法

// 讀單一值
Dba::readOne($sql);
// 讀單行關聯陣列
Dba::readRowAssoc($sql);
// 讀所有行
Dba::readAllAssoc($sql);
// 讀所有行第一欄
Dba::readAllOne($sql);
// 分頁：同時返回資料與總筆數
Dba::readCountAndLimit($sql, $page, $limit);

部份方法支援 map 回呼對每行資料後處理。

寫入方法

Dba::write($sql);                    // 通用寫入
Dba::insert($table, $insertArray);   // 插入 KV 陣列，自動轉義
Dba::update($table, $updateArray, $whereArray); // 更新
Dba::insertS($table, $insertsArray); // 批次插入 (大量資料建議 array_chunk 分批)

事務支援

Dba::beginTransaction();
Dba::commit();
Dba::rollBack();

基於 PDO 實現。

長連線自動重連

偵測到 MySQL server has gone away 等錯誤時，內部自動嘗試重連並重試，無感知於業務邏輯。

延伸閱讀

更多 PHP 框架核心設計請參考本站專題：《php常用技巧匯總》、《php+mysql數據庫操作入門教程》、《php面向對象程序設計入門教程》、《php字符串(string)用法總結》、《php日期與時間用法總結》及《PHP針對XML文件操作技巧總結》。