Documentation

Application extends AbstractApplication
in package
implements ArrayAccess

Application class

Tags
category

Pop

author

Nick Sagona, III dev@nolainteractive.com

copyright

Copyright (c) 2009-2024 NOLA Interactive, LLC. (http://www.nolainteractive.com)

license

http://www.popphp.org/license New BSD License

version
4.2.0

Table of Contents

Interfaces

ArrayAccess

Properties

$config  : mixed
Application config
$autoloader  : mixed
Autoloader
$config  : mixed
Application config
$events  : Manager|null
Event manager
$modules  : Manager|null
Module manager
$name  : string|null
Name
$router  : Router|null
Application router
$services  : Locator|null
Service locator
$version  : string|null
Version

Methods

__construct()  : mixed
Constructor
__get()  : mixed
Get a pre-designated value from the application object
__isset()  : bool
Determine if a pre-designated value in the application object exists
__set()  : void
Set a pre-designated value in the application object
__unset()  : void
Unset a pre-designated value in the application object
addConfigValue()  : AbstractApplication
Add new value to config
addRoute()  : static
Add a route
addRoutes()  : static
Add routes
autoloader()  : mixed
Get the autoloader object
bootstrap()  : static
Bootstrap the application, creating the required objects if they haven't been created yet and registering with the autoloader, adding routes, services and events
config()  : mixed
Access application config
deleteConfigValue()  : AbstractApplication
Replace existing value in config
env()  : mixed
Get environment value
environment()  : string|null|bool
Get application environment
events()  : Manager
Get the event manager
getName()  : string
Get name
getService()  : mixed
Get a service
getVersion()  : string
Get version
hasName()  : bool
Determine if the name is set
hasVersion()  : bool
Determine if version has been set
init()  : static
Initialize the application
isDev()  : bool
Check if application environment is dev
isDown()  : bool
Check if application is in maintenance mode
isLocal()  : bool
Check if application environment is local
isProduction()  : bool
Check if application environment is production
isRegistered()  : bool
Determine whether a module is registered with the application object
isStaging()  : bool
Check if application environment is staging
isTesting()  : bool
Check if application environment is testing
isUp()  : bool
Check if application is in not maintenance mode
load()  : AbstractApplication
Optional method that can be used to load custom operations/configurations for an application to run
mergeConfig()  : AbstractApplication
Merge new or altered config values with the existing config values
module()  : ModuleInterface|null
Access a module object
modules()  : Manager
Access all application module configs
name()  : string|null
Get application name (alias method)
off()  : static
Detach an event. Default hook-points are:
offsetExists()  : bool
Determine if a pre-designated value in the application object exists
offsetGet()  : mixed
Get a pre-designated value from the application object
offsetSet()  : void
Set a pre-designated value in the application object
offsetUnset()  : void
Unset a pre-designated value in the application object
on()  : static
Attach an event. Default hook-points are:
register()  : static
Register a module with the module manager object
registerAutoloader()  : static
Register the autoloader object with the application
registerConfig()  : AbstractApplication
Register a new configuration with the application
registerEvents()  : static
Register a new event manager object with the application
registerModules()  : static
Register a new module manager object with the application
registerRouter()  : static
Register a new router object with the application
registerServices()  : static
Register a new service locator object with the application
removeService()  : static
Remove a service
router()  : Router
Access the application router
run()  : void
Run the application
services()  : Locator
Get the service locator
setName()  : static
Set name
setService()  : static
Set a service
setVersion()  : static
Set version
trigger()  : static
Trigger an event
unregister()  : static
Unregister a module with the module manager object
updateConfigValue()  : AbstractApplication
Update existing value in config
url()  : string|null
Get application URL

Properties

$config

Application config

public mixed $config

mixed

$autoloader

Autoloader

protected mixed $autoloader = null

Methods

__construct()

Constructor

public __construct() : mixed

Instantiate an application object

Optional parameters are a service locator instance, a router instance, an event manager instance or a configuration object or array

__get()

Get a pre-designated value from the application object

public __get(string $name) : mixed
Parameters
$name : string

__isset()

Determine if a pre-designated value in the application object exists

public __isset(string $name) : bool
Parameters
$name : string
Return values
bool

__set()

Set a pre-designated value in the application object

public __set(string $name, mixed $value) : void
Parameters
$name : string
$value : mixed
Tags
throws
Exception

__unset()

Unset a pre-designated value in the application object

public __unset(string $name) : void
Parameters
$name : string

addRoute()

Add a route

public addRoute(string $route, mixed $controller) : static
Parameters
$route : string
$controller : mixed
Return values
static

addRoutes()

Add routes

public addRoutes(array<string|int, mixed> $routes) : static
Parameters
$routes : array<string|int, mixed>
Return values
static

autoloader()

Get the autoloader object

public autoloader() : mixed

bootstrap()

Bootstrap the application, creating the required objects if they haven't been created yet and registering with the autoloader, adding routes, services and events

public bootstrap([mixed $autoloader = null ]) : static
Parameters
$autoloader : mixed = null
Tags
throws
Exception|Exception|Exception
Return values
static

env()

Get environment value

public env(string $key[, mixed $default = null ]) : mixed
Parameters
$key : string
$default : mixed = null

environment()

Get application environment

public environment([mixed $env = null ]) : string|null|bool
Parameters
$env : mixed = null
Return values
string|null|bool

getService()

Get a service

public getService(string $name) : mixed
Parameters
$name : string
Tags
throws
Exception

hasVersion()

Determine if version has been set

public hasVersion() : bool
Return values
bool

init()

Initialize the application

public init() : static
Return values
static

isDev()

Check if application environment is dev

public isDev() : bool
Return values
bool

isDown()

Check if application is in maintenance mode

public isDown() : bool
Return values
bool

isLocal()

Check if application environment is local

public isLocal() : bool
Return values
bool

isProduction()

Check if application environment is production

public isProduction() : bool
Return values
bool

isRegistered()

Determine whether a module is registered with the application object

public isRegistered(string $name) : bool
Parameters
$name : string
Return values
bool

isStaging()

Check if application environment is staging

public isStaging() : bool
Return values
bool

isTesting()

Check if application environment is testing

public isTesting() : bool
Return values
bool

isUp()

Check if application is in not maintenance mode

public isUp() : bool
Return values
bool

name()

Get application name (alias method)

public name() : string|null
Return values
string|null

off()

Detach an event. Default hook-points are:

public off(string $name, mixed $action) : static

app.init app.route.pre app.dispatch.pre app.dispatch.post app.error

Parameters
$name : string
$action : mixed
Return values
static

offsetExists()

Determine if a pre-designated value in the application object exists

public offsetExists(mixed $offset) : bool
Parameters
$offset : mixed
Return values
bool

offsetGet()

Get a pre-designated value from the application object

public offsetGet(mixed $offset) : mixed
Parameters
$offset : mixed

offsetSet()

Set a pre-designated value in the application object

public offsetSet(mixed $offset, mixed $value) : void
Parameters
$offset : mixed
$value : mixed
Tags
throws
Exception

offsetUnset()

Unset a pre-designated value in the application object

public offsetUnset(mixed $offset) : void
Parameters
$offset : mixed

on()

Attach an event. Default hook-points are:

public on(string $name, mixed $action[, int $priority = 0 ]) : static

app.init app.route.pre app.dispatch.pre app.dispatch.post app.error

Parameters
$name : string
$action : mixed
$priority : int = 0
Return values
static

register()

Register a module with the module manager object

public register(mixed $module[, string|null $name = null ]) : static
Parameters
$module : mixed
$name : string|null = null
Tags
throws
Exception|Exception
Return values
static

registerAutoloader()

Register the autoloader object with the application

public registerAutoloader(mixed $autoloader) : static
Parameters
$autoloader : mixed
Tags
throws
Exception
Return values
static

registerEvents()

Register a new event manager object with the application

public registerEvents(Manager $events) : static
Parameters
$events : Manager
Return values
static

registerModules()

Register a new module manager object with the application

public registerModules(Manager $modules) : static
Parameters
$modules : Manager
Return values
static

registerRouter()

Register a new router object with the application

public registerRouter(Router $router) : static
Parameters
$router : Router
Return values
static

registerServices()

Register a new service locator object with the application

public registerServices(Locator $services) : static
Parameters
$services : Locator
Return values
static

removeService()

Remove a service

public removeService(string $name) : static
Parameters
$name : string
Return values
static

run()

Run the application

public run([bool $exit = true ][, string|null $forceRoute = null ]) : void
Parameters
$exit : bool = true
$forceRoute : string|null = null
Tags
throws
Exception|Exception|ReflectionException

setName()

Set name

public setName(string $name) : static
Parameters
$name : string
Return values
static

setService()

Set a service

public setService(string $name, mixed $service) : static
Parameters
$name : string
$service : mixed
Tags
throws
Exception
Return values
static

setVersion()

Set version

public setVersion(string $version) : static
Parameters
$version : string
Return values
static

trigger()

Trigger an event

public trigger(string $name[, array<string|int, mixed> $args = [] ]) : static
Parameters
$name : string
$args : array<string|int, mixed> = []
Return values
static

unregister()

Unregister a module with the module manager object

public unregister(string $name) : static
Parameters
$name : string
Return values
static

url()

Get application URL

public url() : string|null
Return values
string|null

        
On this page

Search results