PHP數據庫封裝思辨：從mysqli原生API到工具類的演進之路

初學者的困惑

學習PHP時發現教程封裝的Database工具類全是面向過程風格，調用方式與直接用mysqli差異不大，反而增加學習成本，為什麼還要封裝？

封裝的本質：復用與抽象，而非為了封裝而封裝

何時需要封裝？

• 代碼重複：連接、查詢、錯誤處理、資源釋放邏輯在多處重複。
• 業務抽象：需要統一事務管理、慢查詢日誌、SQL審計、分庫分表路由等橫切關注點。
• 遷移屏蔽：未來可能切換PDO、ORM、不同數據庫驅動，封裝層隔離變化。

教學階段的封裝意義

• 演示面向對象設計原則（單一職責、依賴倒置）。
• 理解連接池、預處理語句、防注入等核心概念。
• 建立規範化代碼風格的肌肉記憶。

演進路線圖

1. 零封裝：直接new mysqli()、query()、fetch_assoc()，適合腳本、原型驗證。
2. 基礎工具類：封裝connect()、query()、execute()、getOne()、getAll()，統一異常拋出。
3. 查詢構建器：鏈式調用$db->table('user')->where('id', 1)->find()，防注入、可讀性強。
4. ORM/ActiveRecord：模型映射User::find(1)，關聯加載、事件鉤子，適合中大型項目。
5. 微服務/分庫分表中間件：ShardingSphere、ProxySQL，透明路由、讀寫分離。

實戰建議

• 小項目/學習：直接用mysqli或PDO，體會原生API細節（預處理、綁定參數、事務）。
• 中型項目：引入輕量庫（如medoo、illuminate/database），避免重複造輪子。
• 大型項目：上Laravel Eloquent、Doctrine等成熟ORM，或自研適配業務的Data Access Layer。

核心原則：先用原生，痛點來了再抽象；封裝是為了解決具體問題，不是儀式。