class FormSubmitter
Same name in other branches
- 9 core/lib/Drupal/Core/Form/FormSubmitter.php \Drupal\Core\Form\FormSubmitter
- 10 core/lib/Drupal/Core/Form/FormSubmitter.php \Drupal\Core\Form\FormSubmitter
- 11.x core/lib/Drupal/Core/Form/FormSubmitter.php \Drupal\Core\Form\FormSubmitter
Provides submission processing for forms.
Hierarchy
- class \Drupal\Core\Form\FormSubmitter implements \Drupal\Core\Form\FormSubmitterInterface
Expanded class hierarchy of FormSubmitter
1 string reference to 'FormSubmitter'
- core.services.yml in core/
core.services.yml - core/core.services.yml
1 service uses FormSubmitter
File
-
core/
lib/ Drupal/ Core/ Form/ FormSubmitter.php, line 15
Namespace
Drupal\Core\FormView source
class FormSubmitter implements FormSubmitterInterface {
/**
* The URL generator.
*
* @var \Drupal\Core\Routing\UrlGeneratorInterface
*/
protected $urlGenerator;
/**
* The request stack.
*
* @var \Symfony\Component\HttpFoundation\RequestStack
*/
protected $requestStack;
/**
* Constructs a new FormValidator.
*
* @param \Symfony\Component\HttpFoundation\RequestStack $request_stack
* The request stack.
* @param \Drupal\Core\Routing\UrlGeneratorInterface $url_generator
*/
public function __construct(RequestStack $request_stack, UrlGeneratorInterface $url_generator) {
$this->requestStack = $request_stack;
$this->urlGenerator = $url_generator;
}
/**
* {@inheritdoc}
*/
public function doSubmitForm(&$form, FormStateInterface &$form_state) {
if (!$form_state->isSubmitted()) {
return;
}
// Execute form submit handlers.
$this->executeSubmitHandlers($form, $form_state);
// If batches were set in the submit handlers, we process them now,
// possibly ending execution. We make sure we do not react to the batch
// that is already being processed (if a batch operation performs a
// \Drupal\Core\Form\FormBuilderInterface::submitForm).
if (($batch =& $this->batchGet()) && !isset($batch['current_set'])) {
// Store $form_state information in the batch definition.
$batch['form_state'] = $form_state;
$batch['progressive'] = !$form_state->isProgrammed();
$response = batch_process();
// If the batch has been completed and _batch_finished() called then
// $batch will be NULL.
if ($batch && $batch['progressive']) {
return $response;
}
// Execution continues only for programmatic forms.
// For 'regular' forms, we get redirected to the batch processing
// page. Form redirection will be handled in _batch_finished(),
// after the batch is processed.
}
// Set a flag to indicate the form has been processed and executed.
$form_state->setExecuted();
// If no response has been set, process the form redirect.
if (!$form_state->getResponse() && ($redirect = $this->redirectForm($form_state))) {
$form_state->setResponse($redirect);
}
// If there is a response was set, return it instead of continuing.
if (($response = $form_state->getResponse()) && $response instanceof Response) {
return $response;
}
}
/**
* {@inheritdoc}
*/
public function executeSubmitHandlers(&$form, FormStateInterface &$form_state) {
// If there was a button pressed, use its handlers.
$handlers = $form_state->getSubmitHandlers();
// Otherwise, check for a form-level handler.
if (!$handlers && !empty($form['#submit'])) {
$handlers = $form['#submit'];
}
foreach ($handlers as $callback) {
// Check if a previous _submit handler has set a batch, but make sure we
// do not react to a batch that is already being processed (for instance
// if a batch operation performs a
// \Drupal\Core\Form\FormBuilderInterface::submitForm()).
if (($batch =& $this->batchGet()) && !isset($batch['id'])) {
// Some previous submit handler has set a batch. To ensure correct
// execution order, store the call in a special 'control' batch set.
// See _batch_next_set().
$batch['sets'][] = [
'form_submit' => $callback,
];
$batch['has_form_submits'] = TRUE;
}
else {
call_user_func_array($form_state->prepareCallback($callback), [
&$form,
&$form_state,
]);
}
}
}
/**
* {@inheritdoc}
*/
public function redirectForm(FormStateInterface $form_state) {
$redirect = $form_state->getRedirect();
// Allow using redirect responses directly if needed.
if ($redirect instanceof RedirectResponse) {
return $redirect;
}
$url = NULL;
// Check for a route-based redirection.
if ($redirect instanceof Url) {
$url = $redirect->setAbsolute()
->toString();
}
elseif ($redirect === NULL) {
$request = $this->requestStack
->getCurrentRequest();
$url = $this->urlGenerator
->generateFromRoute('<current>', [], [
'query' => $request->query
->all(),
'absolute' => TRUE,
]);
}
if ($url) {
// According to RFC 7231, 303 See Other status code must be used to redirect
// user agent (and not default 302 Found).
// @see http://tools.ietf.org/html/rfc7231#section-6.4.4
return new RedirectResponse($url, Response::HTTP_SEE_OTHER);
}
}
/**
* Wraps drupal_installation_attempted().
*
* @return bool
*
* @deprecated in drupal:8.8.0 and is removed from drupal:9.0.0.
* Use \Drupal\Core\Installer\InstallerKernel::installationAttempted()
* instead.
*
* @see https://www.drupal.org/node/3035275
* @see \Drupal\Core\Installer\InstallerKernel::installationAttempted()
*/
protected function drupalInstallationAttempted() {
@trigger_error(__METHOD__ . '() is deprecated in drupal:8.8.0 and is removed from drupal:9.0.0. Use \\Drupal\\Core\\Installer\\InstallerKernel::installationAttempted() instead. See https://www.drupal.org/node/3035275', E_USER_DEPRECATED);
return InstallerKernel::installationAttempted();
}
/**
* Wraps batch_get().
*/
protected function &batchGet() {
return batch_get();
}
}
Members
Title Sort descending | Deprecated | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|---|
FormSubmitter::$requestStack | protected | property | The request stack. | ||
FormSubmitter::$urlGenerator | protected | property | The URL generator. | ||
FormSubmitter::batchGet | protected | function | Wraps batch_get(). | ||
FormSubmitter::doSubmitForm | public | function | Handles the submitted form, executing callbacks and processing responses. | Overrides FormSubmitterInterface::doSubmitForm | |
FormSubmitter::drupalInstallationAttempted | Deprecated | protected | function | Wraps drupal_installation_attempted(). | |
FormSubmitter::executeSubmitHandlers | public | function | Executes custom submission handlers for a given form. | Overrides FormSubmitterInterface::executeSubmitHandlers | |
FormSubmitter::redirectForm | public | function | Redirects the user to a URL after a form has been processed. | Overrides FormSubmitterInterface::redirectForm | |
FormSubmitter::__construct | public | function | Constructs a new FormValidator. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.