APPNETOS is under active development This website and its documentation are being prepared for public launch. Content and features may change.
Select Theme
Loading

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.

Files and Directories lookup architecture
Files and Directories lookup architecture

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.

Next Steps

Previous

Files

Explore Files

Next

HTTP & Routing

Explore HTTP & Routing