ModuleLoader Class Reference

Static Public Member Functions
static	isLoaded ($module)
static	isLoading ($module)
static	loadAsync ($module, callable $loader)
static	loadSync ($module, callable $loader)
static	markLoaded ($module)
static	waitForModule ($module, $timeout=5000)

Data Fields
const	APPS = 'apps'
const	BINS = 'bins'
const	CONFIG = 'config'
const	CORE = 'core'
const	HOMEPAGE = 'homepage'
const	LANG = 'lang'
const	OPENSSL = 'openssl'
const	REGISTRY = 'registry'
const	TOOLS = 'tools'
const	WINBINDER = 'winbinder'

Static Private Member Functions
static	loadInBackground ($module, callable $loader)

Static Private Attributes
static	$loading = array()
static	$maxWaitTime = 5000
static	$modules = array()

Detailed Description

Class ModuleLoader

Manages asynchronous loading of non-critical modules. Critical modules (Core, Config, Lang, Bins) load synchronously. Non-critical modules (Apps, Tools, Registry, Homepage) load in background.

Definition at line 16 of file class.moduleloader.php.

Member Function Documentation

isLoaded()

isLoaded ( $module )

static

Check if a module is loaded

Parameters

string

$module

Module name

Returns

bool True if loaded, false otherwise

Definition at line 133 of file class.moduleloader.php.

    {
        return isset(self::$modules[$module]);
    }

isLoading()

isLoading ( $module )

static

Check if a module is currently loading

Parameters

string

$module

Module name

Returns

bool True if loading, false otherwise

Definition at line 144 of file class.moduleloader.php.

    {
        return isset(self::$loading[$module]);
    }

loadAsync()

loadAsync ( $module, callable $loader )

static

Queue a module for background loading (non-blocking)

Parameters

string	$module	Module name
callable	$loader	Callback that loads the module

Returns

void

Definition at line 57 of file class.moduleloader.php.

    {
        if (!isset(self::$modules[$module]) && !isset(self::$loading[$module])) {
            self::$loading[$module] = true;
            Log::debug('Queuing module for background load: ' . $module);
 
            // Try to use process for true async, fallback to direct call
            $pid = self::loadInBackground($module, $loader);
            if ($pid === false) {
                // Fallback: load immediately on main thread
                Log::debug('Background loading unavailable, loading on main thread: ' . $module);
                call_user_func($loader);
                unset(self::$loading[$module]);
            }
        }
    }

References Log\debug(), and loadInBackground().

Referenced by Root\loadAppsAsync(), Root\loadHomepageAsync(), Root\loadRegistryAsync(), and Root\loadToolsAsync().

Here is the call graph for this function:

Here is the caller graph for this function:

loadInBackground()

loadInBackground ( $module, callable $loader )

staticprivate

Attempt to load module in background process

Parameters

string	$module	Module name
callable	$loader	Loader callback

Returns

int|false Process ID if successful, false otherwise

Definition at line 81 of file class.moduleloader.php.

    {
        // For simplicity, we'll use direct loading since PHP doesn't have true async
        // In a production system, you'd use Process Control (pcntl) or threading
        // But for Windows/CLI safety, we'll just defer the actual initialization
        call_user_func($loader);
        unset(self::$loading[$module]);
        return true;
    }

Referenced by loadAsync().

Here is the caller graph for this function:

loadSync()

loadSync ( $module, callable $loader )

static

Load a module synchronously (blocking)

Parameters

string	$module	Module name
callable	$loader	Callback that loads the module

Returns

void

Definition at line 40 of file class.moduleloader.php.

    {
        if (!isset(self::$modules[$module])) {
            self::$loading[$module] = true;
            Log::debug('Loading module: ' . $module . ' (synchronous)');
            call_user_func($loader);
            unset(self::$loading[$module]);
        }
    }

References Log\debug().

Here is the call graph for this function:

markLoaded()

markLoaded ( $module )

static

Mark a module as loaded

Parameters

string

$module

Module name

Returns

void

Definition at line 121 of file class.moduleloader.php.

    {
        self::$modules[$module] = true;
        unset(self::$loading[$module]);
    }

waitForModule()

waitForModule ( $module, $timeout = 5000 )

static

Wait for a module to finish loading (blocking) Used when code needs a module that may be loading asynchronously

Parameters

string	$module	Module name
int	$timeout	Maximum wait time in milliseconds

Returns

bool True if module loaded, false if timeout

Definition at line 99 of file class.moduleloader.php.

    {
        $startTime = microtime(true);
        $maxWait = $timeout / 1000; // Convert to seconds
 
        while (isset(self::$loading[$module])) {
            if ((microtime(true) - $startTime) > $maxWait) {
                Log::error('Timeout waiting for module: ' . $module);
                return false;
            }
            usleep(10000); // Sleep 10ms before checking again
        }
 
        return true;
    }

References Log\error().

Referenced by Root\ensureModuleLoaded().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$loading

$loading = array()

staticprivate

Definition at line 19 of file class.moduleloader.php.

$maxWaitTime

$maxWaitTime = 5000

staticprivate

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

$modules

$modules = array()

staticprivate

Definition at line 18 of file class.moduleloader.php.

APPS

const APPS = 'apps'

Definition at line 28 of file class.moduleloader.php.

Referenced by Root\loadAppsAsync(), and Root\loadAppsFiber().

BINS

const BINS = 'bins'

Definition at line 26 of file class.moduleloader.php.

CONFIG

const CONFIG = 'config'

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

CORE

const CORE = 'core'

Definition at line 22 of file class.moduleloader.php.

HOMEPAGE

const HOMEPAGE = 'homepage'

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

Referenced by Root\loadHomepageAsync(), and Root\loadHomepageFiber().

LANG

const LANG = 'lang'

Definition at line 24 of file class.moduleloader.php.

OPENSSL

const OPENSSL = 'openssl'

Definition at line 25 of file class.moduleloader.php.

REGISTRY

const REGISTRY = 'registry'

Definition at line 30 of file class.moduleloader.php.

Referenced by Root\loadRegistryAsync(), and Root\loadRegistryFiber().

TOOLS

const TOOLS = 'tools'

Definition at line 27 of file class.moduleloader.php.

Referenced by Root\loadToolsAsync(), and Root\loadToolsFiber().

WINBINDER

const WINBINDER = 'winbinder'

Definition at line 29 of file class.moduleloader.php.

---

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

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