環境準備
# Ubuntu/Debian
sudo apt-get install libmysqlclient-dev # 含 mysql.h、libmysqlclient.so
# 編譯鏈接
g++ -std=c++11 mysql_demo.cpp -o mysql_demo -lmysqlclient
# CodeBlocks: Build options → Linker settings → Add mysqlclient
核心 API 流程
- 初始化句柄:
MYSQL *mysql_init(MYSQL *mysql)
- 建立連線:
MYSQL *mysql_real_connect(MYSQL *mysql, host, user, pass, db, port, unix_socket, flags)
- 設定選項(介於 init 與 connect 之間):
mysql_options(mysql, MYSQL_SET_CHARSET_NAME, "utf8mb4") 等。
- 執行 SQL:
int mysql_query(MYSQL *mysql, const char *stmt),返回 0 成功。
- 處理結果集(SELECT/SHOW/DESCRIBE):
MYSQL_RES *mysql_store_result(MYSQL *mysql) 獲取完整結果集。
MYSQL_ROW mysql_fetch_row(MYSQL_RES *res) 逐行取數。
unsigned int mysql_num_fields(MYSQL_RES *res) 列數。
mysql_free_result(MYSQL_RES *res) 釋放。
- 影響行數(INSERT/UPDATE/DELETE):
my_ulonglong mysql_affected_rows(MYSQL *mysql)
- 錯誤處理:
unsigned int mysql_errno(MYSQL *mysql)、const char *mysql_error(MYSQL *mysql)
- 關閉連線:
void mysql_close(MYSQL *mysql)
完整範例程式
#include
#include
#include
#include
int main() {
MYSQL mysql;
mysql_init(&mysql);
mysql_options(&mysql, MYSQL_SET_CHARSET_NAME, "utf8mb4");
if (!mysql_real_connect(&mysql, "127.0.0.1", "root", "password", "testdb", 3306, NULL, 0)) {
std::cerr << "Connect failed: " << mysql_error(&mysql) << std::endl;
return 1;
}
// 建表
if (mysql_query(&mysql, "CREATE TABLE IF NOT EXISTS t (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50))")) {
std::cerr << "Create table failed: " << mysql_error(&mysql) << std::endl;
}
// 插入
if (mysql_query(&mysql, "INSERT INTO t (name) VALUES ('Alice'),('Bob')")) {
std::cerr << "Insert failed: " << mysql_error(&mysql) << std::endl;
} else {
std::cout << "Inserted rows: " << mysql_affected_rows(&mysql) << std::endl;
}
// 查詢
if (mysql_query(&mysql, "SELECT id, name FROM t")) {
std::cerr << "Query failed: " << mysql_error(&mysql) << std::endl;
} else {
MYSQL_RES *res = mysql_store_result(&mysql);
MYSQL_ROW row;
unsigned int fields = mysql_num_fields(res);
while ((row = mysql_fetch_row(res))) {
for (unsigned int i = 0; i < fields; ++i)
std::cout << (row[i] ? row[i] : "NULL") << '\t';
std::cout << std::endl;
}
mysql_free_result(res);
}
mysql_close(&mysql);
mysql_library_end();
return 0;
}
進階主題
- 預處理語句:
MYSQL_STMT, mysql_stmt_prepare, mysql_stmt_bind_param, mysql_stmt_execute,防注入、重複執行高效。
- 連線池:生產環境必備,可封裝
std::queue + 鎖,或使用成熟庫(mysqlpp, soci, odb)。
- 事務控制:
mysql_autocommit(&mysql, 0), mysql_commit(&mysql), mysql_rollback(&mysql)。
- 異步/非阻塞:
mysql_real_connect_nonblocking (8.0+) 配合 poll/epoll。