PHP Luminova: Autoloading Modules and Composer Dependency

Autoloading in Luminova simplifies the process of pre-loading the framework setup and registering dependencies, including Composer libraries, to make them readily available. This ensures that global functions, constants, and third-party libraries are accessible throughout your application.

Instead of manually loading the Composer autoloader (/system/plugins/autoload.php), you can load Luminova's autoloader (/system/Boot.php). This will automatically handle basic initialization and error handling setup.

Usage Examples

HTTP Example

To initialize the HTTP environment and get an instance of the application class:

use Luminova\Boot;

require_once __DIR__ . '/system/Boot.php';
$app = Boot::http();

To initialize the HTTP environment without needing the application class instance:

use Luminova\Boot;

require_once __DIR__ . '/system/Boot.php';
Boot::init();

CLI Example

For command-line interface (CLI) initialization:

use Luminova\Boot;

require_once __DIR__ . '/system/Boot.php';
Boot::cli();

Class Definition

• Namespace: Luminova\Boot
• Type: Final class, cannot be extended.

Methods

init

Initializes the HTTP environment for web and API applications.

Warms up the application, registers error handlers, and loads core modules.

public static init(): void

Similar to the http() method but does not return the application instance.

Usage:

use Luminova\Boot;

require_once __DIR__ . '/system/Boot.php';

Boot::init();

autoload

Initializes all required autoload modules.

Wrapper for warmup() and finish(). Loads core modules and prepares the application context without registering error handlers or configuring the CLI environment.

public static autoload(): void

Use this to ensure Composer and framework modules are available in the current context.

Usage:

use Luminova\Boot;

require_once __DIR__ . '/system/Boot.php';

Boot::autoload();

http

Prepares the HTTP environment for web and API applications.

Typically used in public/index.php. Ensures the application is warmed up, registers error handlers, and loads required core modules before returning the application instance.

public static http(): App\Application<CoreApplication, LazyInterface>

Returns

\App\Application<Luminova\Core\CoreApplication,Luminova\Interface\LazyInterface> - Return the application instance.

Usage:

// /public/index.php
use Luminova\Boot;

require_once __DIR__ . '/../system/Boot.php';

Boot::http()->router->context(...)->run();

cli

Prepares the CLI environment.

Intended for use in custom CLI scripts. Autoloads required files, enables error reporting, validates the SAPI type, defines CLI constants, and completes the bootstrapping process.

public static cli(): void

Usage:

// /bin/script.php

#!/usr/bin/env php
<?php
use Luminova\Boot;

require __DIR__ . '/system/Boot.php';

Boot::cli();

// Your cli implementation

warmup

Loads core modules and prepares the application environment.

Ensures constants, functions, error handlers, setting time zones, adjusting execution limits, configuring script behavior and loads core framework modules in the correct order. Also applies HTTP method spoofing early to ensure routing uses the correct request method.

public static warmup(): void

Note: The warmup method is automatically called when the Boot class is loaded. You may not need to call this method again.

shouldDefineCommandStreams

Ensures CLI standard streams (STDIN, STDOUT, STDERR) are defined.

This method uses tryFopen() to safely define the CLI standard streams if not already set.

public static shouldDefineCommandStreams(): void

tryFopen

Opens a file using fopen() with exception handling.

If the file can't be opened or an error occurs, a RuntimeException is thrown.

public static tryFopen(string $filename, string $mode): ?resource

Parameters:

Return Value:

resource|null - Return a valid stream resource.

Throws:

\Luminova\Exceptions\RuntimeException - If the file can't be opened.