Application
class Application extends Container implements Application, CachesConfiguration, CachesRoutes
Traits
Constants
| protected RESOLUTION_STATE_CONTEXT_KEY |
Context key for coroutine-local resolution state. |
| protected MAX_RESOLUTION_DEPTH |
Maximum resolution depth before assuming a circular dependency. Safety net for indirect cycles (e.g., through interfaces) where the abstract names differ from the concretes pushed by build(), making the direct in_array check insufficient. |
| protected SCOPED_CONTEXT_PREFIX |
Context key prefix for coroutine-local scoped instances. |
| VERSION |
The Hypervel framework version. |
Properties
| static protected Container|null | $instance | The current globally available container (if any). |
from Container |
| protected bool[] | $resolved | An array of the types that have been resolved. |
from Container |
| protected array[] | $bindings | The container's bindings. |
from Container |
| protected Closure[] | $methodBindings | The container's method bindings. |
from Container |
| protected array<string, mixed> | $instances | The container's shared instances. |
from Container |
| protected object[] | $autoSingletons | Auto-singletoned instances for unbound concrete classes. |
from Container |
| protected SharedResolution> | $sharedResolutions | Cacheable first resolutions currently owned by a coroutine. |
from Container |
| protected array<int, int> | $sharedResolutionWaits | Container waits keyed by the waiting coroutine ID. |
from Container |
| protected array<string, true> | $scopedInstances | The abstract names registered as scoped bindings. |
from Container |
| protected string[] | $aliases | The registered type aliases. |
from Container |
| protected array[] | $abstractAliases | The registered aliases keyed by the abstract name. |
from Container |
| protected array[] | $extenders | The extension closures for services. |
from Container |
| protected array[] | $tags | All of the registered tags. |
from Container |
| array[] | $contextual | The contextual binding map. |
from Container |
| array[] | $contextualAttributes | The contextual attribute handlers. |
from Container |
| protected array<class-string, true> | $checkedForAttributeBindings | Whether an abstract class has already had its attributes checked for bindings. |
from Container |
| protected array<class-string, null|"scoped"|"singleton"> | $checkedForSingletonOrScopedAttributes | Whether a class has already been checked for Singleton or Scoped attributes. |
from Container |
| protected array[] | $reboundCallbacks | All of the registered rebound callbacks. |
from Container |
| protected Closure[] | $globalBeforeResolvingCallbacks | All of the global before resolving callbacks. |
from Container |
| protected Closure[] | $globalResolvingCallbacks | All of the global resolving callbacks. |
from Container |
| protected Closure[] | $globalAfterResolvingCallbacks | All of the global after resolving callbacks. |
from Container |
| protected array[] | $beforeResolvingCallbacks | All of the before resolving callbacks by class type. |
from Container |
| protected array[] | $resolvingCallbacks | All of the resolving callbacks by class type. |
from Container |
| protected array[] | $afterResolvingCallbacks | All of the after resolving callbacks by class type. |
from Container |
| protected Closure>> | $afterResolvingAttributeCallbacks | All of the after resolving attribute callbacks by class type. |
from Container |
| protected null|(callable(array<int, string>|string): bool|string) | $environmentResolver | The callback used to determine the container's environment. |
from Container |
| static protected BuildRecipe> | $buildRecipes | Cache of computed build recipes. |
from Container |
| static protected array | $macros | The registered string macros. |
from Macroable |
| protected string|null | $basePath | The base path for the Hypervel installation. |
|
| protected string | $bootstrapPath | The path to the bootstrap directory. |
|
| protected string|null | $storagePath | The custom storage path defined by the developer. |
|
| protected string|null | $appPath | The custom application "app" path defined by the developer. |
|
| protected string|null | $configPath | The custom configuration path defined by the developer. |
|
| protected string|null | $databasePath | The custom database path defined by the developer. |
|
| protected string|null | $langPath | The custom language file path defined by the developer. |
|
| protected string|null | $publicPath | The custom public path defined by the developer. |
|
| protected string|null | $environmentPath | The custom environment path defined by the developer. |
|
| protected string|null | $environmentFile | The environment file to load during bootstrapping. |
|
| protected string[] | $absoluteCachePathPrefixes | The prefixes that indicate an absolute cache path. |
|
| protected bool | $mergeFrameworkConfiguration | Indicates if the framework's base configuration should be merged. |
|
| static protected ApplicationBuilder> | $applicationBuilder | The application builder class. |
|
| protected bool | $hasBeenBootstrapped | Indicates if the application has been bootstrapped before. |
|
| protected bool|null | $isRunningInConsole | Indicates if the application is running in the console. |
|
| protected bool | $booted | Indicates if the application has "booted". |
|
| protected callable[] | $bootingCallbacks | The array of booting callbacks. |
|
| protected callable[] | $bootedCallbacks | The array of booted callbacks. |
|
| protected array<callable|string> | $terminatingCallbacks | The array of terminating callbacks. |
|
| protected callable[] | $registeredCallbacks | The array of registered callbacks. |
|
| protected ServiceProvider> | $serviceProviders | All of the registered service providers. |
|
| protected array | $loadedProviders | The names of the loaded service providers. |
|
| protected string|null | $namespace | The application namespace. |
Methods
Get the class name of the first parameter of the given Closure.
Get the class names of the first parameter of the given Closure, including union types.
Get the class names / types of the parameters of the given Closure.
Get the class names / types of the return type of the given Closure.
Define a contextual binding based on an attribute.
Determine if the given abstract type has been bound.
Determine if the given abstract type has been resolved.
Determine if a given type has an explicit shared lifetime.
Determine if a scoped binding has already been resolved in this coroutine.
Determine if a ReflectionClass has scoping attributes applied.
Register a binding with the container.
Register one binding and its lifecycle.
Get the Closure to be used when building a type.
Determine if the container has a method binding.
Bind a callback to resolve with Container::call.
Get the method to be bound in class@method format.
Get the method binding for the given method.
Add a contextual binding to the container.
Register a binding if it hasn't already been registered.
Register a shared binding in the container.
Register a shared binding if it hasn't already been registered.
Register a scoped binding in the container.
Register a scoped binding if it hasn't already been registered.
Register a binding with the container based on the given Closure's return types.
Register an existing instance as shared in the container.
Remove an alias from the contextual binding alias cache.
Assign a set of tags to a given binding.
Refresh an instance on the given target and method.
Fire the "rebound" callbacks for the given abstract type.
Get the rebound callbacks for a given type.
Wrap the given closure such that its dependencies will be injected when executed.
Call the given Closure / class@method and inject its dependencies.
Get the class name for the given callback, if one can be determined.
Get a closure to resolve the given type from the container.
An alias function name for make().
Resolve the given type from the container.
Resolve the given type with a transient implicit lifetime.
Resolve the given type from the container.
Determine whether this miss can publish a worker-shared instance.
Wait for a shared resolution without introducing a coordinator cycle.
Determine whether the resolution owner is an ancestor of a coroutine.
Determine whether adding a container wait edge would close a cycle.
Get the concrete binding for an abstract from the BindWhen or Bind attributes.
Resolve the concrete from the Bind and BindWhen attributes in declaration order.
Get the contextual concrete binding for the given abstract.
Get the resolution state for the current coroutine.
Get or create the mutable resolution state for the current coroutine.
Get the current build stack without creating resolution state.
Find the concrete binding for the given abstract in the contextual binding array.
Determine if the given concrete is buildable.
Get the cached build recipe for the given concrete class.
Compute the build recipe for the given concrete class.
Instantiate a concrete instance with the given parameter overrides.
Build a concrete as part of container resolution.
Instantiate a concrete instance of the given self building type.
Resolve all constructor parameters using cached recipe metadata.
Resolve a class based variadic dependency from the container.
Resolve a dependency based on an attribute.
Throw an exception that the concrete is not instantiable.
Register a new before resolving callback for all types.
Register a new resolving callback.
Register a new after resolving callback for all types.
Register a new after resolving attribute callback for all types.
Fire all of the before resolving callbacks.
Fire an array of callbacks with an object.
Fire all of the resolving callbacks.
Fire all of the after resolving callbacks.
Fire all of the after resolving attribute callbacks.
Fire all callbacks that match the given abstract or object type.
Fire an array of callbacks with an object.
Get the class name or closure object ID the container is currently resolving.
Remove all of the extender callbacks for a given type.
Drop all of the stale instances and aliases.
Forget every cached instance for an abstract without changing its lifecycle.
Remove a resolved instance from the instance cache.
Set the callback which determines the current container environment.
Determine the environment for the container.
Flush the container of all bindings and resolved instances.
Flush all static state.
Mix another object into the class.
Dynamically handle calls to the class.
Dynamically handle calls to the class.
No description
Check that the runtime environment is properly configured.
Configure and create a new application builder instance.
Infer the application's base directory from the environment.
Get the version number of the application.
Register the basic bindings into the container.
Register all of the base service providers.
Run the given array of bootstrap classes.
Register a callback to run before a bootstrapper.
Register a callback to run after a bootstrapper.
Register a callback to run after loading the environment.
Determine if the application has been bootstrapped before.
Set the base path for the application.
Bind all of the application paths in the container.
Get the path to the application "app" directory.
Set the application directory.
Get the base path of the Hypervel installation.
Get the path to the bootstrap directory.
Set the bootstrap file directory.
Get the path to the service provider list in the bootstrap directory.
Get the path to the application configuration files.
Set the configuration directory.
Get the path to the database directory.
Set the database directory.
Get the path to the language files.
Set the language file directory.
Get the path to the public directory.
Set the public / web directory.
Get the path to the resources directory.
Get the path to the views directory.
Get the path to the storage directory.
Set the storage directory.
Get the path to the environment file directory.
Set the directory for the environment file.
Set the environment file to be loaded during bootstrapping.
Get the environment file the application is using.
Get the fully-qualified path to the environment file.
Determine if the application configuration is cached.
Get the path to the configuration cache file.
Get the path to the cached packages.php file.
Determine if the application routes are cached.
Get the path to the routes cache file.
Determine if the application events are cached.
Get the path to the events cache file.
Normalize a relative or absolute path to a cache file.
Add new prefix to list of absolute path prefixes.
Join the given paths together.
Get or check the current application environment.
Determine if the application is in the local environment.
Determine if the application is in the production environment.
Determine if the application is running in the console.
Determine if the application is running any of the given console commands.
Set whether the application is running in the console.
Determine if the application is running unit tests.
Determine if the application is running with debug mode enabled.
Get an instance of the maintenance mode manager implementation.
Determine if the application is currently down for maintenance.
Handle the incoming Artisan command.
Determine if the framework's base configuration should be merged.
Indicate that the framework's base configuration should not be merged.
Determine if middleware has been disabled for the application.
Register a new registered listener.
Register all of the configured providers.
Discover service providers from installed composer packages.
Sort providers by their priority property in descending order.
Register a service provider with the application.
Get the registered service provider instance if it exists.
Get the registered service provider instances if any exist.
Resolve a service provider instance from the class name.
Determine if the application has booted.
Boot the application's service providers.
Register a new boot listener.
Register a new "booted" listener.
Register a terminating callback with the application.
Terminate the application.
Call the booting callbacks for the application.
Throw an HttpException with the given data.
Get the service providers that have been loaded.
Determine if the given service provider is loaded.
Get the current application locale.
Determine if the application locale is the given locale.
Get the current application locale.
Get the current application fallback locale.
Set the current application locale.
Set the current application fallback locale.
Register the core class aliases in the container.
Get the application namespace.
Details
in
ReflectsClosures at line 26
protected string
firstClosureParameterType(Closure $closure)
Get the class name of the first parameter of the given Closure.
in
ReflectsClosures at line 49
protected array
firstClosureParameterTypes(Closure $closure)
Get the class names of the first parameter of the given Closure, including union types.
in
ReflectsClosures at line 75
protected array
closureParameterTypes(Closure $closure)
Get the class names / types of the parameters of the given Closure.
in
ReflectsClosures at line 97
protected array
closureReturnTypes(Closure $closure)
Get the class names / types of the return type of the given Closure.
in
Container at line 264
ContextualBindingBuilder
when(string|array $concrete)
Define a contextual binding.
in
Container at line 278
void
whenHasAttribute(string $attribute, Closure $handler)
Define a contextual binding based on an attribute.
in
Container at line 286
bool
bound(string $abstract)
Determine if the given abstract type has been bound.
at line 305
bool
has(string $id)
Determine if the given abstract type has been bound.
The facade system calls has() before get() to check if a service is resolvable. With auto-singleton semantics, any concrete class can be resolved, so has() must return true for existing classes.
in
Container at line 302
bool
resolved(string $abstract)
Determine if the given abstract type has been resolved.
in
Container at line 316
bool
isShared(string $abstract)
Determine if a given type is shared.
in
Container at line 338
protected bool
isExplicitlyShared(string $abstract)
Determine if a given type has an explicit shared lifetime.
in
Container at line 364
bool
isScoped(string $abstract)
Determine if a given abstract is a scoped binding.
in
Container at line 403
bool
resolvedScoped(string $abstract)
Determine if a scoped binding has already been resolved in this coroutine.
Scoped instances live in coroutine-local context, so this is false at the start of every request even for a binding resolved many times before. Callers that would only inspect an instance can use this to avoid paying for a full resolution — and the construction it implies — when nothing in the request asked for one.
Only the scoped resolution path writes this context key, so its presence already implies the binding is scoped; singletons, auto-singletons and transient bindings never produce one. An instance() registration that replaced a scoped binding also counts: it supersedes the scoped lifetime during resolution — tests swap scoped services this way — so an existing instance must be reported as resolved rather than skipped.
in
Container at line 418
protected string|null
getScopedType(ReflectionClass|string $reflection)
Determine if a ReflectionClass has scoping attributes applied.
in
Container at line 464
bool
isAlias(string $name)
Determine if a given string is an alias.
in
Container at line 479
void
bind(Closure|string $abstract, Closure|string|null $concrete = null, bool $shared = false)
Register a binding with the container.
Boot-only. Bindings persist on the worker-lifetime container; runtime use races across coroutines and changes resolution for every subsequent request.
in
Container at line 497
protected void
registerBinding(string $abstract, Closure|string|null $concrete, bool $shared, bool $scoped)
Register one binding and its lifecycle.
in
Container at line 534
protected Closure
getClosure(string $abstract, string $concrete)
Get the Closure to be used when building a type.
in
Container at line 555
bool
hasMethodBinding(string $method)
Determine if the container has a method binding.
in
Container at line 566
void
bindMethod(array|string $method, Closure $callback)
Bind a callback to resolve with Container::call.
Boot-only. Method bindings persist on the worker-lifetime container and affect every subsequent Container::call() for the bound method.
in
Container at line 574
protected string
parseBindMethod(array|string $method)
Get the method to be bound in class@method format.
in
Container at line 586
mixed
callMethodBinding(string $method, mixed $instance)
Get the method binding for the given method.
in
Container at line 598
void
addContextualBinding(string $concrete, string $abstract, mixed $implementation)
Add a contextual binding to the container.
Boot-only. Contextual bindings persist on the worker-lifetime container; runtime use races across coroutines and changes dependency resolution for every subsequent build of the concrete.
in
Container at line 609
void
bindIf(Closure|string $abstract, Closure|string|null $concrete = null, bool $shared = false)
Register a binding if it hasn't already been registered.
Boot-only. Conditional bindings mutate the worker-lifetime container for every subsequent request.
in
Container at line 634
void
singleton(Closure|string $abstract, Closure|string|null $concrete = null)
Register a shared binding in the container.
Boot-only. Singleton bindings persist on the worker-lifetime container; runtime use races across coroutines and changes shared resolution for every subsequent request.
in
Container at line 645
void
singletonIf(Closure|string $abstract, Closure|string|null $concrete = null)
Register a shared binding if it hasn't already been registered.
Boot-only. Conditional singleton bindings mutate the worker-lifetime container for every subsequent request.
in
Container at line 656
void
scoped(Closure|string $abstract, Closure|string|null $concrete = null)
Register a scoped binding in the container.
Boot-only. Scoped binding definitions persist on the worker-lifetime container; only their resolved instances are coroutine-scoped.
in
Container at line 673
void
scopedIf(Closure|string $abstract, Closure|string|null $concrete = null)
Register a scoped binding if it hasn't already been registered.
Boot-only. Conditional scoped bindings mutate the worker-lifetime container for every subsequent request.
in
Container at line 695
protected void
bindBasedOnClosureReturnTypes(Closure $abstract, Closure|string|null $concrete = null, bool $shared = false, bool $scoped = false, bool $onlyIfUnbound = false)
Register a binding with the container based on the given Closure's return types.
in
Container at line 723
void
extend(string $abstract, Closure $closure)
"Extend" an abstract type in the container.
Boot-only. The extender persists in the container's $extenders array for the worker lifetime and runs on every subsequent resolution of $abstract.
in
Container at line 767
mixed
instance(string $abstract, mixed $instance)
Register an existing instance as shared in the container.
Boot or tests only. Replaces a worker-lifetime shared instance; runtime use races across coroutines and changes the object returned to every subsequent resolver.
in
Container at line 792
protected void
removeAbstractAlias(string $searched)
Remove an alias from the contextual binding alias cache.
in
Container at line 813
void
tag(array|string $abstracts, array|string $tags)
Assign a set of tags to a given binding.
Boot-only. Tags persist on the worker-lifetime container and affect every subsequent tagged() resolution.
in
Container at line 831
iterable
tagged(string $tag)
Resolve all of the bindings for a given tag.
in
Container at line 853
void
alias(string $abstract, string $alias)
Alias a type to a different name.
Boot-only. Aliases persist on the worker-lifetime container; runtime use races across coroutines and changes resolution for every subsequent request.
in
Container at line 882
mixed
rebinding(string $abstract, Closure $callback)
Bind a new callback to an abstract's rebind event.
Boot-only. Rebinding callbacks persist on the worker-lifetime container and run whenever the abstract is rebound later in the worker.
in
Container at line 899
mixed
refresh(string $abstract, mixed $target, string $method)
Refresh an instance on the given target and method.
Boot-only. Registers a rebinding callback on the worker-lifetime container; runtime use leaks the callback across later rebindings.
in
Container at line 909
protected void
rebound(string $abstract)
Fire the "rebound" callbacks for the given abstract type.
in
Container at line 925
protected array
getReboundCallbacks(string $abstract)
Get the rebound callbacks for a given type.
in
Container at line 933
Closure
wrap(Closure $callback, array $parameters = [])
Wrap the given closure such that its dependencies will be injected when executed.
in
Container at line 945
mixed
call(callable|string $callback, array $parameters = [], string|null $defaultMethod = null)
Call the given Closure / class@method and inject its dependencies.
in
Container at line 1014
protected string|false
getClassForCallable(callable|string $callback)
Get the class name for the given callback, if one can be determined.
Closures are handled directly in call() before this method is reached, so this only needs to handle non-closure callable types.
in
Container at line 1039
Closure
factory(string $abstract)
Get a closure to resolve the given type from the container.
in
Container at line 1054
mixed
makeWith(string $abstract, array $parameters = [])
An alias function name for make().
in
Container at line 1069
mixed
make(string $abstract, array $parameters = [])
Resolve the given type from the container.
in
Container at line 1086
mixed
makeTransient(string $abstract)
Resolve the given type with a transient implicit lifetime.
Explicit lifetimes remain authoritative.
in
Container at line 1100
mixed
get(string $id)
No description
in
Container at line 1129
protected mixed
resolve(string $abstract, array $parameters = [], bool $raiseEvents = true, bool $transient = false)
Resolve the given type from the container.
in
Container at line 1385
protected bool
shouldCoordinateSharedResolution(string $abstract, mixed $concrete, bool $needsContextualBuild, bool $raiseEvents)
Determine whether this miss can publish a worker-shared instance.
in
Container at line 1412
protected mixed
awaitSharedResolution(string $abstract, SharedResolution $resolution)
Wait for a shared resolution without introducing a coordinator cycle.
in
Container at line 1442
protected bool
sharedResolutionOwnerIsAncestor(int $ownerId, int $coroutineId)
Determine whether the resolution owner is an ancestor of a coroutine.
in
Container at line 1462
protected bool
sharedResolutionWaitWouldCycle(int $waiterId, int $ownerId)
Determine whether adding a container wait edge would close a cycle.
in
Container at line 1478
protected mixed
getConcrete(string $abstract)
Get the concrete type for a given abstract.
in
Container at line 1497
protected mixed
getConcreteBindingFromAttributes(string $abstract)
Get the concrete binding for an abstract from the BindWhen or Bind attributes.
in
Container at line 1533
protected string|null
resolveConcreteFromAttributes(ReflectionClass $reflected)
Resolve the concrete from the Bind and BindWhen attributes in declaration order.
in
Container at line 1571
protected mixed
getContextualConcrete(string $abstract)
Get the contextual concrete binding for the given abstract.
in
Container at line 1596
protected ContainerResolutionState|null
getResolutionState()
Get the resolution state for the current coroutine.
in
Container at line 1606
protected ContainerResolutionState
getOrCreateResolutionState()
Get or create the mutable resolution state for the current coroutine.
in
Container at line 1623
protected array
currentBuildStack()
Get the current build stack without creating resolution state.
in
Container at line 1633
protected mixed
findInContextualBindings(string $abstract)
Find the concrete binding for the given abstract in the contextual binding array.
in
Container at line 1647
protected bool
isBuildable(mixed $concrete, string $abstract)
Determine if the given concrete is buildable.
in
Container at line 1655
protected BuildRecipe
getBuildRecipe(string $concrete)
Get the cached build recipe for the given concrete class.
in
Container at line 1667
protected BuildRecipe
computeBuildRecipe(string $concrete)
Compute the build recipe for the given concrete class.
Analyzes the class via reflection and caches the result as a BuildRecipe. This happens once per class per worker lifetime, avoiding repeated reflection on every build() call.
in
Container at line 1747
mixed
buildWith(Closure|string $concrete, array $parameters = [])
Instantiate a concrete instance with the given parameter overrides.
Bypasses all binding lookups and the auto-singleton cache, so the returned instance is always freshly constructed. Class-typed dependencies are still resolved via the container.
in
Container at line 1770
mixed
build(Closure|string $concrete)
Instantiate a concrete instance of the given type.
in
Container at line 1842
protected mixed
buildForResolution(Closure|string $concrete, ContainerResolutionState $resolutionState)
Build a concrete as part of container resolution.
in
Container at line 1869
protected mixed
buildSelfBuildingInstance(string $concrete, BuildRecipe $recipe, ContainerResolutionState $resolutionState)
Instantiate a concrete instance of the given self building type.
in
Container at line 1901
protected array
resolveRecipeParameters(BuildRecipe $recipe, ContainerResolutionState $resolutionState)
Resolve all constructor parameters using cached recipe metadata.
in
Container at line 1956
protected mixed
resolvePrimitive(ParameterRecipe $param)
Resolve a non-class hinted primitive dependency.
in
Container at line 1982
protected mixed
resolveClass(ParameterRecipe $param)
Resolve a class based dependency from the container.
in
Container at line 2012
protected mixed
resolveVariadicClass(ParameterRecipe $param)
Resolve a class based variadic dependency from the container.
in
Container at line 2030
mixed
resolveFromAttribute(ReflectionAttribute $attribute, ReflectionParameter $parameter)
Resolve a dependency based on an attribute.
in
Container at line 2052
protected never
notInstantiable(string $concrete)
Throw an exception that the concrete is not instantiable.
in
Container at line 2072
protected never
unresolvablePrimitive(ParameterRecipe $param)
Throw an exception for an unresolvable primitive.
in
Container at line 2085
void
beforeResolving(Closure|string $abstract, Closure|null $callback = null)
Register a new before resolving callback for all types.
Boot-only. The callback persists on the worker-lifetime container and runs before every matching future resolution.
in
Container at line 2104
void
resolving(Closure|string $abstract, Closure|null $callback = null)
Register a new resolving callback.
Boot-only. The callback persists on the worker-lifetime container and runs during every matching future resolution.
in
Container at line 2123
void
afterResolving(Closure|string $abstract, Closure|null $callback = null)
Register a new after resolving callback for all types.
Boot-only. The callback persists on the worker-lifetime container and runs after every matching future resolution.
in
Container at line 2142
void
afterResolvingAttribute(string $attribute, Closure $callback)
Register a new after resolving attribute callback for all types.
Boot-only. The callback persists on the worker-lifetime container and runs after every future resolution with the matching attribute.
in
Container at line 2150
protected void
fireBeforeResolvingCallbacks(string $abstract, array $parameters = [])
Fire all of the before resolving callbacks.
in
Container at line 2168
protected void
fireBeforeCallbackArray(string $abstract, array $parameters, array $callbacks)
Fire an array of callbacks with an object.
in
Container at line 2178
protected void
fireResolvingCallbacks(string $abstract, mixed $object)
Fire all of the resolving callbacks.
in
Container at line 2197
protected void
fireAfterResolvingCallbacks(string $abstract, mixed $object)
Fire all of the after resolving callbacks.
in
Container at line 2209
void
fireAfterResolvingAttributeCallbacks(array $attributes, mixed $object)
Fire all of the after resolving attribute callbacks.
in
Container at line 2241
protected void
fireCallbacksForType(string $abstract, mixed $object, array $callbacksPerType)
Fire all callbacks that match the given abstract or object type.
in
Container at line 2255
protected void
fireCallbackArray(mixed $object, array $callbacks)
Fire an array of callbacks with an object.
in
Container at line 2265
int|string|null
currentlyResolving()
Get the class name or closure object ID the container is currently resolving.
in
Container at line 2273
array
getBindings()
Get the container's bindings.
in
Container at line 2281
string
getAlias(string $abstract)
Get the alias for an abstract if available.
in
Container at line 2292
protected array
getExtenders(string $abstract)
Get the extender callbacks for a given type.
in
Container at line 2304
void
forgetExtenders(string $abstract)
Remove all of the extender callbacks for a given type.
Boot or tests only. Clears worker-lifetime extender callbacks; concurrent resolutions may diverge depending on whether they resolved before or after the removal.
in
Container at line 2312
protected void
dropStaleInstances(string $abstract)
Drop all of the stale instances and aliases.
in
Container at line 2323
protected void
forgetCachedInstances(string $abstract)
Forget every cached instance for an abstract without changing its lifecycle.
in
Container at line 2337
void
forgetInstance(string $abstract)
Remove a resolved instance from the instance cache.
Boot or tests only. Clears a worker-lifetime shared instance and current coroutine scoped instance; concurrent coroutines may still hold references that next resolution will not share.
in
Container at line 2349
void
forgetInstances()
Clear all of the instances from the container.
Boot or tests only. Clears worker-lifetime shared instances and all scoped context entries known to this container; concurrent coroutines may still hold references that next resolution will not share.
in
Container at line 2363
void
forgetScopedInstances()
Clear all of the scoped instances from the container.
Boot or tests only. Clears scoped context entries known to this container; runtime use can invalidate scoped services while a coroutine is still handling a request.
in
Container at line 2378
void
resolveEnvironmentUsing(callable|null $callback)
Set the callback which determines the current container environment.
Boot-only. The resolver persists on the worker-lifetime container and is used by every currentEnvironmentIs() call.
in
Container at line 2388
bool
currentEnvironmentIs(array|string $environments)
Determine the environment for the container.
at line 1519
void
flush()
Flush the container of all bindings and resolved instances.
in
Container at line 2426
static Container
getInstance()
Get the globally available instance of the container.
in
Container at line 2437
static Container|null
setInstance(Container|null $container = null)
Set the shared instance of the container.
Tests only. Replaces the process-wide container singleton; runtime use races across coroutines and breaks every facade/global container lookup.
at line 1542
static void
flushState()
Flush all static state.
in
Macroable at line 28
static void
macro(string $name, callable|object $macro)
Register a custom macro.
Boot-only. Macros persist in a static property for the worker lifetime and apply to every subsequent call on the macroable class.
in
Macroable at line 41
static void
mixin(object $mixin, bool $replace = true)
Mix another object into the class.
Boot-only. Delegates to macro() for each method; registered macros persist in a static property for the worker lifetime.
in
Macroable at line 57
static bool
hasMacro(string $name)
Check if macro is registered.
in
Macroable at line 68
static void
flushMacros()
Flush the existing macros.
Boot or tests only. Clears worker-wide macros; concurrent coroutines may resolve different methods depending on timing.
in
Macroable at line 78
static mixed
__callStatic(string $method, array $parameters)
Dynamically handle calls to the class.
in
Macroable at line 103
mixed
__call(string $method, array $parameters)
Dynamically handle calls to the class.
at line 183
__construct(string|null $basePath = null)
No description
at line 199
protected void
checkEnvironment()
Check that the runtime environment is properly configured.
at line 211
static ApplicationBuilder
configure(string|null $basePath = null)
Configure and create a new application builder instance.
at line 232
static string
inferBasePath()
Infer the application's base directory from the environment.
Precedence is $_ENV, $_SERVER, Env repository, then Composer. Hypervel checks $_SERVER and Env so test helpers and worker environments can provide APP_BASE_PATH without writing to $_ENV.
at line 248
string
version()
Get the version number of the application.
at line 256
protected void
registerBaseBindings()
Register the basic bindings into the container.
at line 290
protected void
registerBaseServiceProviders()
Register all of the base service providers.
at line 315
void
bootstrapWith(array $bootstrappers)
Run the given array of bootstrap classes.
at line 331
void
beforeBootstrapping(string $bootstrapper, Closure $callback)
Register a callback to run before a bootstrapper.
at line 339
void
afterBootstrapping(string $bootstrapper, Closure $callback)
Register a callback to run after a bootstrapper.
at line 347
void
afterLoadingEnvironment(Closure $callback)
Register a callback to run after loading the environment.
at line 358
bool
hasBeenBootstrapped()
Determine if the application has been bootstrapped before.
at line 371
Application
setBasePath(string $basePath)
Set the base path for the application.
Boot-only. Rebinds path instances on the singleton container; runtime use races across coroutines and breaks every concurrent path resolution.
at line 383
protected void
bindPathsInContainer()
Bind all of the application paths in the container.
at line 405
string
path(string $path = '')
Get the path to the application "app" directory.
at line 416
Application
useAppPath(string $path)
Set the application directory.
Boot-only. The configured path and its container binding are shared by every request in the worker.
at line 428
string
basePath(string $path = '')
Get the base path of the Hypervel installation.
at line 436
string
bootstrapPath(string $path = '')
Get the path to the bootstrap directory.
at line 447
Application
useBootstrapPath(string $path)
Set the bootstrap file directory.
Boot-only. The configured path and its container binding are shared by every request in the worker.
at line 459
string
getBootstrapProvidersPath()
Get the path to the service provider list in the bootstrap directory.
at line 467
string
configPath(string $path = '')
Get the path to the application configuration files.
at line 478
Application
useConfigPath(string $path)
Set the configuration directory.
Boot-only. The configured path and its container binding are shared by every request in the worker.
at line 490
string
databasePath(string $path = '')
Get the path to the database directory.
at line 501
Application
useDatabasePath(string $path)
Set the database directory.
Boot-only. The configured path and its container binding are shared by every request in the worker.
at line 513
string
langPath(string $path = '')
Get the path to the language files.
at line 524
Application
useLangPath(string $path)
Set the language file directory.
Boot-only. The configured path and its container binding are shared by every request in the worker.
at line 536
string
publicPath(string $path = '')
Get the path to the public directory.
at line 547
Application
usePublicPath(string $path)
Set the public / web directory.
Boot-only. The configured path and its container binding are shared by every request in the worker.
at line 559
string
resourcePath(string $path = '')
Get the path to the resources directory.
at line 569
string
viewPath(string $path = '')
Get the path to the views directory.
This method returns the first configured path in the array of view paths.
at line 584
string
storagePath(string $path = '')
Get the path to the storage directory.
at line 603
Application
useStoragePath(string $path)
Set the storage directory.
Boot-only. The configured path and its container binding are shared by every request in the worker.
at line 615
string|null
environmentPath()
Get the path to the environment file directory.
at line 627
Application
useEnvironmentPath(string $path)
Set the directory for the environment file.
Boot-only. The configured path is shared by every request in the worker.
at line 642
Application
loadEnvironmentFrom(string $file)
Set the environment file to be loaded during bootstrapping.
Boot-only. The configured filename is shared by every request in the worker.
at line 652
string
environmentFile()
Get the environment file the application is using.
at line 660
string
environmentFilePath()
Get the fully-qualified path to the environment file.
at line 668
bool
configurationIsCached()
Determine if the application configuration is cached.
at line 682
string
getCachedConfigPath()
Get the path to the configuration cache file.
at line 690
string
getCachedPackagesPath()
Get the path to the cached packages.php file.
at line 698
bool
routesAreCached()
Determine if the application routes are cached.
at line 710
string
getCachedRoutesPath()
Get the path to the routes cache file.
at line 718
bool
eventsAreCached()
Determine if the application events are cached.
at line 730
string
getCachedEventsPath()
Get the path to the events cache file.
at line 738
protected string
normalizeCachePath(string $key, string $default)
Normalize a relative or absolute path to a cache file.
at line 757
Application
addAbsoluteCachePathPrefix(string $prefix)
Add new prefix to list of absolute path prefixes.
Boot-only. The prefix persists on the application singleton and affects cache-path resolution for every request in the worker.
at line 767
string
joinPaths(string|null $basePath, string $path = '')
Join the given paths together.
at line 775
bool|string
environment(array|string ...$environments)
Get or check the current application environment.
at line 789
bool
isLocal()
Determine if the application is in the local environment.
at line 797
bool
isProduction()
Determine if the application is in the production environment.
at line 805
string
detectEnvironment(Closure $callback)
Detect the application's current environment.
at line 821
bool
runningInConsole()
Determine if the application is running in the console.
In Swoole, PHP_SAPI is always 'cli', so this defaults to true. The server command sets it to false before starting the HTTP server, and workers inherit that value.
at line 833
bool
runningConsoleCommand(string|array ...$commands)
Determine if the application is running any of the given console commands.
at line 853
void
setRunningInConsole(bool $runningInConsole)
Set whether the application is running in the console.
Boot-only. The flag persists on the singleton Application for the worker lifetime and is read by every runningInConsole() check across all coroutines.
at line 861
bool
runningUnitTests()
Determine if the application is running unit tests.
at line 869
bool
hasDebugModeEnabled()
Determine if the application is running with debug mode enabled.
at line 877
MaintenanceMode
maintenanceMode()
Get an instance of the maintenance mode manager implementation.
at line 885
bool
isDownForMaintenance()
Determine if the application is currently down for maintenance.
at line 895
int
handleCommand(InputInterface $input)
Handle the incoming Artisan command.
at line 912
bool
shouldMergeFrameworkConfiguration()
Determine if the framework's base configuration should be merged.
at line 925
Application
dontMergeFrameworkConfiguration()
Indicate that the framework's base configuration should not be merged.
Boot-only. The setting changes configuration bootstrap behavior for the entire worker.
at line 935
bool
shouldSkipMiddleware()
Determine if middleware has been disabled for the application.
at line 947
void
registered(callable $callback)
Register a new registered listener.
Boot-only. The callback persists in the Application's registeredCallbacks array and fires once per service provider registration during boot.
at line 960
void
registerConfiguredProviders()
Register all of the configured providers.
Providers are loaded in three tiers:
- Framework providers (Hypervel* from app.providers) — always first
- Discovered providers (from composer packages) — sorted by priority
- Application providers (non-Hypervel* from app.providers) — always last
at line 981
protected array
discoverProviders()
Discover service providers from installed composer packages.
at line 995
static protected array
sortByPriority(array $providers)
Sort providers by their priority property in descending order.
Higher priority values are loaded first. Providers with the same priority preserve their original order (stable sort).
at line 1021
ServiceProvider
register(ServiceProvider|string $provider, bool $force = false)
Register a service provider with the application.
at line 1075
ServiceProvider|null
getProvider(ServiceProvider|string $provider)
Get the registered service provider instance if it exists.
at line 1085
array
getProviders(ServiceProvider|string $provider)
Get the registered service provider instances if any exist.
at line 1095
ServiceProvider
resolveProvider(string $provider)
Resolve a service provider instance from the class name.
at line 1103
protected void
markAsRegistered(ServiceProvider $provider)
Mark the given provider as registered.
at line 1117
bool
isBooted()
Determine if the application has booted.
at line 1125
void
boot()
Boot the application's service providers.
at line 1148
protected void
bootProvider(ServiceProvider $provider)
Boot the given service provider.
at line 1166
void
booting(callable $callback)
Register a new boot listener.
Boot-only. The callback fires once during application boot; runtime use after boot stores the closure on the singleton Application with no future boot to listen for.
at line 1178
void
booted(callable $callback)
Register a new "booted" listener.
Boot-only. If the app has already booted, the callback fires immediately and is never invoked again, but remains stored on the singleton Application for the worker lifetime.
at line 1197
Application
terminating(callable|string $callback)
Register a terminating callback with the application.
Boot-only. Callbacks persist for the worker's lifetime and fire on every subsequent request — per-request use leaks the closure and anything it captures across every request the worker handles. Use defer() for per-request "after the response" cleanup.
at line 1207
void
terminate()
Terminate the application.
at line 1234
protected void
fireAppCallbacks(array $callbacks)
Call the booting callbacks for the application.
at line 1251
never
abort(int $code, string $message = '', array $headers = [])
Throw an HttpException with the given data.
at line 1265
array
getLoadedProviders()
Get the service providers that have been loaded.
at line 1273
bool
providerIsLoaded(string $provider)
Determine if the given service provider is loaded.
at line 1281
string
getLocale()
Get the current application locale.
at line 1289
bool
isLocale(string $locale)
Determine if the application locale is the given locale.
at line 1297
string
currentLocale()
Get the current application locale.
at line 1305
string
getFallbackLocale()
Get the current application fallback locale.
at line 1313
void
setLocale(string $locale)
Set the current application locale.
at line 1335
void
setFallbackLocale(string $fallbackLocale)
Set the current application fallback locale.
Boot-only. The fallback is stored on the shared translator and affects every request in the worker.
at line 1355
protected void
registerCoreContainerAliases()
Register the core class aliases in the container.
Keys are canonical string binding names (matching Laravel). Values are class/interface aliases that resolve to the same binding. When code calls make(SomeClass::class), getAlias() maps it to the string key, which finds the service provider's binding.
IMPORTANT: When a service has a string binding (via singleton/bind in a service provider), its concrete and contract classes MUST be listed here as aliases. Hypervel's container auto-singletons unbound concrete classes — if a class isn't aliased to its string key, make(Class::class) bypasses the string binding and creates a separate cached instance, resulting in two instances of the same service in the container.
at line 1554
string
getNamespace()
Get the application namespace.