 |
VOOZH | about |
|
VOOZH | about |
This document describes the Application class, which serves as the central container and lifecycle manager for the Hypervel framework. The Application class extends Hyperf's dependency injection container while providing Laravel-compatible bootstrapping, service provider management, and path resolution.
For information about the bootstrapping process and service provider registration flow, see Service Providers and Bootstrapping. For configuration management details, see Configuration Management.
The Application class is the foundation of a Hypervel application. It combines dependency injection container functionality with application lifecycle management.
Sources: src/foundation/src/Application.php25-89 src/foundation/src/Contracts/Application.php1-207
The Application constructor initializes the container and establishes the base application structure:
Sources: src/foundation/src/Application.php82-95
The application registers itself as the container instance:
| Abstract Type | Concrete Instance |
|---|---|
ContainerInterface::class | $this (Application instance) |
This allows the application to be resolved from the container as the container itself.
Sources: src/foundation/src/Application.php108-111
The application registers extensive container aliases to provide flexible service resolution. This allows developers to access services through multiple abstract names.
| Service Category | Primary Abstract | Common Aliases |
|---|---|---|
| Container | Psr\Container\ContainerInterface | app, Hyperf\Di\Container, Hypervel\Container\Container |
| Config | Hyperf\Contract\ConfigInterface | config, Hypervel\Config\Contracts\Repository |
| Events | Psr\EventDispatcher\EventDispatcherInterface | events, Hypervel\Event\Contracts\Dispatcher |
| Request | Psr\Http\Message\ServerRequestInterface | request, Hyperf\HttpServer\Request |
| Response | Hypervel\Http\Contracts\ResponseContract | response, Hyperf\HttpServer\Response |
| Cache | Hypervel\Cache\Contracts\Factory | cache, Hypervel\Cache\CacheManager |
| Database | Hyperf\DbConnection\Db | db |
| View | Hypervel\View\Contracts\Factory | view |
| Router | Hypervel\Router\Router | router |
| URL Generator | Hypervel\Router\Contracts\UrlGenerator | url |
Sources: src/foundation/src/Application.php546-664
The bootstrapping process prepares the application for handling requests by loading configuration, registering providers, and initializing services.
Sources: src/foundation/src/Application.php118-129
The application tracks whether it has been bootstrapped:
Sources: src/foundation/src/Application.php44-153
The application provides hooks for executing code before or after specific bootstrappers:
| Method | Purpose | Event Name Pattern |
|---|---|---|
beforeBootstrapping() | Register callback before bootstrapper | "bootstrapping: " . $bootstrapper |
afterBootstrapping() | Register callback after bootstrapper | "bootstrapped: " . $bootstrapper |
Sources: src/foundation/src/Application.php134-145
Service providers are the primary mechanism for registering services and bootstrapping application components.
Sources: src/foundation/src/Application.php311-345
The application maintains two tracking arrays:
| Array | Purpose | Type |
|---|---|---|
$serviceProviders | Stores provider instances | array<string, ServiceProvider> |
$loadedProviders | Tracks loaded provider class names | array<string, bool> |
Sources: src/foundation/src/Application.php66-385
Sources: src/foundation/src/Application.php370-373
The boot process activates all registered service providers and executes boot callbacks.
Sources: src/foundation/src/Application.php398-416
Each service provider is booted individually with its own callback lifecycle:
Sources: src/foundation/src/Application.php421-430
The application supports callbacks at two boot lifecycle points:
| Callback Type | Registration Method | Execution Timing |
|---|---|---|
| Booting | booting(callable $callback) | Before any provider boots |
| Booted | booted(callable $callback) | After all providers boot |
Note: If a booted callback is registered after the application has already booted, it executes immediately.
Sources: src/foundation/src/Application.php435-466
The application provides convenient methods for resolving paths to standard application directories.
| Method | Default Directory | Configurable? | Example Usage |
|---|---|---|---|
basePath() | / | Yes (constructor) | $app->basePath('bootstrap') |
path() | app/ | No | $app->path('Models') |
configPath() | config/ | No | $app->configPath('app.php') |
databasePath() | database/ | No | $app->databasePath('migrations') |
langPath() | lang/ | No | $app->langPath('en') |
publicPath() | public/ | No | $app->publicPath('index.php') |
resourcePath() | resources/ | No | $app->resourcePath('views') |
viewPath() | resources/views | Yes (config) | $app->viewPath('layouts') |
storagePath() | storage/ | No | $app->storagePath('logs') |
Sources: src/foundation/src/Application.php160-244
The viewPath() method is unique in that it reads from configuration:
Sources: src/foundation/src/Application.php228-236
All path methods use the joinPaths() helper for cross-platform path concatenation:
Sources: src/foundation/src/Application.php249-252
The application provides methods to detect and check the current environment.
Sources: src/foundation/src/Application.php259-306
| Method | Purpose | Typical Return Value |
|---|---|---|
environment() | Get current environment | "local", "production", "testing" |
environment('local', 'staging') | Check if in local or staging | true or false |
isLocal() | Check if in local environment | true or false |
isProduction() | Check if in production | true or false |
runningUnitTests() | Check if environment is testing | true or false |
hasDebugModeEnabled() | Check debug mode | true or false |
Sources: src/foundation/src/Application.php259-306
The application delegates locale management to the translator service while providing convenient access methods.
Sources: src/foundation/src/Application.php504-541
| Method | Purpose | Related Event |
|---|---|---|
getLocale() | Get current locale | None |
currentLocale() | Alias for getLocale() | None |
getFallbackLocale() | Get fallback locale | None |
isLocale(string $locale) | Check if locale matches | None |
setLocale(string $locale) | Set current locale | LocaleUpdated |
Sources: src/foundation/src/Application.php504-541
The application provides version information through a constant:
Sources: src/foundation/src/Application.php34
The abort() method provides a convenient way to throw HTTP exceptions:
Sources: src/foundation/src/Application.php474-481
The application can detect the application namespace from composer.json:
Sources: src/foundation/src/Application.php671-687
Refresh this wiki