You are here

public static function Drupal::request in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 core/lib/Drupal.php \Drupal::request()

Retrieves the currently active request object.

Note: The use of this wrapper in particular is especially discouraged. Most code should not need to access the request directly. Doing so means it will only function when handling an HTTP request, and will require special modification or wrapping when run from a command line tool, from certain queue processors, or from automated tests.

If code must access the request, it is considerably better to register an object with the Service Container and give it a setRequest() method that is configured to run when the service is created. That way, the correct request object can always be provided by the container and the service can still be unit tested.

If this method must be used, never save the request object that is returned. Doing so may lead to inconsistencies as the request object is volatile and may change at various times, such as during a subrequest.

Return value

\Symfony\Component\HttpFoundation\Request The currently active request object.

26 calls to Drupal::request()
batch_process in core/includes/form.inc
Processes the batch.
BlockViewBuilderTest::testBlockViewBuilderBuildAlter in core/modules/block/src/Tests/BlockViewBuilderTest.php
Tests block build altering.
BlockViewBuilderTest::verifyRenderCacheHandling in core/modules/block/src/Tests/BlockViewBuilderTest.php
Verifies render cache handling of the block being tested.
BrowserTestBase::installDrupal in core/modules/simpletest/src/BrowserTestBase.php
Installs Drupal into the Simpletest site.
BrowserTestBase::setUp in core/modules/simpletest/src/BrowserTestBase.php

... See full list

File

core/lib/Drupal.php, line 217
Contains \Drupal.

Class

Drupal
Static Service Container wrapper.

Code

public static function request() {
  return static::getContainer()
    ->get('request_stack')
    ->getCurrentRequest();
}