You are here

State API in Drupal 9

Same name and namespace in other branches
  1. 8 core/core.api.php \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 175
Documentation landing page and topics, plus core library hooks.

Interfaces

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