README

一个简单的PHP日志库。

安装

您可以使用Composer安装此库。运行以下命令

composer require gokhankurtulus/logger

用法

• 继承
• 保护日志

use Logger\Logger;

Logger::setFolderPath(__DIR__ . DIRECTORY_SEPARATOR . 'Logs');
Logger::setFileName('app.log');
Logger::iniSet(true, false, E_ALL);

Logger::log('this is app log message', 'this is log title');

Logs/app.log 输出

[01-01-2024 15:00:00 - Europe/Istanbul] - this is log title
this is log message

继承

如果您想对日志进行分类，可以继承Logger类。您必须覆盖$folderPath和$fileName参数以解决冲突。

class PDOLogger extends \Logger\Logger
{
    protected static string $folderPath = "";
    protected static string $fileName = "";
}

use Logger\Logger;

Logger::setFolderPath(__DIR__ . DIRECTORY_SEPARATOR . 'Logs');
Logger::setFileName('app.log');

// for log_errors, display_errors, error_reporting and
// error_log will be Logger::getFolderPath() . DIRECTORY_SEPARATOR . Logger::getFileName()
Logger::iniSet(true, false, E_ALL);

// You can give specific path for classes,
// by default it will be Logger's folder path
PDOLogger::setFolderPath(__DIR__ . DIRECTORY_SEPARATOR . 'DBLogs');
PDOLogger::setFileName('pdo.log');

Logger::log('this is app log message', 'this is log title');
PDOLogger::log('this is pdo log message');

Logs/app.log 输出

[01-01-2024 15:00:00 - Europe/Istanbul] - this is log title
this is app log message

DBLogs/pdo.log 输出

[01-01-2024 15:00:00 - Europe/Istanbul] - 
this is pdo log message

公共方法

Logger::log();
Logger::iniSet();
Logger::setFolderPath();
Logger::getFolderPath();
Logger::setFileName();
Logger::getFileName();

保护日志

日志文件可能包含敏感信息，例如数据库、凭证或其他机密数据。保护文件并限制访问以防止未经授权的信息泄露非常重要。日志的安全性是您的责任。但是，请注意以下步骤；

• 将日志文件夹放置在公共Web目录之外或放在无法直接通过Web服务器访问的目录中。
• 设置文件权限，确保只有授权用户或进程可以读取日志文件。
• 将日志文件夹添加到项目的.gitignore文件中。这确保了文件不会被包括在版本控制系统中，防止在代码仓库中意外暴露敏感信息。

许可证

Logger是开源软件，在MIT许可证下发布。您可以在项目中自由修改和使用它。

贡献

欢迎对Logger做出贡献！如果您发现任何问题或有改进建议，请在该项目的GitHub仓库中创建问题或提交拉取请求。