stellarwp/foundation-log

The Foundation Logger

dev-main / 1.1.x-dev 2026-06-02 16:24 UTC

Requires

• php: >=8.3
• monolog/monolog: ^2.11
• psr/log: >=1.0
• stellarwp/foundation-container: ^1.0

GPL-2.0-or-later

README

Warning

This is a read-only repository! For pull requests or issues, see stellarwp/foundation.

A logging library using Monolog that implements the Psr\Log\LoggerInterface interface.

Installation

composer require stellarwp/foundation-log

If using stellarwp/foundation-container, create a config.php and register it in the container with:

$this->container->bind(Dot::class, new Dot(require_once dirname(__FILE__) . '/config.php'));

The config.php file maps environment variables, either from an .env file if you configured phpdotenv, or manually set, e.g.

<?php declare(strict_types=1);

return [
	'log'             => [
		'level'    => $_ENV['APP_LOG_LEVEL'] ?? 'debug',
		'channel'  => $_ENV['APP_LOG_CHANNEL'] ?? 'null', // console, errorlog, stack (both console and errorlog) or null
		'channels' => [
			'errorlog' => [],
			'console'  => [
				'with' => [
					'stream' => 'php://stdout',
				],
			],
			'stack'    => [
				'with' => [
					'stream' => 'php://stdout',
				],
			],
		],
	],
];

Then, include the LogProvider.php in your application and call the register method. Anytime you inject a Psr\Log\LoggerInterface instance into another class, it will use your provided configuration.