CentOS7下使用C/C++连接MariaDB/MySQL

前言

连接数据库通常在 Java 的 JDBC 中使用比较多，但是 C/C++ 服务器在 Linux 下操作数据库也比较常见，在网上查了很多资料，并通过自己摸索，终于成功的连接上 MariaDB，记录一下做个参考。
开发环境是阿里云 CentOS7 64 位，使用 yum 安装 MariaDB，安装教程参考另一篇文章。

安装locate工具

部分版本的 linux 系统使用 locate 快速查找某文件路径会报以下错误：

-bash: locate: command not found

其原因是没有安装 mlocate 这个包，安装 mlocate：

yum  -y install mlocate

安装完再尝试用 locate 定位内容，发现依然不好使，报了新的错误：

locate: can not stat () `/var/lib/mlocate/mlocate.db': No such file or directory

原因是安装完后没有更新库，更新库：

updatedb

安装完成后，就可以使用 locate 快速查找某文件路径。

C++连接MariaDB

先看一个简单的连接数据库程序：

#include <stdlib.h>
#include <stdio.h>
#include "mysql/mysql.h"

int main(int argc, char *argv[])
{
    MYSQL *conn_ptr;
    conn_ptr = mysql_init(NULL); /* 连接初始化 */
    if (!conn_ptr)
    {
        fprintf(stderr, "mysql_init failed\n");
        return (EXIT_FAILURE);
    }

    conn_ptr = mysql_real_connect(conn_ptr, "XXX.XXX.XXX.XXX", "root", "passwd", "dbname", 0, NULL, 0); /* 建立实际连接 */
    /* 参数分别为：初始化的连接句柄指针，主机名（或者IP），用户名，密码，数据库名，0，NULL，0）后面三个参数在默认安装mysql>的情况下不用改 */
    if (conn_ptr)
    {
        printf("Connection success\n");
    }
    else
    {
        printf("Connection failed\n");
    }

    mysql_close(conn_ptr); /* 关闭连接 */

    return (EXIT_SUCCESS);
}

想要连接 MySQL，必须先添加头文件：#include <mysql/mysql.h>
然后在你的 Makefile 中加入 -I/usr/include/mysql 和 -L/usr/lib64/mysql 和 -lmysqlclient
如果你遇到了其他错误，请看最后的问题解决。
实例
如下是一个链接 MySQL 的 Makefile 实例：

CC=g++	#编译器
CFLAGS=-g	#可以使用gdb调试
BIN=MicroChatServer	#生成的可执行目标文件名
OBJS=sysutil.o	#.c/.cpp文件对应的.o目标文件
LIBS=-I/usr/include/mysql -L/usr/lib64/mysql -lmysqlclient -ljsoncpp -lpthread 	#链接库

$(BIN):$(OBJS)
	$(CC) $(CFLAGS) $^ -o $@
%.o:%.cpp
	$(CC) $(CFLAGS) -c $< -o $@ $(LIBS)

.PHONY:clean	#清理所有目标文件和可执行文件
clean:
	rm -f *.o $(BIN)

然后使用 make，就可以成功运行。

问题解决

问题1：
connect1.c:4:19: 错误：mysql.h：没有那个文件或目录
提示是没有找到 mysql.h，产生这个错误的原因是没有 mysql.h 文件，它在 mysql-devel 包中，需要安装这个包：

sudo yum install mysql-devel -y 

然后找一下：

＃ locate mysql.h
/usr/include/mysql/mysql.h  

这样就可以找到这个头文件了（-I 的含义是在指定位置搜索头文件，参见 man gcc）。
问题2：
再次尝试编译，出现了错误：

＃ gcc connect1.c -o connect1 -I/usr/include/mysql -lmysqlclient   
/usr/bin/ld: cannot find -lmysqlclient  
collect2: ld 返回 1

链接库有问题，找不到 mysqlclient 链接库，man gcc 发现可以在后面用 -L 指定搜索位置，于是我们先找到 mysqlclient 库的位置：

＃ locate *mysqlclient*
/usr/lib64/mysql/libmysqlclient.so
/usr/lib64/mysql/libmysqlclient.so.18
/usr/lib64/mysql/libmysqlclient.so.18.0.0
/usr/lib64/mysql/libmysqlclient_r.so

在这里要说明一下，有的系统在 /usr/lib/mysql/ 下，但是我使用的是 CentOS7 64 位的，是在 /usr/lib64/mysql/ 下，这就是为什么要装 mlocate 确定库的位置了，因为很多博客文章并没有说清楚，而是直接说在 /usr/lib/mysql/ 下，导致一些系统无法成功链接并报错。
在找到了位置后，就可以编译了：

gcc connect1.c -o connect1  -I/usr/include/mysql -L/usr/lib64/mysql -lmysqlclient

编译成功，就可以运行了，在此之前，确保 mysqld 已经在运行了：

sudo /etc/rc.d/init.d/mysqld restart  

然后执行生成的可执行文件:

./connect1  
Connection success  

打印出连接成功的信息。说明使用 C/C++ 连接 MySQL 数据库成功。