protected function DrupalWebTestCase::drupalGetHeader

7.x drupal_web_test_case.php protected DrupalWebTestCase::drupalGetHeader($name, $all_requests = FALSE)

Gets the value of an HTTP response header. If multiple requests were required to retrieve the page, only the headers from the last request will be checked by default. However, if TRUE is passed as the second argument, all requests will be processed from last to first until the header is found.


$name: The name of the header to retrieve. Names are case-insensitive (see RFC 2616 section 4.2).

$all_requests: Boolean value specifying whether to check all requests if the header is not found in the last request. Defaults to FALSE.

Return value

The HTTP header value or FALSE if not found.

13 calls to DrupalWebTestCase::drupalGetHeader()
BootstrapPageCacheTestCase::testConditionalRequests in drupal/modules/simpletest/tests/bootstrap.test
Test support for requests containing If-Modified-Since and If-None-Match headers.
BootstrapPageCacheTestCase::testPageCache in drupal/modules/simpletest/tests/bootstrap.test
Test cache headers.
BootstrapPageCacheTestCase::testPageCompression in drupal/modules/simpletest/tests/bootstrap.test
Test page compression.
DrupalErrorHandlerTestCase::testExceptionHandler in drupal/modules/simpletest/tests/error.test
Test the exception handler.
DrupalWebTestCase::curlExec in drupal/modules/simpletest/drupal_web_test_case.php
Initializes and executes a cURL request.

... See full list


drupal/modules/simpletest/drupal_web_test_case.php, line 2783


Test case for typical Drupal tests.


protected function drupalGetHeader($name, $all_requests = FALSE) {
  $name = strtolower($name);
  $header = FALSE;
  if ($all_requests) {
    foreach (array_reverse($this->drupalGetHeaders(TRUE)) as $headers) {
      if (isset($headers[$name])) {
        $header = $headers[$name];
  else {
    $headers = $this->drupalGetHeaders();
    if (isset($headers[$name])) {
      $header = $headers[$name];
  return $header;