struktal/struktal-logger

PHP library to write log messages to a file

1.0.1 2025-08-20 16:10 UTC

Requires

• php: >=8.2.0

MIT

• logging

README

This is a PHP library to write log messages to a file

Installation

To install this library, include it in your project using Composer:

composer require struktal/struktal-logger

Usage

Before you can use this library, you need to customize a few parameters. You can do this in the startup of your application:

\struktal\Logger\Logger::setLogDirectory("/path/to/logs/");
\struktal\Logger\Logger::setMinLogLevel(\struktal\Logger\LogLevel::TRACE);

You can also set custom, additional log handlers if you want to log to a database or send error logs via email:

\struktal\Logger\Logger::addCustomLogHandler(
    \struktal\Logger\LogLevel::ERROR,
    function(string $formattedMessage, string $serializedMessage, mixed $originalMessage) {
        // Custom log handler logic here
    }
);

Then, in your code, you can instantiate the logger by using

$logger = new \struktal\Logger\Logger("custom-tag");

and use it to log messages with different log levels:

$logger->trace("This is a trace message");
$logger->debug("This is a debug message");
$logger->info("This is an info message");
$logger->warn("This is a warning message");
$logger->error("This is an error message");
$logger->fatal("This is a fatal message");

License

This software is licensed under the MIT license. See the LICENSE file for more information.