萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

Linux C/C++ 連接 MySQL 實戰:環境配置、API 詳解與完整範例

環境準備

# 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 流程

  1. 初始化句柄:MYSQL *mysql_init(MYSQL *mysql)
  2. 建立連線:MYSQL *mysql_real_connect(MYSQL *mysql, host, user, pass, db, port, unix_socket, flags)
  3. 設定選項(介於 init 與 connect 之間):
    mysql_options(mysql, MYSQL_SET_CHARSET_NAME, "utf8mb4") 等。
  4. 執行 SQL:int mysql_query(MYSQL *mysql, const char *stmt),返回 0 成功。
  5. 處理結果集(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) 釋放。
  6. 影響行數(INSERT/UPDATE/DELETE):
    my_ulonglong mysql_affected_rows(MYSQL *mysql)
  7. 錯誤處理:
    unsigned int mysql_errno(MYSQL *mysql)、const char *mysql_error(MYSQL *mysql)
  8. 關閉連線: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。
copyright © 萬盛學電腦網 all rights reserved