Directories
APPNETOS Core infrastructure component: Directories.
Core\Directories maintains the application/context directory registry, persists registered
autoload directories, resolves class files and registers a PHP SPL autoloader. It remains an active part of
APPNETOS and works alongside Core\Files.
Directory groups
Directories are registered by type in custom and default groups. Custom
directories
are searched before defaults within each type. Duplicate registrations are avoided and missing
directories
are excluded when loading cached maps.
Two cache levels
| Level | Storage | Description |
|---|---|---|
| Persistent directory map | Core\Cache::TYPE_DIRECTORY, type ID directories |
Registered directory paths persist across requests. |
| Runtime search-directory index | PHP memory: $classSearchDirectories |
Recursively resolved search paths are reused within one runtime, keyed by application, origin, context and directory list. |
The recursively resolved search-directory index is not persisted across runtimes. This is a potential future optimization; it is distinct from the existing persistent registry cache.
Bootstrap and class discovery
Before Core\Files is available, the autoloader searches registered directories directly.
Once
Files is available, it attempts Files resolution, with direct discovery as fallback. Class names are
converted to basename-based PHP filenames for directory lookup.
Autoload type
withAutoloadType() temporarily scopes class resolution to a directory type and restores the
previous value in a finally block, even when a callback fails.
Public API Reference
Core\Directories
Class & Registry
Class:
Core\Directories
Extends:
Core\Directories\Base
use Core\Directories;
use Core\Registry;
$directories = Registry::get(Directories::class);
| Method | Description |
|---|---|
init / close() |
Initialize and shut down directory management. |
add / addCustom() |
Register standard or custom directories. |
has / get / getAll() |
Inspect registered directory groups. |
getSearchDirectories / getSearchDirectoriesByType() |
Return ordered, unique search paths. |
findClassFile() |
Find a PHP class file by name and optional type. |
autoload() |
SPL autoload callback. |
unregisterAutoloader / isAutoloaderRegistered() |
Manage or inspect SPL registration. |
withAutoloadType / setAutoloadType / getAutoloadType() |
Manage temporary or current autoload type. |