log4cplus: 一个好用的日志模块。编译以及使用

log4cplus 日志

介绍

log4cplus 是一个 C++ 版本的日志库，它是 Apache 组织的 log4j 日志库的一个开源实现。log4cplus 提供了一个灵活的、高性能的日志系统，支持多线程、本地化和分层结构。

log4cplus 的主要特点如下：

• 灵活性：log4cplus 提供了灵活的配置机制，可以在运行时动态地修改日志级别、追踪器、Appender 等配置信息。同时，log4cplus 通过继承结构、过滤器、日志记录器等机制，提供了更加高度自定义化的配置。
• 高性能：log4cplus 使用多线程技术，可以高效地处理大量的日志记录请求，同时支持异步日志记录，减小了日志记录对应用程序性能的影响。
• 多平台支持：log4cplus 可以跨平台运行，可以在 Windows、Linux、Unix 等平台上使用。
• 多语言支持：log4cplus 支持本地化，它可以输出不同语言的日志信息。

使用 log4cplus，我们可以使用不同级别的日志记录来控制日志信息的输出，从而帮助我们快速定位和修复问题。此外，log4cplus 还支持多个日志记录器，可以让我们对不同模块的日志信息进行不同的控制和输出。

直接使用

您可以从 log4cplus 的官方网站上下载 log4cplus，网站地址为：http://log4cplus.sourceforge.net。

在网站上，您可以找到最新版本的 log4cplus 以及相关的文档和示例代码。下载 log4cplus 的方法如下：

1. 打开 log4cplus 的官方网站：http://log4cplus.sourceforge.net。
2. 在“Downloads”页面，选择适合您系统的版本下载。您可以下载源代码或者预编译的二进制文件。
3. 解压下载的文件，按照文档说明进行安装和配置。
4. 如果您需要使用 log4cplus 的扩展功能，您还需要下载相应的扩展库。

安装好 log4cplus 后，您就可以开始使用了。在代码中引用相关的头文件，并使用 log4cplus 提供的 API 进行日志记录

编译

1. 准备工作
   国内的镜像：https://gitcode.net/mirrors/log4cplus/log4cplus
   github地址：https://github.com/log4cplus/log4cplus
   注意，需要更新子模块，catch,threadpool

2. window下cmake
   
   ps 需要注意的点，1.宏 WITH_UNIT_TESTS 取消打勾 2.填写自己的安装路径
   这边我用的是vs2019，x64

3. sln 项目
   找到log4cplus.sln，建议给目前全部权限（碰到过由于权限不够，无法创建文件夹）。
   
   对了，之前也有人说项目要Unicode字符集，cmake生成的项目都是符合要求的。
   直接编译 – lib目录在src/Release或者Debug,动态库在bin目录下

项目添加log4cplus

1. 右键 vs项目INSTALL,就会生成在之前cmake上的配置的路径下
   
   自己可以在这个基础上细分debug和release
2. 添加lib以及include

	在VC目录下的库目录中加入logModule\lib以及包含目录加入.\logModule\include
	//加载库
	#ifdef _WIN64
	#ifdef _DEBUG
	#pragma comment(lib,"logModule/lib/log4cplusUD.lib")
	#else
	#pragma comment(lib,"logModule/lib/log4cplusU.lib")

项目：**ISO C++20 标准 (/std:c++20)**，c++语言标准：**ISO C++20 标准 (/std:c++20)**

3. 具体用法
   其实网上有很多可以参考的，可以用配置文件或者直接在代码里面配置。

log4cplus 的基本使用步骤如下：

• 引入头文件：包含 log4cplus/logger.h 和 log4cplus/configurator.h 头文件。
• 初始化配置：在程序初始化时调用 log4cplus 的配置器进行配置。如下所示：

	#include <log4cplus/logger.h>    
	#include <log4cplus/configurator.h>
    log4cplus::initialize();   
    log4cplus::BasicConfigurator::doConfigure();  

这里使用了 BasicConfigurator 进行基本配置，您也可以使用 XMLConfigurator 或者PropertyConfigurator 进行更加灵活的配置。

• 创建日志记录器：使用 getLogger() 方法创建一个日志记录器。如下所示：

	#include <log4cplus/logger.h>    
	log4cplus::Logger logger = log4cplus::Logger::getInstance(LOG4CPLUS_TEXT("main"));

• 记录日志：调用日志记录器的方法，如 DEBUG、INFO、WARN、ERROR 和 FATAL 等级别的记录方法。如下所示：

	LOG4CPLUS_DEBUG(logger, "This is a debug message.");   
    LOG4CPLUS_INFO(logger, "This is an info message.");   
    LOG4CPLUS_WARN(logger, "This is a warning message.");   
    LOG4CPLUS_ERROR(logger, "This is an error message.");   
    LOG4CPLUS_FATAL(logger, "This is a fatal message.");

• 也可以在记录日志的时候，使用 printf-style 的格式化方式加入参数，例如：

	LOG4CPLUS_DEBUG_FMT(logger, "This is a debug message with number:%d.", 123);

• 关闭日志系统：在程序结束时调用 log4cplus 的 shutdown() 方法关闭日志系统。

	log4cplus::Logger::shutdown();

• 自定义配置：如果您需要自定义配置，例如输出到文件或者使用其他 Appender，则可以使用 PropertyConfigurator 或者 XMLConfigurator 进行配置。例如：

	log4cplus::PropertyConfigurator config("log4cplus.properties");
	config.configure();

log4cplus.properties

	# ALL TRACE  DEBUG  INFO  WARN  ERROR  FATAL  OFF
	log4cplus.rootLogger = TRACE,SA
	log4cplus.logger.logConsole = TRACE,LC
	
	#For database stuff, I don't need to logging everything, it's enough printing only errors!
	#log4cplus.logger.DatabaseOperations=ERROR
	#log4cplus.additivity.file=false
	
	log4cplus.appender.LC=log4cplus::ConsoleAppender
	log4cplus.appender.LC.EnCoding=utf-8
	log4cplus.appender.LC.layout=log4cplus::PatternLayout
	log4cplus.appender.LC.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}] %m [%l]%n
	 
	#设置日志追加到文件尾
	log4cplus.appender.SA=log4cplus::TimeBasedRollingFileAppender 
	//log4cplus.appender.SA.File = Mylogger.log
	# 必须要先手动创建好log目录；否则无法创建文件
	log4cplus.appender.SA.FilenamePattern= ./log/%d{yyyy-MM-dd_HH-mm}.log
	log4cplus.appender.SA.Schedule = MINUTELY
	log4cplus.appender.SA.CreateDirs = true
	log4cplus.appender.SA.MaxHistory = 9999
	log4cplus.appender.SA.RollOnClose = false
	#设置日志文件大小
	log4cplus.appender.SA.MaxFileSize = 100MB
	#设置生成日志最大个数
	log4cplus.appender.SA.MaxBackupIndex = 100
	log4cplus.appender.SA.Append = true
	log4cplus.appender.SA.layout=log4cplus::PatternLayout
	log4cplus.appender.SA.layout.ConversionPattern=[%-5p][%D{%m/%d/%y %H:%M:%S:%Q}] [%t] %c - %m [%l]%n
	 
	#设置日志级别范围
	log4cplus.appender.SA.filters.1=log4cplus::spi::LogLevelRangeFilter
	log4cplus.appender.SA.filters.1.LogLevelMin=DEBUG
	log4cplus.appender.SA.filters.1.LogLevelMax=FATAL
	log4cplus.appender.SA.filters.1.AcceptOnMatch=true
	log4cplus.appender.SA.filters.2=log4cplus::spi::DenyAllFilter