开源日志库 zlog 安装与配置全攻略

---

项目基础介绍与编程语言

项目名称: zlog
主要编程语言: C
项目简介: zlog 是一个可靠、高性能、线程安全、灵活且模型清晰的纯C语言编写的日志库。在C语言的世界里，它填补了如Java中的logback或C++中log4cxx这类优秀日志库的空白。相较于使用printf的不便（难以重定向和格式化）以及syslog的低效和系统级定位，zlog提供了更快、更安全的选择，并支持广泛的应用场景。

---

关键技术和框架

• 核心特性: 高并发处理，动态配置刷新，自定义日志级别，多输出目标（包括文件、标准输出等），线程安全。
• 依赖环境: 仅基于POSIX系统的C99标准实现，无额外外部依赖。
• 配置机制: 支持通过配置文件来管理日志类别、格式及规则，实现日志的灵活性和可定制性。

---

安装与配置向导

准备工作

确保你的开发环境已准备好C编译器（如GCC）。推荐在Linux环境下进行，尽管该项目理论上兼容AIX和其他遵循POSIX标准的系统。

安装步骤

下载源码

首先，克隆项目到本地：

git clone https://github.com/HardySimpson/zlog.git

编译与安装

进入项目目录并执行以下命令进行编译与安装。默认安装路径为 /usr/local，但你可以通过设置 PREFIX 来更改。

cd zlog
make
sudo make install

如果你想自定义安装路径，可以这样做：

make PREFIX=/你希望的路径/ install

安装后，更新动态链接配置以便程序找到zlog库：

sudo vi /etc/ld.so.conf
# 添加这一行
/usr/local/lib
sudo ldconfig

配置文件设置

创建或编辑配置文件，比如放在 /etc/zlog.conf。这里是一个简单的示例：

[formats]
simple = "%m%n"

[rules]
my_cat DEBUG >stdout simple

该配置表示名为my_cat的日志类别，DEBUG级别及以上的信息将按简单格式输出到控制台。

使用API示例

创建一个测试程序 test_hello.c 来演示如何使用zlog库：

#include <stdio.h>
#include "zlog.h"

int main(int argc, char** argv) {
    int rc;
    zlog_category_t *c;

    rc = zlog_init("/etc/zlog.conf");
    if (rc) {
        printf("初始化失败\n");
        return -1;
    }

    c = zlog_get_category("my_cat");
    if (!c) {
        printf("获取分类失败\n");
        zlog_fini();
        return -2;
    }

    zlog_info(c, "你好，zlog！");
    zlog_fini();

    return 0;
}

编译并运行测试程序：

cc -c -o test_hello.o test_hello.c -I/usr/local/include
cc -o test_hello test_hello.o -L/usr/local/lib -lzlog -lpthread
./test_hello

此时你应该能在终端看到输出：“你好，zlog！”

高级配置与使用

探索更多的配置选项和高级功能，如日志格式定制、多个输出目的地、日志自动刷新等，可以通过阅读项目的官方文档和配置文件的详细说明进一步学习。

至此，您已经成功安装并基本配置了zlog日志库，可以愉快地开始在您的C语言项目中使用它了！

---

以上就是zlog日志库的安装与基础配置过程，希望能帮助所有级别的开发者轻松上手这个强大的工具。