MySQL 可用 API 全景：C API、Perl DBI、PHP API 架構與選擇

MySQL 三大主流 API 架構解析：C API 基石、DBI 分層、PHP 嵌入式

MySQL 官方提供 C 客戶端庫，其他語言驅動多構建於其上。理解三大 API 內部架構，有助於排查連接問題、選擇技術棧、評估性能邊界。

1. C 客戶端庫 API（基石層）

• 最底層接口，直接與 mysqld 協議交互。
• 提供：連接管理、查詢發送、結果集讀取、事務控制、預處理、錯誤碼。
• 所有其他語言驅動（除 Java JDBC Type-4）均通過 FFI/擴展調用此庫。
• 核心結構體：MYSQL（連接句柄）、MYSQL_RES（結果集）、MYSQL_ROW（行數據）、MYSQL_FIELD（列元數據）。

2. Perl DBI/DBD 架構（雙層解耦）

+------------------+     +------------------+
|   Application    |     |   DBI (Database  |
|   (Script)       |---->|   Interface)     |  抽象接口層：統一 prepare/execute/fetch
+------------------+     +--------+---------+
                              |
                              v
                     +--------+---------+
                     |  DBD::mysql      |  驅動層：針對 MySQL 協議實現
                     |  (DBD Driver)    |  內部調用 libmysqlclient
                     +--------+---------+
                              |
                              v
                       +------+------+
                       |  mysqld     |
                       +-------------+

• DBI 層：數據庫無關，定義標準句柄 ($dbh, $sth) 和方法。
• DBD 層：每種數據庫一個驅動 (DBD::mysql, DBD::Pg, DBD::Oracle)。
• 連接時指定驅動：DBI->connect("dbi:mysql:dbname", $user, $pass)。
• 可移植性來自 DBI 層統一接口；特有功能（如 mysql_insertid）屬 DBD 層，使用時犧牲可移植性。

3. PHP API（嵌入式 Web 腳本）

• 專為 Web 頁面嵌入設計：<?php ... ?> 標籤包裹腳本。
• 請求流程：Web Server → PHP 解析器 → 腳本執行 → 輸出 HTML → 瀏覽器。
• 函數命名貼近 C API：mysqli_connect(), mysqli_query(), mysqli_fetch_assoc() 等。
• 無統一抽象層（PDO 除外），各數據庫擴展獨立，遷移需改函數名。
• PDO (PHP Data Objects)：PHP 5.1+ 內置，提供類 DBI 的抽象接口，推薦新項目使用。

4. 利用現有輪子

MySQL 發布包含 mysql, mysqladmin, mysqldump 等 C 客戶端源碼；CPAN 有海量 DBIx::* ORM；Packagist 有 Laravel/Eloquent、Doctrine 等 PHP ORM。**優先復用，專注業務邏輯。**

API 選擇快速參考