Skip to content

App

Type
Class
Namespace
craft\helpers
Inherits
craft\helpers\App
Since
3.0.0

App helper.

View source

Public Methods

MethodDescription
assetManagerConfig()Returns the assetManager component config for web requests.
backtrace()Returns the backtrace as a string (omitting the final frame where this method was called).
cacheConfig()Returns the cache component config.
checkForValidIconv()Returns whether the server has a valid version of the iconv extension installed.
createFormattingLocale()Creates a locale object that should be used for date and number formatting.
dbConfig()Returns the db component config.
dbMutexConfig()Returns a database-based mutex driver config.
defaultLogTargets()Returns the default log targets.
editionHandle()Returns the handle of the given Craft edition.
editionIdByHandle()Returns the ID of a Craft edition by its handle.
editionName()Returns the name of the given Craft edition.
editions()Returns an array of all known Craft editions’ IDs.
env()Returns an environment variable, checking for it in $_SERVER and calling getenv() as a fallback.
extensionVersion()Returns a PHP extension version, without the distribution info.
humanizeClass()Returns a humanized class name.
isEphemeral()Returns whether Craft is running on an environment with ephemeral storage.
isNitro()Returns whether Craft is running within Nitro v1.
isPathAllowed()Returns whether the given path is within PHP’s open_basedir setting.
isValidEdition()Returns whether an edition is valid.
licenseKey()
logConfig()Returns the log component config.
mailSettings()Returns the system email settings.
mailerConfig()Returns the mailer component config.
maxPowerCaptain()Sets PHP’s memory limit to the maximum specified by the config3:phpMaxMemoryLimit config setting, and gives the script an unlimited amount of time to execute.
mutexConfig()Returns a file-based mutex driver config.
normalizePhpPaths()Normalizes a PHP path setting to an array of paths
normalizeVersion()Removes distribution info from a version
parseBooleanEnv()Checks if a string references an environment variable ($VARIABLE_NAME) and returns the referenced boolean value, or null if a boolean value can’t be determined.
parseEnv()Checks if a string references an environment variable ($VARIABLE_NAME) and/or an alias (@aliasName), and returns the referenced value.
phpConfigValueAsBool()Retrieves a bool PHP config setting and normalizes it to an actual bool.
phpConfigValueAsPaths()Retrieves a file path PHP config setting and normalizes it to an array of paths.
phpConfigValueInBytes()Retrieves a disk size PHP config setting and normalizes it into bytes.
phpExecutable()Returns the path to a PHP executable which should be used by sub processes.
phpSizeToBytes()Normalizes a PHP file size into bytes.
phpVersion()Returns the PHP version, without the distribution info.
projectConfigConfig()Returns the projectConfig component config.
sessionConfig()Returns the session component config for web requests.
supportsIdn()Returns whether the server supports IDNA ASCII strings.
testIniSet()Tests whether ini_set() works.
userConfig()Returns the user component config for web requests.
viewConfig()Returns the view component config.
webRequestConfig()Returns the request component config for web requests.
webResponseConfig()Returns the response component config for web requests.

assetManagerConfig()

Since
3.0.18

Returns the assetManager component config for web requests.

View source

Returns

array

backtrace()

Since
3.0.13

Returns the backtrace as a string (omitting the final frame where this method was called).

View source

Arguments

  • $limit (integer) – The max number of stack frames to be included (0 means no limit)

Returns

string

cacheConfig()

Since
3.0.18

Returns the cache component config.

View source

Returns

array

checkForValidIconv()

Returns whether the server has a valid version of the iconv extension installed.

View source

Returns

boolean

createFormattingLocale()

Since
3.6.0

Creates a locale object that should be used for date and number formatting.

View source

Returns

craft\i18n\Locale

dbConfig()

Since
3.0.18

Returns the db component config.

View source

Arguments

Returns

array

dbMutexConfig()

DEPRECATED

Deprecated in 3.7.30. Database-based mutex locking is no longer recommended.

Since
3.5.18

Returns a database-based mutex driver config.

View source

Returns

array

defaultLogTargets()

Since
3.6.14

Returns the default log targets.

View source

Returns

yii\log\Target

editionHandle()

Since
3.1.0

Returns the handle of the given Craft edition.

View source

Arguments

  • $edition (integer) – An edition’s ID.

Returns

string – The edition’s name.

editionIdByHandle()

Since
3.1.0

Returns the ID of a Craft edition by its handle.

View source

Arguments

  • $handle (string) – An edition’s handle

Returns

integer – The edition’s ID

Throws

editionName()

Returns the name of the given Craft edition.

View source

Arguments

  • $edition (integer) – An edition’s ID.

Returns

string – The edition’s name.

editions()

Returns an array of all known Craft editions’ IDs.

View source

Returns

array – All the known Craft editions’ IDs.

env()

Since
3.4.18

Returns an environment variable, checking for it in $_SERVER and calling getenv() as a fallback.

View source

Arguments

  • $name (string) – The environment variable name

Returns

string, array, false – The environment variable value

extensionVersion()

Returns a PHP extension version, without the distribution info.

View source

Arguments

  • $name (string) – The extension name

Returns

string

humanizeClass()

Returns a humanized class name.

View source

Arguments

Returns

string

isEphemeral()

Since
3.4.0

Returns whether Craft is running on an environment with ephemeral storage.

View source

Returns

boolean

isNitro()

DEPRECATED

Deprecated in 3.7.9.

Since
3.4.19

Returns whether Craft is running within Nitro v1.

View source

Returns

boolean

isPathAllowed()

Since
3.7.34

Returns whether the given path is within PHP’s open_basedir setting.

View source

Arguments

Returns

boolean

isValidEdition()

Returns whether an edition is valid.

View source

Arguments

  • $edition (mixed) – An edition’s ID (or is it?)

Returns

boolean – Whether $edition is a valid edition ID.

licenseKey()

View source

Returns

string, null

logConfig()

DEPRECATED

Deprecated in 3.6.0. Override components.log.targets instead

Since
3.0.18

Returns the log component config.

View source

Returns

array, null

mailSettings()

Since
3.1.0

Returns the system email settings.

View source

Returns

craft\models\MailSettings

mailerConfig()

Since
3.0.18

Returns the mailer component config.

View source

Arguments

Returns

array{class: class-string<\craft\mail\Mailer>}

maxPowerCaptain()

Sets PHP’s memory limit to the maximum specified by the config3:phpMaxMemoryLimit config setting, and gives the script an unlimited amount of time to execute.

View source

mutexConfig()

Since
3.0.18

Returns a file-based mutex driver config.

TIP

If you were calling this to override the yii\mutex\FileMutex::$isWindows property, note that overriding the mutex component may no longer be necessary, as Craft no longer uses a mutex when Dev Mode is enabled.

View source

Returns

array

normalizePhpPaths()

Since
3.7.34

Normalizes a PHP path setting to an array of paths

View source

Arguments

  • $value (string) – The PHP path setting value

Returns

string[] – The normalized paths

normalizeVersion()

Removes distribution info from a version

View source

Arguments

Returns

string

parseBooleanEnv()

Since
3.7.29

Checks if a string references an environment variable ($VARIABLE_NAME) and returns the referenced boolean value, or null if a boolean value can’t be determined.

View source

Arguments

  • $value (mixed)

Returns

boolean, null


Example

php
$status = App::parseBooleanEnv('$SYSTEM_STATUS') ?? false;

parseEnv()

Since
3.7.29

Checks if a string references an environment variable ($VARIABLE_NAME) and/or an alias (@aliasName), and returns the referenced value.

If the string references an environment variable with a value of true or false, a boolean value will be returned.

View source

Arguments

Returns

string, boolean, null – The parsed value, or the original value if it didn’t reference an environment variable and/or alias.


Example

php
$value1 = App::parseEnv('$SMTP_PASSWORD');
$value2 = App::parseEnv('@webroot');

phpConfigValueAsBool()

Retrieves a bool PHP config setting and normalizes it to an actual bool.

View source

Arguments

  • $var (string) – The PHP config setting to retrieve.

Returns

boolean – Whether it is set to the php.ini equivalent of true.

phpConfigValueAsPaths()

Since
3.7.34

Retrieves a file path PHP config setting and normalizes it to an array of paths.

View source

Arguments

  • $var (string) – The PHP config setting to retrieve

Returns

string[] – The normalized paths

phpConfigValueInBytes()

Since
3.0.38

Retrieves a disk size PHP config setting and normalizes it into bytes.

View source

Arguments

  • $var (string) – The PHP config setting to retrieve.

Returns

integer, float – The value normalized into bytes.

phpExecutable()

Since
3.9.4

Returns the path to a PHP executable which should be used by sub processes.

View source

Returns

string, null – The PHP executable path, or null if it can’t be determined.

phpSizeToBytes()

Since
3.6.0

Normalizes a PHP file size into bytes.

View source

Arguments

  • $value (string) – The file size expressed in PHP config value notation

Returns

integer, float – The value normalized into bytes.

phpVersion()

Returns the PHP version, without the distribution info.

View source

Returns

string

projectConfigConfig()

Returns the projectConfig component config.

View source

sessionConfig()

Since
3.0.18

Returns the session component config for web requests.

View source

Returns

array

supportsIdn()

Since
3.7.9

Returns whether the server supports IDNA ASCII strings.

View source

Returns

boolean

testIniSet()

Since
3.0.40

Tests whether ini_set() works.

View source

Returns

boolean

userConfig()

Since
3.0.18

Returns the user component config for web requests.

View source

Returns

array

viewConfig()

Since
3.0.18

Returns the view component config.

View source

Returns

array

webRequestConfig()

Since
3.0.18

Returns the request component config for web requests.

View source

Returns

array

webResponseConfig()

Since
3.3.0

Returns the response component config for web requests.

View source

Returns

array