ApplicationTrait

`announcements`

Type: craft\services\Announcements
Default value: null

The announcements service

`api`

Type: craft\services\Api
Default value: null

The API service

`assetIndexer`

Type: craft\services\AssetIndexer
Default value: null

The asset indexer service

`assetManager`

Type: craft\web\AssetManager
Default value: null

The asset manager component

`assets`

Type: craft\services\Assets
Default value: null

The assets service

`auth`

Type: craft\services\Auth
Default value: null

The user authentication service

`canTestEditions`

Type: boolean
Default value: null

Whether Craft is running on a domain that is eligible to test out the editions

`canUpgradeEdition`

Type: boolean
Default value: null

Whether Craft is eligible to be upgraded to a different edition

`categories`

Type: craft\services\Categories
Default value: null

The categories service

`composer`

Type: craft\services\Composer
Default value: null

The Composer service

`conditions`

Type: craft\services\Conditions
Default value: null

The conditions service

`config`

Type: craft\services\Config
Default value: null

The config service

`contentMigrator`

Type: craft\db\MigrationManager
Default value: null

The content migration manager

`dashboard`

Type: craft\services\Dashboard
Default value: null

The dashboard service

`db`

Type: craft\db\Connection
Default value: null

The database connection component

`db2`

Type: craft\db\Connection
Default value: null

The database connection component used for mutex locks and element bulk op records

`deprecator`

Type: craft\services\Deprecator
Default value: null

The deprecator service

`drafts`

Type: craft\services\Drafts
Default value: null

The drafts service

`edition`

Type: \craft\enums\CmsEdition
Default value: null
Since: 5.0.0

The installed Craft CMS edition.

`elementSources`

Type: craft\services\ElementSources
Default value: null

The element sources service

`elements`

Type: craft\services\Elements
Default value: null

The elements service

`entries`

Type: craft\services\Entries
Default value: null

The entries service

`env`

Type: string, null
Default value: null

The environment ID Craft is currently running in.

`fields`

Type: craft\services\Fields
Default value: null

The fields service

`formatter`

Type: craft\i18n\Formatter
Default value: null

The formatter component

`formattingLocale`

Type: craft\i18n\Locale
Default value: null

The Locale object that should be used to define the formatter

`fs`

Type: craft\services\Fs
Default value: null

The filesystems service

`gc`

Type: craft\services\Gc
Default value: null

The garbage collection service

`globals`

Type: craft\services\Globals
Default value: null

The globals service

`gql`

Type: craft\services\Gql
Default value: null

The GraphQl service

`hasWrongEdition`

Type: boolean
Default value: null

Whether Craft is running with the wrong edition

`i18n`

Type: craft\i18n\I18N
Default value: null

The internationalization (i18n) component

`imageTransforms`

Type: craft\services\ImageTransforms
Default value: null

The image transforms service

`images`

Type: craft\services\Images
Default value: null

The images service

`installedSchemaVersion`

Type: string
Default value: null

The installed schema version

`isInMaintenanceMode`

Type: boolean
Default value: null

Whether someone is currently performing a system update

`isInitialized`

Type: boolean
Default value: null

Whether Craft is fully initialized

`isInstalled`

Type: boolean
Default value: null

Whether Craft is installed

`isMultiSite`

Type: boolean
Default value: null

Whether this site has multiple sites

`isSystemLive`

Type: boolean
Default value: null

Whether the system is live

`locale`

Type: craft\i18n\Locale
Default value: null

The Locale object for the target language

`mailer`

Type: craft\mail\Mailer
Default value: null

The mailer component

`migrator`

Type: craft\db\MigrationManager
Default value: null

The application’s migration manager

`minVersionRequired`

Type: string
Default value: null

The minimum Craft build number required to update to this build.

`mutex`

Type: yii\mutex\Mutex
Default value: null

The application’s mutex service

`path`

Type: craft\services\Path
Default value: null

The path service

`pluginStore`

Type: craft\services\PluginStore
Default value: null

The plugin store service

`plugins`

Type: craft\services\Plugins
Default value: null

The plugins service

`projectConfig`

Type: craft\services\ProjectConfig
Default value: null

The project config service

`queue`

Type: yii\queue\Queue, craft\queue\QueueInterface
Default value: null

The job queue

`relations`

Type: craft\services\Relations
Default value: null

The relations service (deprecated)

`revisions`

Type: craft\services\Revisions
Default value: null

The revisions service

`routes`

Type: craft\services\Routes
Default value: null

The routes service

`schemaVersion`

Type: string
Default value: null

Craft’s schema version number.

`search`

Type: craft\services\Search
Default value: null

The search service

`security`

Type: craft\services\Security
Default value: null

The security component

`sites`

Type: craft\services\Sites
Default value: null

The sites service

`sso`

Type: craft\services\Sso
Default value: null

The SSO service

`structures`

Type: craft\services\Structures
Default value: null

The structures service

`systemMessages`

Type: craft\services\SystemMessages
Default value: null

The system email messages service

`tags`

Type: craft\services\Tags
Default value: null

The tags service

`templateCaches`

Type: craft\services\TemplateCaches
Default value: null

The template caches service

`tokens`

Type: craft\services\Tokens
Default value: null

The tokens service

`updates`

Type: craft\services\Updates
Default value: null

The updates service

`userGroups`

Type: craft\services\UserGroups
Default value: null

The user groups service

`userPermissions`

Type: craft\services\UserPermissions
Default value: null

The user permissions service

`users`

Type: craft\services\Users
Default value: null

The users service

`utilities`

Type: craft\services\Utilities
Default value: null

The utilities service

`view`

Type: craft\web\View
Default value: null

The view component

`volumes`

Type: craft\services\Volumes
Default value: null

The volumes service

`webpack`

Type: craft\services\Webpack
Default value: null

The webpack service

Public Methods

Method	Description
disableMaintenanceMode()	Disables Maintenance Mode.
enableMaintenanceMode()	Enables Maintenance Mode.
getAddresses()	Returns the addresses service.
getAnnouncements()	Returns the announcements service.
getApi()	Returns the API service.
getAssetIndexer()	Returns the asset indexing service.
getAssetManager()	Returns the asset manager component.
getAssets()	Returns the assets service.
getAuth()	Returns the user authentication service.
getCanUpgradeEdition()	Returns whether Craft is eligible to be upgraded to a different edition.
getCategories()	Returns the categories service.
getComposer()	Returns the Composer service.
getConditions()	Returns the conditions service.
getConfig()	Returns the config service.
getContentMigrator()	Returns the content migration manager.
getDashboard()	Returns the dashboard service.
getDb()	Returns the database connection component.
getDb2()	Returns the database connection used for mutex locks and element bulk op records.
getDeprecator()	Returns the deprecator service.
getDrafts()	Returns the drafts service.
getDumper()	Returns the variable dumper.
getEdition()	Returns the installed Craft CMS edition’s ID.
getEditionHandle()	Returns the handle of the Craft edition.
getEditionName()	Returns the name of the Craft edition.
getElementSources()	Returns the element indexes service.
getElements()	Returns the elements service.
getEntries()	Returns the entries service.
getEnvId()	Returns the application ID combined with the environment name.
getFields()	Returns the fields service.
getFormatter()	Returns the formatter component.
getFormattingLocale()	Returns the locale that should be used to define the formatter.
getFs()	Returns the filesystems service.
getGc()	Returns the garbage collection service.
getGlobals()	Returns the globals service.
getGql()	Returns the GraphQL service.
getHasWrongEdition()	Returns whether Craft is running with the wrong edition.
getI18n()	Returns the internationalization (i18n) component.
getImageTransforms()	Returns the image transforms service.
getImages()	Returns the images service.
getInfo()	Returns the info model, or just a particular attribute.
getInstalledSchemaVersion()	Returns the installed schema version.
getIsInMaintenanceMode()	Returns whether someone is currently performing a system update.
getIsInitialized()	Returns whether Craft has been fully initialized.
getIsInstalled()	Returns whether Craft is installed.
getIsLive()	Returns whether the system is currently live.
getIsMultiSite()	Returns whether this Craft install has multiple sites.
getLicensedEdition()	Returns the edition Craft is actually licensed to run in.
getLicensedEditionName()	Returns the name of the edition Craft is actually licensed to run in.
getLocale()	Returns a Locale object for the target language.
getLog()	Returns the log dispatcher component.
getMailer()	Returns the current mailer.
getMigrator()	Returns the application’s migration manager.
getMutex()	Returns the application’s mutex service.
getPath()	Returns the path service.
getPluginStore()	Returns the plugin store service.
getPlugins()	Returns the plugins service.
getProjectConfig()	Returns the system config service.
getQueue()	Returns the queue service.
getRelations()	Returns the relations service.
getRevisions()	Returns the revisions service.
getRoutes()	Returns the routes service.
getSearch()	Returns the search service.
getSecurity()	Returns the security component.
getSites()	Returns the sites service.
getSso()	Returns the SSO service.
getStructures()	Returns the structures service.
getSystemMessages()	Returns the system email messages service.
getSystemName()	Returns the system name.
getSystemUid()	Returns the system's UID.
getTags()	Returns the tags service.
getTargetLanguage()	Returns the target app language.
getTemplateCaches()	Returns the template cache service.
getTokens()	Returns the tokens service.
getUpdates()	Returns the updates service.
getUserGroups()	Returns the user groups service.
getUserPermissions()	Returns the user permissions service.
getUsers()	Returns the users service.
getUtilities()	Returns the utilities service.
getView()	Returns the view component.
getVolumes()	Returns the volumes service.
getWebpack()	Returns the webpack service.
getYiiVersion()	Returns the Yii framework version.
onAfterRequest()	Invokes a callback function at the end of the request.
onInit()	Invokes a callback function when Craft is fully initialized.
requireEdition()	Requires that Craft is running an equal or better edition than what's passed in
saveInfo()	Updates the info row.
saveInfoAfterRequest()	Updates the info row at the end of the request.
setEdition()	Sets the installed Craft CMS edition.
setIsInstalled()	Sets Craft's record of whether it's installed
setVendorPath()	Sets the directory that stores vendor files.
trigger()	Triggers an event.
updateTargetLanguage()	Sets the target application language.

`disableMaintenanceMode()`

Disables Maintenance Mode.

See also:

Returns

`enableMaintenanceMode()`

Enables Maintenance Mode.

See also:

Returns

`getAddresses()`

Since: 4.0.0

Returns the addresses service.

Returns

craft\services\Addresses – The addresses service

`getAnnouncements()`

Since: 3.7.0

Returns the announcements service.

Returns

craft\services\Announcements – The announcements service

`getApi()`

Returns the API service.

Returns

craft\services\Api – The API service

`getAssetIndexer()`

Returns the asset indexing service.

Returns

craft\services\AssetIndexer – The asset indexing service

`getAssetManager()`

Returns the asset manager component.

Returns

craft\web\AssetManager –

`getAssets()`

Returns the assets service.

Returns

craft\services\Assets – The assets service

`getAuth()`

Since: 5.0.0

Returns the user authentication service.

Returns

craft\services\Auth – The Auth service

`getCanUpgradeEdition()`

Returns whether Craft is eligible to be upgraded to a different edition.

Returns

`getCategories()`

Returns the categories service.

Returns

craft\services\Categories – The categories service

`getComposer()`

Returns the Composer service.

Returns

craft\services\Composer – The Composer service

`getConditions()`

Since: 4.0.0

Returns the conditions service.

Returns

craft\services\Conditions – The conditions service

`getConfig()`

Returns the config service.

Returns

craft\services\Config – The config service

`getContentMigrator()`

Returns the content migration manager.

Returns

craft\db\MigrationManager – The content migration manager

`getDashboard()`

Returns the dashboard service.

Returns

craft\services\Dashboard – The dashboard service

`getDb()`

Returns the database connection component.

Returns

craft\db\Connection –

`getDb2()`

Since: 5.3.0

Returns the database connection used for mutex locks and element bulk op records.

This helps avoid erratic behavior when locks are used during transactions (see https://makandracards.com/makandra/17437-mysql-careful-when-using-database-locks-in-transactions).

Returns

craft\db\Connection

`getDeprecator()`

Returns the deprecator service.

Returns

craft\services\Deprecator – The deprecator service

`getDrafts()`

Since: 3.2.0

Returns the drafts service.

Returns

craft\services\Drafts – The drafts service

`getDumper()`

Since: 4.4.2

Returns the variable dumper.

Returns

\Symfony\Component\VarDumper\Dumper\AbstractDumper

`getEdition()`

DEPRECATED

Deprecated in 5.0.0. edition should be used instead.

Returns the installed Craft CMS edition’s ID.

Returns

integer

`getEditionHandle()`

DEPRECATED

Deprecated in 5.0.0. edition should be used instead.

Since: 4.4.0

Returns the handle of the Craft edition.

Returns

`getEditionName()`

DEPRECATED

Deprecated in 5.0.0. edition should be used instead.

Returns the name of the Craft edition.

Returns

`getElementSources()`

Returns the element indexes service.

Returns

craft\services\ElementSources – The element indexes service

`getElements()`

Returns the elements service.

Returns

craft\services\Elements – The elements service

`getEntries()`

Returns the entries service.

Returns

craft\services\Entries – The entries service

`getEnvId()`

Since: 5.4.0

Returns the application ID combined with the environment name.

See also:

\craft\base\id
env

Returns

`getFields()`

Returns the fields service.

Returns

craft\services\Fields – The fields service

`getFormatter()`

Returns the formatter component.

Returns

craft\i18n\Formatter –

`getFormattingLocale()`

Since: 3.6.0

Returns the locale that should be used to define the formatter.

Returns

craft\i18n\Locale

`getFs()`

Since: 4.0.0

Returns the filesystems service.

Returns

craft\services\Fs – The filesystems service

`getGc()`

Returns the garbage collection service.

Returns

craft\services\Gc – The garbage collection service

`getGlobals()`

Returns the globals service.

Returns

craft\services\Globals – The globals service

`getGql()`

Since: 3.3.0

Returns the GraphQL service.

Returns

craft\services\Gql – The GraphQL service

`getHasWrongEdition()`

Returns whether Craft is running with the wrong edition.

Returns

`getI18n()`

Returns the internationalization (i18n) component.

Returns

craft\i18n\I18N –

`getImageTransforms()`

Returns the image transforms service.

Returns

craft\services\ImageTransforms – The asset transforms service

`getImages()`

Returns the images service.

Returns

craft\services\Images – The images service

`getInfo()`

Returns the info model, or just a particular attribute.

Arguments

$throwException (boolean) – Whether an exception should be thrown if the info table doesn't exist

Returns

craft\models\Info

Throws

yii\db\Exception
if the info table doesn’t exist yet and $throwException is true
yii\web\ServerErrorHttpException
if the info table is missing its row

`getInstalledSchemaVersion()`

DEPRECATED

Deprecated in 4.0.0

Since: 3.2.0

Returns the installed schema version.

Returns

`getIsInMaintenanceMode()`

Returns whether someone is currently performing a system update.

See also:

Returns

`getIsInitialized()`

Since: 3.0.13

Returns whether Craft has been fully initialized.

Returns

`getIsInstalled()`

Returns whether Craft is installed.

Arguments

$strict (boolean) – Whether to ignore the cached value and explicitly check from the default schema.

Returns

`getIsLive()`

Since: 3.1.0

Returns whether the system is currently live.

Returns

`getIsMultiSite()`

Returns whether this Craft install has multiple sites.

Arguments

$refresh (boolean) – Whether to ignore the cached result and check again
$withTrashed (boolean) – Whether to factor in soft-deleted sites

Returns

`getLicensedEdition()`

Returns the edition Craft is actually licensed to run in.

Returns

\craft\enums\CmsEdition, null

`getLicensedEditionName()`

DEPRECATED

Deprecated in 5.0.0. getLicensedEdition() should be used instead.

Returns the name of the edition Craft is actually licensed to run in.

Returns

string, null

`getLocale()`

Returns a Locale object for the target language.

Returns

craft\i18n\Locale – The Locale object for the target language

`getLog()`

Returns the log dispatcher component.

Returns

craft\log\Dispatcher –

`getMailer()`

Returns the current mailer.

Returns

craft\mail\Mailer – The mailer component

`getMigrator()`

Returns the application’s migration manager.

Returns

craft\db\MigrationManager – The application’s migration manager

`getMutex()`

Returns the application’s mutex service.

Returns

yii\mutex\Mutex – The application’s mutex service

`getPath()`

Returns the path service.

Returns

craft\services\Path – The path service

`getPluginStore()`

Returns the plugin store service.

Returns

craft\services\PluginStore – The plugin store service

`getPlugins()`

Returns the plugins service.

Returns

craft\services\Plugins – The plugins service

`getProjectConfig()`

Returns the system config service.

Returns

craft\services\ProjectConfig – The system config service

`getQueue()`

Returns the queue service.

Returns

yii\queue\Queue – The queue service

`getRelations()`

DEPRECATED

Deprecated in 5.3.0

Returns the relations service.

Returns

craft\services\Relations – The relations service

`getRevisions()`

Since: 3.2.0

Returns the revisions service.

Returns

craft\services\Revisions – The revisions service

`getRoutes()`

Returns the routes service.

Returns

craft\services\Routes – The routes service

`getSearch()`

Returns the search service.

Returns

craft\services\Search – The search service

`getSecurity()`

Returns the security component.

Returns

craft\services\Security –

`getSites()`

Returns the sites service.

Returns

craft\services\Sites – The sites service

`getSso()`

Since: 5.3.0

Returns the SSO service.

Returns

craft\services\Sso – The SSO service

`getStructures()`

Returns the structures service.

Returns

craft\services\Structures – The structures service

`getSystemMessages()`

Returns the system email messages service.

Returns

craft\services\SystemMessages – The system email messages service

`getSystemName()`

Since: 3.1.4

Returns the system name.

Returns

`getSystemUid()`

Returns the system's UID.

Returns

string, null

`getTags()`

Returns the tags service.

Returns

craft\services\Tags – The tags service

`getTargetLanguage()`

Returns the target app language.

Arguments

$useUserLanguage (boolean) – Whether the user’s preferred language should be used.

Returns

`getTemplateCaches()`

Returns the template cache service.

Returns

craft\services\TemplateCaches – The template caches service

`getTokens()`

Returns the tokens service.

Returns

craft\services\Tokens – The tokens service

`getUpdates()`

Returns the updates service.

Returns

craft\services\Updates – The updates service

`getUserGroups()`

Returns the user groups service.

Returns

craft\services\UserGroups – The user groups service

`getUserPermissions()`

Returns the user permissions service.

Returns

craft\services\UserPermissions – The user permissions service

`getUsers()`

Returns the users service.

Returns

craft\services\Users – The users service

`getUtilities()`

Returns the utilities service.

Returns

craft\services\Utilities – The utilities service

`getView()`

Returns the view component.

Returns

craft\web\View –

`getVolumes()`

Returns the volumes service.

Returns

craft\services\Volumes – The volumes service

`getWebpack()`

Since: 3.7.22

Returns the webpack service.

Returns

craft\services\Webpack – The volumes service

`getYiiVersion()`

Returns the Yii framework version.

Returns

`onAfterRequest()`

Since: 4.5.11

Invokes a callback function at the end of the request.

If the request is already ending, the callback will be invoked immediately.

Arguments

$callback (callable)

`onInit()`

Since: 4.3.5

Invokes a callback function when Craft is fully initialized.

If Craft is already fully initialized, the callback will be invoked immediately.

Arguments

$callback (callable)

`requireEdition()`

Requires that Craft is running an equal or better edition than what's passed in

Arguments

$edition (\craft\enums\CmsEdition, integer) – The Craft edition to require.
$orBetter (boolean) – If true, makes $edition the minimum edition required.

Throws

craft\errors\WrongEditionException
if attempting to do something not allowed by the current Craft edition

`saveInfo()`

Updates the info row.

Arguments

$info (craft\models\Info)
$attributeNames (string[], null) – The attributes to save

Returns

`saveInfoAfterRequest()`

Since: 3.1.33

Updates the info row at the end of the request.

`setEdition()`

Sets the installed Craft CMS edition.

Arguments

$edition (\craft\enums\CmsEdition, integer) – The edition to set.

Returns

`setIsInstalled()`

Sets Craft's record of whether it's installed

Arguments

$value (boolean, null)

`setVendorPath()`

Sets the directory that stores vendor files.

Arguments

$path (string) – The directory that stores vendor files.

`trigger()`

Triggers an event.

This method represents the happening of an event. It invokes all attached handlers for the event including class-level handlers.

Arguments

$name (string) – The event name
$event (yii\base\Event, null) – The event instance. If not set, a default yii\base\Event object will be created.

`updateTargetLanguage()`

Sets the target application language.