Skip to content
This repository was archived by the owner on Oct 25, 2026. It is now read-only.

Latest commit

 

History

History
69 lines (48 loc) · 2.34 KB

README.zh.md

File metadata and controls

69 lines (48 loc) · 2.34 KB

最後更新:2026-10-25

Note

此 README 由 SKILL 生成,英文版請參閱 這裡。


CHAIN YOUR QUERIES, NOT YOUR STRINGS!

Packagist License


PHP MySQL 客戶端,具備鏈式查詢建構、讀寫連線分離與慢查詢紀錄

目錄

功能特點

composer require pardnchiu/mysql-cli · 完整文件

  • 鏈式查詢建構 — 以 table、select、join、where、groupBy、orderBy、limit 串接組出 SQL,免去手寫字串拼接。
  • 讀寫連線分離 — 讀庫與寫庫各有一組環境變數,以參數或 read/write 方法指定連線目標。
  • 型別化參數綁定 — 所有值都走 prepared statement,並依整數、布林、空值與字串分別綁定以防 SQL 注入。
  • 連線重試與慢查詢紀錄 — 連線失敗以指數退避重試 3 次,執行超過 20 毫秒的查詢自動寫入 error_log。
  • 分頁總數一次取得 — 以視窗函式在同一查詢附帶總筆數,分頁不必再跑一次 COUNT。

架構

完整架構

graph TB
    A[呼叫端] --> B[SQL::table / read / write]
    ENV[DB_READ_* / DB_WRITE_*] --> C[PDO 連線 + 重試]
    B --> C
    B --> D[查詢建構器狀態]
    D --> E[SQL 組裝]
    E --> F[query: prepare + bind]
    C --> F
    F --> G[(MySQL)]
    F --> H[慢查詢 error_log]
Loading

授權

本專案採用 MIT LICENSE。

Author

Just open an issue to share an idea.

php-mysql-cli contributors

©️ 2024 邱敬幃 Pardn Chiu