README.zh_CN.md

Perfect - MariaDB 连接器

该项目实现了一个对 MariaDB 数据库客户端的连接器函数封装，便于用于访问 MariaDB 服务器。

该软件使用SPM进行编译和测试，本软件也是Perfect项目的一部分。本软件包可独立使用，因此使用时可以脱离PerfectLib等其他组件。

请确保您已经安装并激活了最新版本的 Swift tool chain 工具链。

OS X 编译时的注意事项

本软件组件需要Home Brew管理的 MariaDB 连接库函数二进制版本。

 brew install mariadb-connector-c

您必须手工处理pkg-config的.pc文件，比如/usr/local/lib/pkgconfig/mariadb.pc，内容类似如下：

libdir=/usr/local/lib/mariadb
includedir=/usr/local/include/mariadb

Name: mariadb
Description: MariaDB Connector/C
Version: 5.5.1
Requires:
Libs: -L${libdir} -lmariadb  -ldl -lm -lpthread
Cflags: -I${includedir}
Libs_r: -L${libdir} -lmariadb -ldl -lm -lpthread

为了pkg-config正常工作，最好编辑一下当前用户根目录的 ~/.bash_profile 文件，在最后一行增加以下内容：

export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/lib/pkgconfig"

编辑保存后，将pkg-config需要的变量导入当前环境：

source ~/.bash_profile

要验证是否配置成功，请使用命令：

$ pkg-config mariadb --cflags --libs

Linux 编译时注意事项

该组件在 Ubuntu 16.04 测试通过。在编译本库函数之前，请确定安装了：

sudo apt-get install pkg-config libmariadb2 libmariadb-client-lgpl-dev  

与在MacOS下编译前的准备工作一致，Linux一样需要手工编辑pkg-config文件，比如 /usr/lib/pkgconfig/mariadb.pc 。请务必确保其内容正确无误，以下内容为该文件的一个模板：

libdir=/usr/lib/x86_64-linux-gnu
includedir=/usr/include/mariadb

Name: mariadb
Description: MariaDB Connector/C
Version: 5.5.0
Requires:
Libs: -L${libdir} -lmariadb  -ldl -lm -lpthread
Cflags: -I${includedir}
Libs_r: -L${libdir} -lmariadb -ldl -lm -lpthread

验证是否配置成功，请使用命令：

$ pkg-config mariadb --cflags --libs

编译

请在您的Package.swift文件下增加以下内容：

.package(url:"https://github.com/PerfectlySoft/Perfect-MariaDB.git", from: "4.0.0")
...
dependencies: ["MariaDB"]),

快速上手

首先增加库函数导入：

import MariaDB

Perfect-MariaDB 支持 Perfect-CRUD。详见Perfect-CRUD操作手册

更多信息

关于本项目更多内容，请参考perfect.org.