State API

Information about the State API.

The State API is one of several methods in Drupal for storing information. See the Information types topic for an overview of the different types of information.

The basic entry point into the State API is \Drupal::state(), which returns an object of class \Drupal\Core\State\StateInterface. This class has methods for storing and retrieving state information; each piece of state information is associated with a string-valued key. Example:

// Get the state class.
$state = \Drupal::state();
// Find out when cron was last run; the key is 'system.cron_last'.
$time = $state->get('system.cron_last');
// Set the cron run time to the current request time.
$state->set('system.cron_last', REQUEST_TIME);

For more on the State API, see https://www.drupal.org/developing/api/8/state

File

core/core.api.php, line 176

Documentation landing page and topics, plus core library hooks.

Interfaces

Name	Location	Description
StateInterface	core/lib/Drupal/Core/State/StateInterface.php	Defines the interface for the state system.