public function FormState::setCached in Drupal 8

Same name and namespace in other branches

1. 9 core/lib/Drupal/Core/Form/FormState.php \Drupal\Core\Form\FormState::setCached()

Sets this form to be cached.

Parameters

bool $cache: TRUE if the form should be cached, FALSE otherwise.

Return value

$this

Throws

\LogicException If the current request is using an HTTP method that must not change state (e.g., GET).

Overrides FormStateInterface::setCached

File

core/lib/Drupal/Core/Form/FormState.php, line 500

Class

FormState

Stores information about the state of a form.

Namespace

Drupal\Core\Form

Code

public function setCached($cache = TRUE) {

  // Persisting $form_state is a side-effect disallowed during a "safe" HTTP
  // method.
  if ($cache && $this
    ->isRequestMethodSafe()) {
    throw new \LogicException(sprintf('Form state caching on %s requests is not allowed.', $this->requestMethod));
  }
  $this->cache = (bool) $cache;
  return $this;
}