Application
class Application extends Container implements Application, HttpKernelInterface (View source)
Constants
VERSION | The Laravel framework version. |
Properties
static protected Container | $instance | The current globally available container (if any). | from Container |
protected array | $resolved | An array of the types that have been resolved. | from Container |
protected array | $bindings | The container's bindings. | from Container |
protected array | $instances | The container's shared instances. | from Container |
protected array | $aliases | The registered type aliases. | from Container |
protected array | $extenders | The extension closures for services. | from Container |
protected array | $tags | All of the registered tags. | from Container |
protected array | $buildStack | The stack of concretions currently being built. | from Container |
array | $contextual | The contextual binding map. | from Container |
protected array | $reboundCallbacks | All of the registered rebound callbacks. | from Container |
protected array | $globalResolvingCallbacks | All of the global resolving callbacks. | from Container |
protected array | $globalAfterResolvingCallbacks | All of the global after resolving callbacks. | 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 string | $basePath | The base path for the Laravel installation. | |
protected bool | $hasBeenBootstrapped | Indicates if the application has been bootstrapped before. | |
protected bool | $booted | Indicates if the application has "booted". | |
protected array | $bootingCallbacks | The array of booting callbacks. | |
protected array | $bootedCallbacks | The array of booted callbacks. | |
protected array | $terminatingCallbacks | The array of terminating callbacks. | |
protected array | $serviceProviders | All of the registered service providers. | |
protected array | $loadedProviders | The names of the loaded service providers. | |
protected array | $deferredServices | The deferred services and their providers. | |
protected callable|null | $monologConfigurator | A custom callback used to configure Monolog. | |
protected string | $databasePath | The custom database path defined by the developer. | |
protected string | $storagePath | The custom storage path defined by the developer. | |
protected string | $environmentPath | The custom environment path defined by the developer. | |
protected string | $environmentFile | The environment file to load during bootstrapping. | |
protected string | $namespace | The application namespace. |
Methods
ContextualBindingBuilder | when(string $concrete) Define a contextual binding. | from Container |
bool | bound(string $abstract) Determine if the given abstract type has been bound. | |
bool | resolved(string $abstract) Determine if the given abstract type has been resolved. | from Container |
bool | isAlias(string $name) Determine if a given string is an alias. | from Container |
void | bind(string|array $abstract, Closure|string|null $concrete = null, bool $shared = false) Register a binding with the container. | from Container |
Closure | getClosure(string $abstract, string $concrete) Get the Closure to be used when building a type. | from Container |
void | addContextualBinding(string $concrete, string $abstract, Closure|string $implementation) Add a contextual binding to the container. | from Container |
void | bindIf(string $abstract, Closure|string|null $concrete = null, bool $shared = false) Register a binding if it hasn't already been registered. | from Container |
void | singleton(string|array $abstract, Closure|string|null $concrete = null) Register a shared binding in the container. | from Container |
Closure | share(Closure $closure) Wrap a Closure such that it is shared. | from Container |
void | extend(string $abstract, Closure $closure) "Extend" an abstract type in the container. | from Container |
void | instance(string $abstract, mixed $instance) Register an existing instance as shared in the container. | from Container |
void | tag(array|string $abstracts, array|mixed $tags) Assign a set of tags to a given binding. | from Container |
array | tagged(array $tag) Resolve all of the bindings for a given tag. | from Container |
void | alias(string $abstract, string $alias) Alias a type to a different name. | from Container |
array | extractAlias(array $definition) Extract the type and alias from a given definition. | from Container |
mixed | rebinding(string $abstract, Closure $callback) Bind a new callback to an abstract's rebind event. | from Container |
mixed | refresh(string $abstract, mixed $target, string $method) Refresh an instance on the given target and method. | from Container |
void | rebound(string $abstract) Fire the "rebound" callbacks for the given abstract type. | from Container |
array | getReboundCallbacks(string $abstract) Get the rebound callbacks for a given type. | from Container |
Closure | wrap(Closure $callback, array $parameters = []) Wrap the given closure such that its dependencies will be injected when executed. | from Container |
mixed | call(callable|string $callback, array $parameters = [], string|null $defaultMethod = null) Call the given Closure / class@method and inject its dependencies. | from Container |
bool | isCallableWithAtSign(mixed $callback) Determine if the given string is in Class@method syntax. | from Container |
array | getMethodDependencies(callable|string $callback, array $parameters = []) Get all dependencies for a given method. | from Container |
ReflectionFunctionAbstract | getCallReflector(callable|string $callback) Get the proper reflection instance for the given callback. | from Container |
mixed | addDependencyForCallParameter(ReflectionParameter $parameter, array $parameters, array $dependencies) Get the dependency for the given call parameter. | from Container |
mixed | callClass(string $target, array $parameters = [], string|null $defaultMethod = null) Call a string reference to a class using Class@method syntax. | from Container |
Closure | factory(string $abstract, array $defaults = []) Get a closure to resolve the given type from the container. | from Container |
mixed | make(string $abstract, array $parameters = []) Resolve the given type from the container. | |
mixed | getConcrete(string $abstract) Get the concrete type for a given abstract. | from Container |
string|null | getContextualConcrete(string $abstract) Get the contextual concrete binding for the given abstract. | from Container |
mixed | normalize(mixed $service) Normalize the given class name by removing leading slashes. | from Container |
array | getExtenders(string $abstract) Get the extender callbacks for a given type. | from Container |
mixed | build(string $concrete, array $parameters = []) Instantiate a concrete instance of the given type. | from Container |
array | getDependencies(array $parameters, array $primitives = []) Resolve all of the dependencies from the ReflectionParameters. | from Container |
mixed | resolveNonClass(ReflectionParameter $parameter) Resolve a non-class hinted dependency. | from Container |
mixed | resolveClass(ReflectionParameter $parameter) Resolve a class based dependency from the container. | from Container |
array | keyParametersByArgument(array $dependencies, array $parameters) If extra parameters are passed by numeric ID, rekey them by argument name. | from Container |
void | resolving(string $abstract, Closure $callback = null) Register a new resolving callback. | from Container |
void | afterResolving(string $abstract, Closure $callback = null) Register a new after resolving callback for all types. | from Container |
void | resolvingCallback(Closure $callback) Register a new resolving callback by type of its first argument. | from Container |
void | afterResolvingCallback(Closure $callback) Register a new after resolving callback by type of its first argument. | from Container |
mixed | getFunctionHint(Closure $callback) Get the type hint for this closure's first argument. | from Container |
void | fireResolvingCallbacks(string $abstract, mixed $object) Fire all of the resolving callbacks. | from Container |
array | getCallbacksForType(string $abstract, object $object, array $callbacksPerType) Get all callbacks for a given type. | from Container |
void | fireCallbackArray(mixed $object, array $callbacks) Fire an array of callbacks with an object. | from Container |
bool | isShared(string $abstract) Determine if a given type is shared. | from Container |
bool | isBuildable(mixed $concrete, string $abstract) Determine if the given concrete is buildable. | from Container |
string | getAlias(string $abstract) Get the alias for an abstract if available. | from Container |
array | getBindings() Get the container's bindings. | from Container |
void | dropStaleInstances(string $abstract) Drop all of the stale instances and aliases. | from Container |
void | forgetInstance(string $abstract) Remove a resolved instance from the instance cache. | from Container |
void | forgetInstances() Clear all of the instances from the container. | from Container |
void | flush() Flush the container of all bindings and resolved instances. | |
static Container | getInstance() Set the globally available instance of the container. | from Container |
static Container | setInstance(Container $container = null) Set the shared instance of the container. | from Container |
bool | offsetExists(string $key) Determine if a given offset exists. | from Container |
mixed | offsetGet(string $key) Get the value at a given offset. | from Container |
void | offsetSet(string $key, mixed $value) Set the value at a given offset. | from Container |
void | offsetUnset(string $key) Unset the value at a given offset. | from Container |
mixed | __get(string $key) Dynamically access container services. | from Container |
void | __set(string $key, mixed $value) Dynamically set container services. | from Container |
void | __construct(string|null $basePath = null) Create a new Illuminate application instance. | |
string | version() Get the version number of the application. | |
void | registerBaseBindings() Register the basic bindings into the container. | |
void | registerBaseServiceProviders() Register all of the base service providers. | |
void | bootstrapWith(array $bootstrappers) Run the given array of bootstrap classes. | |
void | afterLoadingEnvironment(Closure $callback) Register a callback to run after loading the environment. | |
void | beforeBootstrapping(string $bootstrapper, Closure $callback) Register a callback to run before a bootstrapper. | |
void | afterBootstrapping(string $bootstrapper, Closure $callback) Register a callback to run after a bootstrapper. | |
bool | hasBeenBootstrapped() Determine if the application has been bootstrapped before. | |
$this | setBasePath(string $basePath) Set the base path for the application. | |
void | bindPathsInContainer() Bind all of the application paths in the container. | |
string | path() Get the path to the application "app" directory. | |
string | basePath() Get the base path of the Laravel installation. | |
string | bootstrapPath() Get the path to the bootstrap directory. | |
string | configPath() Get the path to the application configuration files. | |
string | databasePath() Get the path to the database directory. | |
$this | useDatabasePath(string $path) Set the database directory. | |
string | langPath() Get the path to the language files. | |
string | publicPath() Get the path to the public / web directory. | |
string | storagePath() Get the path to the storage directory. | |
$this | useStoragePath(string $path) Set the storage directory. | |
string | resourcePath() Get the path to the resources directory. | |
string | environmentPath() Get the path to the environment file directory. | |
$this | useEnvironmentPath(string $path) Set the directory for the environment file. | |
$this | loadEnvironmentFrom(string $file) Set the environment file to be loaded during bootstrapping. | |
string | environmentFile() Get the environment file the application is using. | |
string | environmentFilePath() Get the fully qualified path to the environment file. | |
string | environment() Get or check the current application environment. | |
bool | isLocal() Determine if application is in local environment. | |
string | detectEnvironment(Closure $callback) Detect the application's current environment. | |
bool | runningInConsole() Determine if we are running in the console. | |
bool | runningUnitTests() Determine if we are running unit tests. | |
void | registerConfiguredProviders() Register all of the configured providers. | |
ServiceProvider | register(ServiceProvider|string $provider, array $options = [], bool $force = false) Register a service provider with the application. | |
ServiceProvider|null | getProvider(ServiceProvider|string $provider) Get the registered service provider instance if it exists. | |
ServiceProvider | resolveProviderClass(string $provider) Resolve a service provider instance from the class name. | |
void | markAsRegistered(ServiceProvider $provider) Mark the given provider as registered. | |
void | loadDeferredProviders() Load and boot all of the remaining deferred providers. | |
void | loadDeferredProvider(string $service) Load the provider for a deferred service. | |
void | registerDeferredProvider(string $provider, string $service = null) Register a deferred provider and service. | |
bool | isBooted() Determine if the application has booted. | |
void | boot() Boot the application's service providers. | |
mixed | bootProvider(ServiceProvider $provider) Boot the given service provider. | |
void | booting(mixed $callback) Register a new boot listener. | |
void | booted(mixed $callback) Register a new "booted" listener. | |
void | fireAppCallbacks(array $callbacks) Call the booting callbacks for the application. | |
handle(Request $request, $type = self::MASTER_REQUEST, $catch = true) {@inheritdoc} | ||
bool | shouldSkipMiddleware() Determine if middleware has been disabled for the application. | |
bool | configurationIsCached() Determine if the application configuration is cached. | |
string | getCachedConfigPath() Get the path to the configuration cache file. | |
bool | routesAreCached() Determine if the application routes are cached. | |
string | getCachedRoutesPath() Get the path to the routes cache file. | |
string | getCachedCompilePath() Get the path to the cached "compiled.php" file. | |
string | getCachedServicesPath() Get the path to the cached services.php file. | |
bool | isDownForMaintenance() Determine if the application is currently down for maintenance. | |
void | abort(int $code, string $message = '', array $headers = []) Throw an HttpException with the given data. | |
$this | terminating(Closure $callback) Register a terminating callback with the application. | |
void | terminate() Terminate the application. | |
array | getLoadedProviders() Get the service providers that have been loaded. | |
array | getDeferredServices() Get the application's deferred services. | |
void | setDeferredServices(array $services) Set the application's deferred services. | |
void | addDeferredServices(array $services) Add an array of services to the application's deferred services. | |
bool | isDeferredService(string $service) Determine if the given service is a deferred service. | |
$this | configureMonologUsing(callable $callback) Define a callback to be used to configure Monolog. | |
bool | hasMonologConfigurator() Determine if the application has a custom Monolog configurator. | |
callable | getMonologConfigurator() Get the custom Monolog configurator for the application. | |
string | getLocale() Get the current application locale. | |
void | setLocale(string $locale) Set the current application locale. | |
bool | isLocale(string $locale) Determine if application locale is the given locale. | |
void | registerCoreContainerAliases() Register the core class aliases in the container. | |
string | getNamespace() Get the application namespace. |
Details
ContextualBindingBuilder when(string $concrete)
Define a contextual binding.
bool bound(string $abstract)
Determine if the given abstract type has been bound.
(Overriding Container::bound)
bool resolved(string $abstract)
Determine if the given abstract type has been resolved.
bool isAlias(string $name)
Determine if a given string is an alias.
void bind(string|array $abstract, Closure|string|null $concrete = null, bool $shared = false)
Register a binding with the container.
protected Closure getClosure(string $abstract, string $concrete)
Get the Closure to be used when building a type.
void addContextualBinding(string $concrete, string $abstract, Closure|string $implementation)
Add a contextual binding to the container.
void bindIf(string $abstract, Closure|string|null $concrete = null, bool $shared = false)
Register a binding if it hasn't already been registered.
void singleton(string|array $abstract, Closure|string|null $concrete = null)
Register a shared binding in the container.
void extend(string $abstract, Closure $closure)
"Extend" an abstract type in the container.
void instance(string $abstract, mixed $instance)
Register an existing instance as shared in the container.
void tag(array|string $abstracts, array|mixed $tags)
Assign a set of tags to a given binding.
array tagged(array $tag)
Resolve all of the bindings for a given tag.
void alias(string $abstract, string $alias)
Alias a type to a different name.
protected array extractAlias(array $definition)
Extract the type and alias from a given definition.
mixed rebinding(string $abstract, Closure $callback)
Bind a new callback to an abstract's rebind event.
mixed refresh(string $abstract, mixed $target, string $method)
Refresh an instance on the given target and method.
protected void rebound(string $abstract)
Fire the "rebound" callbacks for the given abstract type.
protected array getReboundCallbacks(string $abstract)
Get the rebound callbacks for a given type.
Closure wrap(Closure $callback, array $parameters = [])
Wrap the given closure such that its dependencies will be injected when executed.
mixed call(callable|string $callback, array $parameters = [], string|null $defaultMethod = null)
Call the given Closure / class@method and inject its dependencies.
protected bool isCallableWithAtSign(mixed $callback)
Determine if the given string is in Class@method syntax.
protected array getMethodDependencies(callable|string $callback, array $parameters = [])
Get all dependencies for a given method.
protected ReflectionFunctionAbstract getCallReflector(callable|string $callback)
Get the proper reflection instance for the given callback.
protected mixed addDependencyForCallParameter(ReflectionParameter $parameter, array $parameters, array $dependencies)
Get the dependency for the given call parameter.
protected mixed callClass(string $target, array $parameters = [], string|null $defaultMethod = null)
Call a string reference to a class using Class@method syntax.
Closure factory(string $abstract, array $defaults = [])
Get a closure to resolve the given type from the container.
mixed make(string $abstract, array $parameters = [])
Resolve the given type from the container.
(Overriding Container::make)
protected mixed getConcrete(string $abstract)
Get the concrete type for a given abstract.
protected string|null getContextualConcrete(string $abstract)
Get the contextual concrete binding for the given abstract.
protected mixed normalize(mixed $service)
Normalize the given class name by removing leading slashes.
protected array getExtenders(string $abstract)
Get the extender callbacks for a given type.
mixed build(string $concrete, array $parameters = [])
Instantiate a concrete instance of the given type.
protected array getDependencies(array $parameters, array $primitives = [])
Resolve all of the dependencies from the ReflectionParameters.
protected mixed resolveNonClass(ReflectionParameter $parameter)
Resolve a non-class hinted dependency.
protected mixed resolveClass(ReflectionParameter $parameter)
Resolve a class based dependency from the container.
protected array keyParametersByArgument(array $dependencies, array $parameters)
If extra parameters are passed by numeric ID, rekey them by argument name.
void resolving(string $abstract, Closure $callback = null)
Register a new resolving callback.
void afterResolving(string $abstract, Closure $callback = null)
Register a new after resolving callback for all types.
protected void resolvingCallback(Closure $callback)
Register a new resolving callback by type of its first argument.
protected void afterResolvingCallback(Closure $callback)
Register a new after resolving callback by type of its first argument.
protected mixed getFunctionHint(Closure $callback)
Get the type hint for this closure's first argument.
protected void fireResolvingCallbacks(string $abstract, mixed $object)
Fire all of the resolving callbacks.
protected array getCallbacksForType(string $abstract, object $object, array $callbacksPerType)
Get all callbacks for a given type.
protected void fireCallbackArray(mixed $object, array $callbacks)
Fire an array of callbacks with an object.
bool isShared(string $abstract)
Determine if a given type is shared.
protected bool isBuildable(mixed $concrete, string $abstract)
Determine if the given concrete is buildable.
string getAlias(string $abstract)
Get the alias for an abstract if available.
array getBindings()
Get the container's bindings.
protected void dropStaleInstances(string $abstract)
Drop all of the stale instances and aliases.
void forgetInstance(string $abstract)
Remove a resolved instance from the instance cache.
void forgetInstances()
Clear all of the instances from the container.
void flush()
Flush the container of all bindings and resolved instances.
static Container getInstance()
Set the globally available instance of the container.
bool offsetExists(string $key)
Determine if a given offset exists.
mixed offsetGet(string $key)
Get the value at a given offset.
void offsetSet(string $key, mixed $value)
Set the value at a given offset.
void offsetUnset(string $key)
Unset the value at a given offset.
mixed __get(string $key)
Dynamically access container services.
void __set(string $key, mixed $value)
Dynamically set container services.
void __construct(string|null $basePath = null)
Create a new Illuminate application instance.
string version()
Get the version number of the application.
protected void registerBaseBindings()
Register the basic bindings into the container.
protected void registerBaseServiceProviders()
Register all of the base service providers.
void bootstrapWith(array $bootstrappers)
Run the given array of bootstrap classes.
void afterLoadingEnvironment(Closure $callback)
Register a callback to run after loading the environment.
void beforeBootstrapping(string $bootstrapper, Closure $callback)
Register a callback to run before a bootstrapper.
void afterBootstrapping(string $bootstrapper, Closure $callback)
Register a callback to run after a bootstrapper.
bool hasBeenBootstrapped()
Determine if the application has been bootstrapped before.
$this setBasePath(string $basePath)
Set the base path for the application.
protected void bindPathsInContainer()
Bind all of the application paths in the container.
string path()
Get the path to the application "app" directory.
string basePath()
Get the base path of the Laravel installation.
string bootstrapPath()
Get the path to the bootstrap directory.
string configPath()
Get the path to the application configuration files.
string databasePath()
Get the path to the database directory.
$this useDatabasePath(string $path)
Set the database directory.
string langPath()
Get the path to the language files.
string publicPath()
Get the path to the public / web directory.
string storagePath()
Get the path to the storage directory.
$this useStoragePath(string $path)
Set the storage directory.
string resourcePath()
Get the path to the resources directory.
string environmentPath()
Get the path to the environment file directory.
$this useEnvironmentPath(string $path)
Set the directory for the environment file.
$this loadEnvironmentFrom(string $file)
Set the environment file to be loaded during bootstrapping.
string environmentFile()
Get the environment file the application is using.
string environmentFilePath()
Get the fully qualified path to the environment file.
string environment()
Get or check the current application environment.
bool isLocal()
Determine if application is in local environment.
string detectEnvironment(Closure $callback)
Detect the application's current environment.
bool runningInConsole()
Determine if we are running in the console.
bool runningUnitTests()
Determine if we are running unit tests.
void registerConfiguredProviders()
Register all of the configured providers.
ServiceProvider register(ServiceProvider|string $provider, array $options = [], bool $force = false)
Register a service provider with the application.
ServiceProvider|null getProvider(ServiceProvider|string $provider)
Get the registered service provider instance if it exists.
ServiceProvider resolveProviderClass(string $provider)
Resolve a service provider instance from the class name.
protected void markAsRegistered(ServiceProvider $provider)
Mark the given provider as registered.
void loadDeferredProviders()
Load and boot all of the remaining deferred providers.
void loadDeferredProvider(string $service)
Load the provider for a deferred service.
void registerDeferredProvider(string $provider, string $service = null)
Register a deferred provider and service.
bool isBooted()
Determine if the application has booted.
void boot()
Boot the application's service providers.
protected mixed bootProvider(ServiceProvider $provider)
Boot the given service provider.
void booting(mixed $callback)
Register a new boot listener.
void booted(mixed $callback)
Register a new "booted" listener.
protected void fireAppCallbacks(array $callbacks)
Call the booting callbacks for the application.
handle(Request $request, $type = self::MASTER_REQUEST, $catch = true)
{@inheritdoc}
bool shouldSkipMiddleware()
Determine if middleware has been disabled for the application.
bool configurationIsCached()
Determine if the application configuration is cached.
string getCachedConfigPath()
Get the path to the configuration cache file.
bool routesAreCached()
Determine if the application routes are cached.
string getCachedRoutesPath()
Get the path to the routes cache file.
string getCachedCompilePath()
Get the path to the cached "compiled.php" file.
string getCachedServicesPath()
Get the path to the cached services.php file.
bool isDownForMaintenance()
Determine if the application is currently down for maintenance.
void abort(int $code, string $message = '', array $headers = [])
Throw an HttpException with the given data.
$this terminating(Closure $callback)
Register a terminating callback with the application.
void terminate()
Terminate the application.
array getLoadedProviders()
Get the service providers that have been loaded.
array getDeferredServices()
Get the application's deferred services.
void setDeferredServices(array $services)
Set the application's deferred services.
void addDeferredServices(array $services)
Add an array of services to the application's deferred services.
bool isDeferredService(string $service)
Determine if the given service is a deferred service.
$this configureMonologUsing(callable $callback)
Define a callback to be used to configure Monolog.
bool hasMonologConfigurator()
Determine if the application has a custom Monolog configurator.
callable getMonologConfigurator()
Get the custom Monolog configurator for the application.
string getLocale()
Get the current application locale.
void setLocale(string $locale)
Set the current application locale.
bool isLocale(string $locale)
Determine if application locale is the given locale.
void registerCoreContainerAliases()
Register the core class aliases in the container.
string getNamespace()
Get the application namespace.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.3/Illuminate/Foundation/Application.html