Application

MMO\core · 1 symbol · generated 5 Oct 2026

class

Application

This is the main module of the framework: - listen on the php signals : shutdown, error, exception, autoload - route request and send response to the server - log everything - plan jobs (CRON like)

final class MMO\core\Application extends MMO\core\classes\aModule implements Psr\Http\Server\RequestHandlerInterface

Namespace: MMO\core
Extends: aModule
Implements: RequestHandlerInterface

> NOTE: to print directly the logs on screen in realtime use the configuration: `stream: stdout` ### Router The application route and handle any request. You can call `\MMO\run()` to route the current request or pass a request as argument to run your custom request. When run, the application follow these steps: 1. create a `\MMO\core\server\Route` holding the current request and all the middlewares (function to call with the route) that match the current request's url. 2. dispatch the route, so it can be altered (remove/add middleware, set a default response, add request's attribute, etc..) 3. execute the middleware (that should create/alter the response) 4. dispatch the final response 5. send the response to the server 6. exit > Note: It is a good idea to listen to the event `\MMO\core\server\Route` when you want to execute generic behavior before any controller. (like checking for updates) ` MMO\core\server\Route::AddListener(function (Route $route) {..});` > Note: Listen to the event `\MMO\core\server\Response` to execute behavior just before the response is sent to the server. ` MMO\core\server\Response::AddListener(function (Response $response) {..});` ### Jobs The application allow to register jobs to do if certain conditions are met. A job has a trigger function (a test that indicates if the jobs needs to be activated), and an action function (the job). These functions take no arguments. The trigger function MUST return a boolean. The jobs are tested during 4 phases of the application. You can set them up for one or multiple phases, combining the flags with the binary operator `|`. - PHASE_START: job is executed just after the application has been waked up - PHASE_RUN: job is executed just after the route has been dispatched - PHASE_RESPONSE: job is executed just before the response is sent to the server - PHASE_SHUTDOWN: job is executed just before the application shutdown (WARNING: not safe for long job) - PHASE_EXCEPTION: job is executed when an exception is not caught

Index

	OPENAPI_VERSION
	PHASE_EXCEPTION	job is executed when an exception is not caught
	PHASE_RESPONSE	job is executed just before the response is sent to the server
	PHASE_RUN	job is executed just after the route has been dispatched
	PHASE_SHUTDOWN	job is executed just before the application shutdown (WARNING: not safe for long job)
	PHASE_START	job is executed just after the application has been waked up
	autoload	tells if application capture autoload
	errors	tells if application capture errors/exceptions
	exception	the last exception encountered
	inc
	info	Application information (for API)
	jobs
	logs
	paths	Paths aliases
	phase
	printer	current text dumper
	response
	route
	routes	{string: [\MMO\core\attributes\APIRoute]} the key is a group id (generally a classname)
	sortJobs
	stream	the stream to write the logs in
	absoluteFilename($uri, $base)	Generate a valid absolute filename, resolving path.
	absoluteUrl($uri, $base)	Generate a valid absolute url, resolving path.
	addInfo($info)	Merge extra info (title/description/contact/...) into `$info`, used by `api`'s OpenAPI document.
	addJob($trigger, $job, $when, $priority)	Register a job: $trigger is checked (and $job run if it returns true) during `executeJobs`, called once per phase this application goes through (`PHASE_START`/`PHASE_RUN`/`PHASE_RESPONSE`/
	addJobs($jobs)
	addLog($log)	Write log in the log stream (if any) or add it to the pool.
	addRoute($groupId, $route)	Add one more route to $groupId (creating the group if needed), on top of whatever `connectRoutes` already extracted.
	api()
	captureAutoload($capture)	Set/unset php autoload hook
	captureErrors($capture)	Set/unset php error hook
	classUrl($class, $extension, $resolve)	Convert a classname/namespace into an uri with an path
	clearLogs($disableLogs)
	clearRoutes()	Remove every registered route.
	connectRoutes($class, $config)	Connect route of a class or a function
	createErrorResponse($e)	Called by the route when an exception occurs, or by the php exception handler.
	DefaultConfig() static
	dump($values)	Dump $values using whichever printer matches the current response's content type (falling back to `$printer` before any response exists).
	executeJobs($when)	Run every job (`addJob`) whose trigger currently returns true and whose $when includes $when; a job throwing is logged, not propagated.
	extractRoutes($class, $config)	Extract api routes from a function/class attributes
	findRoute($groupId, $operation)
	getDescription()
	getIcon()
	getIncludes()
	getJobs($when, $executeTrigger)
	getJobTrigger($job)
	getLogs($flush)	Get and flush the logs in the pool.
	getPath($path)
	getPaths($resolve)	Get all alias for paths
	getPhase()
	getRequest()
	getResponse()
	getRoute()
	getRoutes($groupId)
	getTitle()
	getTriggerJob($trigger)
	getVersion()
	getWorker($id, $regex)
	getWorkerFile()
	getWorkers()
	handle($request)
	hasRoutes($groupId)
	isCapturingAutoload()
	isCapturingErrors()
	onAutoload($event)
	phpAutoload($class)	Magic php autoload handler Use directly spl_autoload_register
	phpError($no, $str, $file, $line, $context)	Magic php error handler Maps a raw PHP error (`set_error_handler`) to a log level and message, ignoring the `@`-suppression operator by design -- so an error a caller tried to silence via `@` is…
	phpException($e)	Magic php exception handler Called for a truly uncaught exception (`set_exception_handler`) -- logs it, dispatches it if it's an
	phpShutdown()	Shutdown function call by register_shutdown_function WARNING: DO NOT call directly.
	registerWorker($cmd, $pid)	Record a background worker (`runWorker`) in the registry file (`getWorkerFile`), appending to it.
	removeJob($fn)	Remove a job from a trigger or a job
	removeRoutes($groupId)
	resolvePath($uri, $maxRecursivity)	Resolve path recursively.
	routeAPI($route)	API endpoint serving `api`'s OpenAPI document; stops further middleware so nothing else can alter it.
	run($request)	Run and exit the application
	runInteractive($request)	Run the application, executing middlewares and returns a Response or an exception
	runWorker($cmd, $sleep)	Start $cmd as a detached background process and register it (`registerWorker`).
	sendResponse($response)	Call this function to send a response
	setDescription($value)
	setIcon($icon)
	setIncludes($pkgs)	Include packages after the project and the application has been instantiated
	setPath($path, $value)	Set a path for an uri part A path `xxx` replace any uri parts named `{xxx}`
	setPaths($paths, $isWindows)	Set path for given paths.
	setPhase($phase)	Advance to $phase and run every job registered for it (`executeJobs`).
	setRoutes($routes)
	setStream($stream)	Set the stream to write the logs in
	setTitle($value)
	__construct($config)
	__wakeup()	Registers this class's own routes (`routeAPI`) and advances to `PHASE_START`.

Constants6

OPENAPI_VERSION

const OPENAPI_VERSION = '3.0.3'

PHASE_EXCEPTION

job is executed when an exception is not caught

const PHASE_EXCEPTION = 16

PHASE_RESPONSE

job is executed just before the response is sent to the server

const PHASE_RESPONSE = 4

PHASE_RUN

job is executed just after the route has been dispatched

const PHASE_RUN = 2

PHASE_SHUTDOWN

job is executed just before the application shutdown (WARNING: not safe for long job)

const PHASE_SHUTDOWN = 8

PHASE_START

job is executed just after the application has been waked up

const PHASE_START = 1

Properties15

autoload

tells if application capture autoload

#[MMO\core\attributes\Serialize(unserialize: 'captureAutoload')] protected bool $autoload = false

Type: bool

errors

tells if application capture errors/exceptions

#[MMO\core\attributes\Serialize(unserialize: 'captureErrors')] protected bool $errors = false

Type: bool

exception

the last exception encountered

#[MMO\core\attributes\Serialize(false)] protected ?Throwable $exception = null

Type: null | Throwable

inc

#[MMO\core\attributes\Serialize(unserialize: 'setIncludes', order: 1000)] protected array $inc = []

Type: array

info

Application information (for API)

array $info = []

Type: array

jobs

#[MMO\core\attributes\Serialize(serialize: false, unserialize: 'addJobs', order: 1000)] protected array $jobs = []

Type: array

logs

#[MMO\core\attributes\Serialize(false)] protected array $logs = []

Type: array

paths

Paths aliases

#[MMO\core\attributes\Serialize(serialize: 'getPaths', unserialize: 'setPaths', order: -100)] protected array $paths = []

Type: array

phase

#[MMO\core\attributes\Serialize(false)] protected int $phase = 0

Type: int

printer

current text dumper

#[MMO\core\attributes\Serialize(order: -10)] MMO\core\printers\TextPrinter $printer

Type: TextPrinter

response

#[MMO\core\attributes\Serialize(false)] protected ?MMO\core\interfaces\iResponse $response = null

Type: null | iResponse

route

#[MMO\core\attributes\Serialize(false)] protected ?MMO\core\server\Route $route = null

Type: null | Route

routes

{string: [\MMO\core\attributes\APIRoute]} the key is a group id (generally a classname)

#[MMO\core\attributes\Serialize(unserialize: 'setRoutes', order: 100)] protected array $routes = []

Type: array

sortJobs

#[MMO\core\attributes\Serialize(false)] protected bool $sortJobs = false

Type: bool

stream

the stream to write the logs in

#[MMO\core\attributes\Serialize(unserialize: 'setStream', order: -9)] protected ?Psr\Http\Message\StreamInterface $stream = null

Type: null | StreamInterface

Methods68

absoluteFilename($uri, $base)

Application.php:641

Generate a valid absolute filename, resolving path.

function absoluteFilename(string $uri, string $base = '{root}'): string

Any relative filename is resolved using 'root' path by default. WARNING: absoluteUrl is resolved using baseurl by default. abolsuteFilename and absoluteUrl ARE NOT resolved from the same folder. If uri has an authority part, it is rebased using baseurl and basepath

$uri	string
$base = '{root}'	string	the path to use to make the uri absolute
returns	string

absoluteUrl($uri, $base)

Application.php:670

Generate a valid absolute url, resolving path.

function absoluteUrl(string $uri, string $base = '{siteurl}'): string

If uri is absolute and has no authority, it is rebased using basepath as old base

$uri	string
$base = '{siteurl}'	string	the base uri to use to resole the uri
returns	string

addInfo($info)

Application.php:999

Merge extra info (title/description/contact/...) into $info, used by api's OpenAPI document.

function addInfo(array $info): void

$info	array
returns	void

addJob($trigger, $job, $when, $priority)

Application.php:422

Register a job: $trigger is checked (and $job run if it returns true) during executeJobs, called once per phase this application goes through (PHASE_START/PHASE_RUN/PHASE_RESPONSE/

function addJob( callable $trigger, callable $job, int $when = self::PHASE_RUN, int $priority = 0 ): void

See: PHASE_SHUTDOWN/PHASE_EXCEPTION). If $when only names phase(s) already passed, $trigger is checked immediately instead (since executeJobs will never reach them again).

$trigger	callable	`function(): bool`.
$job	callable	`function(): void`.
$when = self::PHASE_RUN	int	a bitmask of PHASE_* constants.
$priority = 0	int	lower runs first among jobs registered for the same phase.
returns	void

addJobs($jobs)

Application.php:408

function addJobs(array $jobs): void

$jobs	array	list of [$trigger, $job, $when, $priority]-shaped argument lists, each passed to `addJob`.
returns	void

addLog($log)

Application.php:367

Write log in the log stream (if any) or add it to the pool.

function addLog(MMO\core\events\Log $log): void

Call directly when any dispatcher connected to the application dispatch a Log. WARNING: The verbosity of the application has no effect on the log being added, except when it is set to 0. In that case, ALL logs are ignored.

$log	Log
returns	void

addRoute($groupId, $route)

Application.php:742

Add one more route to $groupId (creating the group if needed), on top of whatever connectRoutes already extracted. @return APIRoute $route, for chaining.

function addRoute(string $groupId, MMO\core\attributes\APIRoute $route): MMO\core\attributes\APIRoute

$groupId	string
$route	APIRoute
returns	APIRoute

api()

Application.php:1033

function api(): array

returns array an OpenAPI 3.0 document describing every registered route (APIRoute::api).

captureAutoload($capture)

Application.php:1236

Set/unset php autoload hook

function captureAutoload(bool $capture = true): self

$capture = true	bool
returns	self

captureErrors($capture)

Application.php:1195

Set/unset php error hook

function captureErrors(bool $capture = true): self

$capture = true	bool
returns	self

classUrl($class, $extension, $resolve)

Application.php:620

Convert a classname/namespace into an uri with an path

function classUrl( string $class, string $extension = MMO\core\PHP_EXTENSION, bool $resolve = true ): ?string

$class	string
$extension = MMO\core\PHP_EXTENSION	string	the file extension to use (without `.`). Leave empty if you want to get a namespace's folder.
$resolve = true	bool	if false, returned an uri containing path
returns	null \| string	null if no path was found

clearLogs($disableLogs)

Application.php:400

function clearLogs(bool $disableLogs = false): void

$disableLogs = false	bool	if true, also silences all further logging (`tLogEmitter::setVerbosity(0)`).
returns	void

clearRoutes()

Application.php:711

Remove every registered route.

function clearRoutes(): self

returns

self

connectRoutes($class, $config)

Application.php:807

Connect route of a class or a function

function connectRoutes(string $class, array $config = []): bool

$class	string	a classname or a valid function's name
$config = []	array
returns	bool
throws
throws		if application is already running

createErrorResponse($e)

Application.php:888

Called by the route when an exception occurs, or by the php exception handler.

function createErrorResponse(Throwable $e): MMO\core\server\Response

Its status is the exception's code when that is an HTTP status, 500 otherwise ([`httpStatus`](https://mcp.mmoframework.fr/documentation/mmo.core/php/server.md#httpstatus)): a PDOException's code is its SQLSTATE, a string.

$e	Throwable
returns	Response

\MMO\app()->createErrorResponse($pdoException)->getStatusCode(); // 500

DefaultConfig()

staticApplication.php:128

static function DefaultConfig(): array

returns

array

dump($values)

Application.php:218

Dump $values using whichever printer matches the current response's content type (falling back to $printer before any response exists).

function dump(mixed ...$values)

...$values	mixed
returns

executeJobs($when)

Application.php:504

Run every job (addJob) whose trigger currently returns true and whose $when includes $when; a job throwing is logged, not propagated.

function executeJobs(int $when): void

$when	int
returns	void

extractRoutes($class, $config)

Application.php:769

Extract api routes from a function/class attributes

function extractRoutes(string $class, array $config = []): array

$class	string	a function's name or a classname
$config = []	array	- basepath: the route basepath
returns	array	a sorted list of APIRoute
throws

findRoute($groupId, $operation)

Application.php:732

function findRoute(string $groupId, callable|string|null $operation = null): ?MMO\core\attributes\APIRoute

$groupId	string
$operation = null	callable \| string \| null	defaults to $groupId itself (the common case: a group with one route, named after itself).
returns	null \| APIRoute	the route in $groupId whose operation matches, or null.

getDescription()

Application.php:1003

function getDescription(): string

returns

string

getIcon()

Application.php:1019

function getIcon(): ?string

returns

null | string

getIncludes()

Application.php:240

function getIncludes(): array

returns array the packages passed to the last setIncludes call.

getJobs($when, $executeTrigger)

Application.php:485

function getJobs(object|int $when = -1, bool $executeTrigger = false): array

$when = -1	object \| int	a `PHASE_*` bitmask, or an object instance to find jobs bound to (matches a `[$instance, 'method']`-style job callable whose object is `===` $when).
$executeTrigger = false	bool	if true, only include jobs whose trigger currently returns true (and actually call each one).
returns	array	every matching job callable.

getJobTrigger($job)

Application.php:446

function getJobTrigger(callable $job): ?callable

$job	callable	must be `===` the exact callable passed to `addJob`.
returns	null \| callable	the matching trigger, or null.

getLogs($flush)

Application.php:393

Get and flush the logs in the pool.

function getLogs(bool $flush = true): array

$flush = true	bool	if false, don't flush the logs from the pool
returns	array

getPath($path)

Application.php:555

function getPath(string $path): ?string

$path	string	without curly brackets.
returns	null \| string	the raw (unresolved) value, or null if unset.

getPaths($resolve)

Application.php:533

Get all alias for paths

function getPaths(bool $resolve = false): array

$resolve = false	bool
returns	array

getPhase()

Application.php:517

function getPhase(): int

returns int the current PHASE_* constant.

getRequest()

Application.php:698

function getRequest(): Psr\Http\Message\ServerRequestInterface

returns ServerRequestInterface the current route's request, or (before handling one) a freshly-built one from the real environment (CLI argv or the real HTTP request).

getResponse()

Application.php:936

function getResponse(): ?MMO\core\interfaces\iResponse

returns null | iResponse the response sendResponse actually sent, or null before one has been sent.

getRoute()

Application.php:693

function getRoute(): ?MMO\core\server\Route

returns null | Route the route currently being handled (handle), or null before any request has been handled.

getRoutes($groupId)

Application.php:706

function getRoutes(?string $groupId = null): array

$groupId = null	null \| string	if given, only that group's routes; if null, every group.
returns	array	APIRoute[] (or array<string, APIRoute[]> when $groupId is null).

getTitle()

Application.php:1011

function getTitle(): string

returns

string

getTriggerJob($trigger)

Application.php:457

function getTriggerJob(callable $trigger): ?callable

$trigger	callable	must be `===` the exact callable passed to `addJob`.
returns	null \| callable	the matching job, or null.

getVersion()

Application.php:1028

function getVersion(): ?string

returns null | string the project's own version (PackageManager::getProjectManifest), or null if no project manifest is set.

getWorker($id, $regex)

Application.php:323

function getWorker(string $id, bool $regex = false): ?array

$id	string	a pid or exact command to match, or (with $regex) a regex to match the command against.
$regex = false	bool
returns	null \| array	the matching worker (`getWorkers`' shape), or null.

getWorkerFile()

Application.php:247

function getWorkerFile(): string

returns string the registry file tracking background workers (registerWorker/getWorkers).

getWorkers()

Application.php:285

function getWorkers(): array

returns

array

[['date' => ..., 'pid' => ..., 'cmd' => ..., 'main' => the registering process's own pid, 'run' => bool whether it's still running], ...] -- every registered worker; also prunes no-longer-running ones from the registry file as a side effect (deleting the file entirely once none are left).

handle($request)

Application.php:825

function handle(Psr\Http\Message\ServerRequestInterface $request): MMO\core\interfaces\iResponse

See: RequestHandlerInterface::handle -- match $request against every registered route (connectRoutes), adding a middleware for each match (Route::addMiddleware), then Route::dispatch and Route::handle it. An uncaught exception from the route becomes an error response instead (createErrorResponse), via the route's own error handler if it set one.

$request	`ServerRequestInterface`
returns	iResponse

hasRoutes($groupId)

Application.php:758

function hasRoutes(string $groupId): bool

$groupId	string
returns	bool	whether $groupId has any routes registered.

isCapturingAutoload()

Application.php:1227

function isCapturingAutoload(): bool

returns bool whether classes are currently routed through onAutoload (phpAutoload).

isCapturingErrors()

Application.php:1186

function isCapturingErrors(): bool

returns bool whether PHP errors/exceptions are currently routed through phpError/phpException.

onAutoload($event)

Application.php:206

function onAutoload(MMO\core\events\Autoload $event): void

See: Autoload event handler: loads a class from a registered path (classUrl/setPath), if one resolves to an existing file.

$event	Autoload
returns	void

phpAutoload($class)

Application.php:1142

Magic php autoload handler Use directly spl_autoload_register

function phpAutoload(string $class): void

$class	string
returns	void

phpError($no, $str, $file, $line, $context)

Application.php:1070

Magic php error handler Maps a raw PHP error (set_error_handler) to a log level and message, ignoring the @-suppression operator by design -- so an error a caller tried to silence via @ is still logged/recorded, just not displayed.

function phpError( int $no, string $str, ?string $file = null, ?int $line = null, mixed $context = null ): bool

$no	int
$str	string
$file = null	null \| string
$line = null	null \| int
$context = null	mixed
returns	bool	always true (tells PHP not to run its own default error handler too).

phpException($e)

Application.php:1121

Magic php exception handler Called for a truly uncaught exception (set_exception_handler) -- logs it, dispatches it if it's an

function phpException(Throwable $e): void

See: iException, and (if nothing has already sent a response) sends an error response for it (createErrorResponse).

$e	Throwable
returns	void

phpShutdown()

Application.php:1151

Shutdown function call by register_shutdown_function WARNING: DO NOT call directly. It is called automatically by the shutdown process.

function phpShutdown(): void

returns

void

registerWorker($cmd, $pid)

Application.php:274

Record a background worker (runWorker) in the registry file (getWorkerFile), appending to it.

function registerWorker(string $cmd, string $pid): void

$cmd	string
$pid	string
returns	void

removeJob($fn)

Application.php:469

Remove a job from a trigger or a job

function removeJob(callable $fn): bool

$fn	callable	the job or the trigger
returns	bool

removeRoutes($groupId)

Application.php:749

function removeRoutes(string $groupId): bool

$groupId	string
returns	bool	false if $groupId wasn't registered.

resolvePath($uri, $maxRecursivity)

Application.php:599

Resolve path recursively.

function resolvePath(string $uri, int $maxRecursivity = 10): string

$uri	string
$maxRecursivity = 10	int
returns	string

routeAPI($route)

Application.php:1054

API endpoint serving api's OpenAPI document; stops further middleware so nothing else can alter it.

#[MMO\core\attributes\APIRoute('GET|api.json', 'Get the OpenAPI document for the routes of the application', order: -1000, mediaTypes: ['json'])] function routeAPI(MMO\core\server\Route $route): MMO\core\server\Response

$route	Route
returns	Response

run($request)

Application.php:928

Run and exit the application

function run(?Psr\Http\Message\ServerRequestInterface $request = null): never

$request = null	null \| `ServerRequestInterface`
returns	never	it exits the script

runInteractive($request)

Application.php:918

Run the application, executing middlewares and returns a Response or an exception

function runInteractive(?Psr\Http\Message\ServerRequestInterface $request = null): ?MMO\core\interfaces\iResponse

$request = null	null \| `ServerRequestInterface`
returns	null \| iResponse

runWorker($cmd, $sleep)

Application.php:259

Start $cmd as a detached background process and register it (registerWorker).

function runWorker(string $cmd, int $sleep = 1): string

$cmd	string
$sleep = 1	int	seconds to wait before checking the process actually started.
returns	string	the new process's PID.
throws		if the process doesn't appear to be running after $sleep seconds (already running under this exact command, per `getWorker`, is reported specifically; anything else is a generic failure).

sendResponse($response)

Application.php:947

Call this function to send a response

function sendResponse(MMO\core\interfaces\iResponse $response): bool

$response	iResponse
returns	bool	false if the response's own dispatch stopped propagation (nothing was sent), or if sending itself failed (logged as critical, not thrown).
throws		if a response has already been sent (`getResponse`).

setDescription($value)

Application.php:1007

function setDescription(string $value): void

$value	string
returns	void

setIcon($icon)

Application.php:1023

function setIcon(?string $icon): void

$icon	null \| string
returns	void

setIncludes($pkgs)

Application.php:234

Include packages after the project and the application has been instantiated

function setIncludes(array $pkgs): void

$pkgs	array	`inc`
returns	void

setPath($path, $value)

Application.php:565

Set a path for an uri part A path xxx replace any uri parts named {xxx}

function setPath(string $path, string $value): bool

$path	string	the path's name without curly brackets.
$value	string
returns	bool

setPaths($paths, $isWindows)

Application.php:585

Set path for given paths.

function setPaths(array $paths, bool $isWindows = MMO\core\IS_WINDOWS): void

On Windows, convert `\` to `/` in path. On linux same as `setPath($path, $path)`

$paths	array	$name => $path ($name is the path's name without curly brackets).
$isWindows = MMO\core\IS_WINDOWS	bool
returns	void

setPhase($phase)

Application.php:522

Advance to $phase and run every job registered for it (executeJobs).

protected function setPhase(int $phase): void

$phase	int
returns	void

setRoutes($routes)

Application.php:717

function setRoutes(array $routes): void

$routes	array	group-id => config (or a plain list of group-ids with no config), each passed to `connectRoutes`.
returns	void

setStream($stream)

Application.php:339

Set the stream to write the logs in

function setStream(Psr\Http\Message\StreamInterface|string|null $stream = null): bool

$stream = null	`StreamInterface` \| string \| null
returns	bool

setTitle($value)

Application.php:1015

function setTitle(string $value): void

$value	string
returns	void

__construct($config)

Application.php:181

protected function __construct(array &$config)

$config

array

__wakeup()

Application.php:200

Registers this class's own routes (routeAPI) and advances to PHASE_START.

function __wakeup(): void

returns

void

Inherited members (46)

Constants	Declared by	Description
`ALERT`	iLogLevel	Alert: Action must be taken immediately.
`ALL`	iLogLevel	Mask for all
`ALL_PLUS`	iLogLevel	debug everything
`BACKTRACE`	iLogLevel
`CRITICAL`	iLogLevel	Critical: Critical conditions.
`DEBUG`	iLogLevel	Debug: Detailed debug information.
`DEEP`	iLogLevel	debug everything with arguments
`EMERGENCY`	iLogLevel	Emergency: System is unusable.
`ERROR`	iLogLevel	Error: Runtime errors that do not require immediate action but should typically be logged and monitored.
`ERROR_PLUS`	iLogLevel	Mask for all error
`FATAL`	iLogLevel	Mask for all fatal error
`INFO`	iLogLevel	Info: Interesting events.
`INFO_PLUS`	iLogLevel	Mask for all errors/warning/notices/info
`MEMORY`	iLogLevel	include backtrace object
`NOTICE`	iLogLevel	Notice: Normal but significant events.
`NOTICE_PLUS`	iLogLevel	Mask for all errors/warning/notices/info
`TRACE`	iLogLevel	include backtrace as origins
`WARNING`	iLogLevel	Warning: Exceptional occurrences that are not errors.
`WARNING_PLUS`	iLogLevel	Mask for all errors and warnings

	Properties	Declared by	Description
	`verbosity`	aModule

Methods	Declared by	Description
`alert($message, $context)`	aModule	Action must be taken immediately.
`backtraces($message, $context)`	aModule	Force-log a message at INFO level together with a full stack trace/memory snapshot (`iLogLevel::BACKTRACE`), bypassing the verbosity mask entirely (any non-zero verbosity is enough to trigger it).
`Configure($config)`	aModule	Merge $config into this module's configuration in the shared `Configuration`.
`critical($message, $context)`	aModule	Critical conditions. No-op if CRITICAL is currently filtered out by the verbosity mask.
`debug($message, $context)`	aModule	Detailed debug information.
`debugName()`	aModule	Human-readable identifier used as the default `{origin}` in this instance's log messages.
`emergency($message, $context)`	aModule	System is unusable. No-op if EMERGENCY is currently filtered out by the verbosity mask.
`error($message, $context)`	aModule	Runtime errors that do not require immediate action but should typically be logged and monitored.
`getVerbosity()`	aModule
`info($message, $context)`	aModule	Interesting events. No-op if INFO is currently filtered out by the verbosity mask.
`Instantiate($config)`	aModule	(Re)create the shared instance immediately, configured with $config merged into the class's existing config.
`IsShared()`	aModule
`log($level, $message, $context)`	aModule	Logs with an arbitrary level.
`notice($message, $context)`	aModule	Normal but significant events.
`offsetExists($key)`	aModule	\ArrayAccess::offsetExists -- tells whether $key is a declared property at all, regardless of whether it is currently readable/writable through array access.
`offsetGet($key)`	aModule	\ArrayAccess::offsetGet -- reads a property directly, unless it has a `#[Serialize(serialize: 'methodName')]` attribute, in which case that zero-argument method is called instead (e.g.
`offsetSet($key, $value)`	aModule	\ArrayAccess::offsetSet -- sets a property directly, unless it has a `#[Serialize(unserialize: 'methodName')]` attribute, in which case that method is called with $value instead (e.g.
`offsetUnset($key)`	aModule	\ArrayAccess::offsetUnset -- equivalent to `$module[$key] = null`.
`serialize($path, $serializer)`	aModule	\MMO\core\interfaces\iSerializable::serialize -- exports every property (via
`setVerbosity($verb)`	aModule	Set the current verbosity mask, replacing whatever it was before.
`Shared()`	aModule	Get the shared instance, creating (and configuring) it on first call.
`testVerbosity($level)`	aModule	Test whether a given level (or set of levels) is currently enabled by this instance's verbosity mask.
`traitUnshare($serialize)`	aModule	Remove the shared instance, so the next `Shared()` call creates a fresh one.
`unserialize($data, $path, $instances)`	aModule	\MMO\core\interfaces\iSerializable::unserialize -- merges $data onto `DefaultConfig`, runs it through the (possibly overridden) constructor, then applies each resulting value to its property (via
`Unshare($serialize)`	aModule	Like `tSingleton::Unshare`, but also disconnects this module's instance from every event it was listening to (via `Event::DisconnectListeners`) before dropping it.
`warning($message, $context)`	aModule	Exceptional occurrences that are not errors.