FiberModuleLoader Class Reference

Static Public Member Functions
static	getFiber (string $module)
static	getLoadedModules ()
static	init ()
static	isAvailable ()
static	isLoaded (string $module)
static	isLoading (string $module)
static	loadInFiber (string $module, callable $loader, int $timeout=5000)
static	waitAll (int $timeout=5000)
static	waitForModule (string $module, int $timeout=5000)

Static Private Attributes
static	$enabled = false
static	$fibers = []

Detailed Description

Class FiberModuleLoader

Manages true asynchronous module loading using PHP 8.1+ Fibers. Fibers provide lightweight pseudo-threading without race conditions.

Works with PHP 8.1+. Falls back gracefully if Fibers unavailable.

Definition at line 17 of file class.fibermoduleloader.php.

Member Function Documentation

getFiber()

getFiber ( string $module )

static

Get fiber for a module (advanced usage)

Parameters

string

$module

Module name

Returns

FiberModule|null The fiber module or null

Definition at line 159 of file class.fibermoduleloader.php.

                                                   : ?FiberModule
    {
        return self::$fibers[$module] ?? null;
    }

getLoadedModules()

getLoadedModules ( )

static

Get all loaded modules

Returns

array Module names

Definition at line 179 of file class.fibermoduleloader.php.

                                             : array
    {
        return array_keys(self::$fibers);
    }

init()

init ( )

static

Initialize Fiber module loader Checks if Fibers are available in this PHP version

Returns

bool True if Fibers available

Definition at line 31 of file class.fibermoduleloader.php.

                                 : bool
    {
        self::$enabled = PHP_VERSION_ID >= 80100;
 
        if (!self::$enabled) {
            Log::warning('FiberModuleLoader unavailable (requires PHP 8.1+, using fallback async)');
        }
 
        return self::$enabled;
    }

References Log\warning().

Referenced by Root\register().

Here is the call graph for this function:

Here is the caller graph for this function:

isAvailable()

isAvailable ( )

static

Check if Fibers are available

Returns

bool True if PHP 8.1+ with Fibers

Definition at line 169 of file class.fibermoduleloader.php.

                                        : bool
    {
        return self::$enabled;
    }

Referenced by Root\ensureModuleLoaded().

Here is the caller graph for this function:

isLoaded()

isLoaded ( string $module )

static

Check if a module is loaded

Parameters

string

$module

Module name

Returns

bool True if module finished loading

Definition at line 127 of file class.fibermoduleloader.php.

                                                   : bool
    {
        if (!isset(self::$fibers[$module])) {
            return true; // Not in fiber system
        }
 
        return self::$fibers[$module]->isReady();
    }

isLoading()

isLoading ( string $module )

static

Check if a module is currently loading

Parameters

string

$module

Module name

Returns

bool True if still loading

Definition at line 143 of file class.fibermoduleloader.php.

                                                    : bool
    {
        if (!isset(self::$fibers[$module])) {
            return false;
        }
 
        return !self::$fibers[$module]->isReady();
    }

loadInFiber()

loadInFiber ( string $module, callable $loader, int $timeout = 5000 )

static

Load module in a Fiber (true concurrent) Returns immediately; module loads in background

Parameters

string	$module	Module name
callable	$loader	Function that loads the module
int	$timeout	Maximum wait time if accessed before ready (ms)

Returns

bool True if fiber started, false if Fibers unavailable

Definition at line 52 of file class.fibermoduleloader.php.

     : bool {
        if (!self::$enabled) {
            // Fallback: load synchronously
            call_user_func($loader);
 
            return false;
        }
 
        // Create fiber for concurrent execution
        $fiberModule           = new FiberModule($module, $loader, $timeout);
        self::$fibers[$module] = $fiberModule;
 
        return true;
    }

References $enabled, and if.

Referenced by Root\loadAppsFiber(), Root\loadHomepageFiber(), Root\loadRegistryFiber(), and Root\loadToolsFiber().

Here is the caller graph for this function:

waitAll()

waitAll ( int $timeout = 5000 )

static

Wait for all fibers to complete Useful for synchronization before proceeding

Parameters

int

$timeout

Maximum total wait time (ms)

Returns

bool True if all loaded, false if timeout

Definition at line 97 of file class.fibermoduleloader.php.

                                                     : bool
    {
        if (!self::$enabled || empty(self::$fibers)) {
            return true;
        }
 
        $start   = microtime(true);
        $maxWait = $timeout / 1000;
 
        foreach (self::$fibers as $module => $fiber) {
            $elapsed   = microtime(true) - $start;
            $remaining = max(100, ($maxWait - $elapsed) * 1000);
 
            if (!$fiber->wait((int)$remaining)) {
                Log::warning('Timeout waiting for module: ' . $module);
 
                return false;
            }
        }
 
        return true;
    }

References Log\warning().

Here is the call graph for this function:

waitForModule()

waitForModule ( string $module, int $timeout = 5000 )

static

Wait for a specific module to finish loading Blocks until module is ready or timeout expires

Parameters

string	$module	Module name
int	$timeout	Maximum wait time (ms)

Returns

bool True if module loaded, false if timeout

Definition at line 80 of file class.fibermoduleloader.php.

                                                                           : bool
    {
        if (!isset(self::$fibers[$module])) {
            return true; // Not loaded in fiber, must be ready
        }
 
        return self::$fibers[$module]->wait($timeout);
    }

Referenced by Root\ensureModuleLoaded().

Here is the caller graph for this function:

Field Documentation

$enabled

$enabled = false

staticprivate

Definition at line 23 of file class.fibermoduleloader.php.

Referenced by loadInFiber().

$fibers

$fibers = []

staticprivate

Definition at line 20 of file class.fibermoduleloader.php.

---

The documentation for this class was generated from the following file:

• E:/Bearsampp-development/sandbox/core/classes/class.fibermoduleloader.php