一、简介
TPLog是一个基于PHP语言实现的日志类库，可以帮助开发者记录应用程序运行过程中的各种日志信息，如调试信息、错误信息、警告信息等等。
TPLog支持配置多个日志记录方式，如文件记录、数据库记录、邮件通知等，通过使用TPLog，开发者可以更好地管理和分析自己的应用程序运行状况。
二、安装和配置
TPLog的安装非常简单，在使用前只需要将类库文件引入自己的项目即可。
在使用TPLog之前，需要进行一些基本的配置操作，如设置记录方式、日志存储路径、日志文件名格式等等。这些配置都可以通过TPLog类的构造函数进行设置，示例代码如下：
// 初始化TPLog类
$log = new thinkLog([
'type' => 'file',
'path' => LOG_PATH,
'level' => ['error'],
'apart_level' => ['error', 'sql'],
'max_files' => 30,
'time_format' => 'Ymd',
'file_size' => 1024 * 1024 * 10,
'json' => false,
'show_error_msg' => false,
]);
上述代码中，我们使用了文件记录方式，并设置日志存储路径为LOG_PATH，只记录错误级别的日志，并将错误级别和SQL级别的日志分别存储在不同的文件中。此外，我们还设置了单个日志文件最大大小为10MB，最大文件数量为30个。
三、基本使用方法
日志记录完成的最基本方法就是使用TPLog类中的log方法，该方法包含两个参数，第一个参数为记录内容，第二个参数为日志级别。
下面是一个简单的例子：
// 记录错误级别的日志
$log->log('这是一个错误日志', 'error');
// 记录SQL查询日志
$log->log('SELECT * FROM `user`', 'sql');
除了使用log方法进行日志记录，TPLog还支持记录调试信息、错误信息、警告信息等各种类型的日志。可以通过debug、error、warning等方法进行记录。
// 记录调试信息
$log->debug('这是一个调试信息');
// 记录错误信息
$log->error('这是一个错误信息');
// 记录警告信息
$log->warning('这是一个警告信息');
四、高级功能
除了基本的日志记录功能之外，TPLog还支持许多高级功能，包括：
1.实时显示日志
TPLog支持实时显示日志功能，可以通过调用show方法实现。调用该方法后，程序会一直阻塞，直到接收到用户的控制台输入（如Ctrl+C）。
// 实时显示日志 $log->show();
2.邮件通知日志
TPLog支持将日志通过电子邮件进行通知的功能。在构造函数中设置type为email，然后设置smtp和email等参数即可完成日志邮件通知功能。
$log = new thinkLog([
'type' => 'email',
'host' => 'smtp.qq.com',
'port' => 25,
'username' => 'from@qq.com',
'password' => 'password',
'to' => 'to@qq.com',
'subject' => 'TPLog error report',
'level' => ['error'],
]);
3.自定义日志处理器
TPLog还支持使用自定义函数或类对日志进行处理的功能。只需要实现handle方法并传递给TPLog的构造函数即可。
$log = new thinkLog([
'type' => 'custom',
'handle' => function($message, $level) {
// 处理日志记录
}
]);
五、总结
TPLog是一个非常强大的日志记录工具，通过对TPLog的学习和使用，我们可以更好地管理和分析自己的应用程序运行状况。在实际开发过程中，我们可以按照自己的需求进行配置和使用，以便更好地满足项目的需求。