MySQL 8.4 C API 开发人员指南  /  MySQL C API 实现

第 2 章 MySQL C API 实现

MySQL C API 是一个基于 C 的 API,用 C 编写的客户端应用程序可以使用它与 MySQL 服务器通信。客户端程序在编译时引用 C API 头文件,并在链接时链接到 C API 库文件,libmysqlclient

要获得构建 C API 客户端程序所需的 C API 头文件和库文件,请安装 MySQL 服务器发行版。

您可以安装包含预编译的 C API 文件的二进制发行版,也可以使用 MySQL 服务器源代码发行版并自行构建 C API 文件。构建 MySQL 服务器也会构建 libmysqlclient;请参见 从源代码安装 MySQL。它不能单独构建,但使用可选的 -DWITHOUT_SERVER=ON CMake 选项相关。

用于链接 C API 客户端应用程序的库文件名称取决于发行版构建的库类型和平台。

  • 在 Unix(和类 Unix)系统上,静态库为 libmysqlclient.a。动态库在大多数 Unix 系统上为 libmysqlclient.so,在 macOS 上为 libmysqlclient.dylib

  • 在 Windows 上,静态库为 mysqlclient.lib,动态库为 libmysql.dll。Windows 发行版还包括 libmysql.lib,这是一个静态导入库,用于使用动态库。

    Windows 发行版还包括一组调试库。这些库与非调试库具有相同的名称,但位于 lib/debug 库中。使用调试 C 运行时编译客户端时,必须使用调试库。

在 Unix 上,您可能还会看到名称中包含 _r 的库。在 MySQL 5.5 之前,这些库作为线程安全(可重入)库单独构建,与非 _r 库分开。从 5.5 开始,这两个库相同,_r 名称是相应非 _r 名称的符号链接。无需使用 _r 库。例如,如果您使用 mysql_config 获取链接器标志,则可以在所有情况下使用 mysql_config --libs,即使对于线程化客户端也是如此。无需使用 mysql_config --libs_r.