You are here

UncaughtExceptionTest.php in Zircon Profile 8.0

Same filename and directory in other branches
  1. 8 core/modules/system/src/Tests/System/UncaughtExceptionTest.php

File

core/modules/system/src/Tests/System/UncaughtExceptionTest.php
View source
<?php

/**
 * @file
 * Contains \Drupal\system\Tests\System\UncaughtExceptionTest.
 */
namespace Drupal\system\Tests\System;

use Drupal\simpletest\WebTestBase;

/**
 * Tests kernel panic when things are really messed up.
 *
 * @group system
 */
class UncaughtExceptionTest extends WebTestBase {

  /**
   * Exceptions thrown by site under test that contain this text are ignored.
   *
   * @var string
   */
  protected $expectedExceptionMessage;

  /**
   * Modules to enable.
   *
   * @var array
   */
  public static $modules = array(
    'error_service_test',
  );

  /**
   * {@inheritdoc}
   */
  protected function setUp() {
    parent::setUp();
    $settings_filename = $this->siteDirectory . '/settings.php';
    chmod($settings_filename, 0777);
    $settings_php = file_get_contents($settings_filename);
    $settings_php .= "\ninclude_once 'core/modules/system/src/Tests/Bootstrap/ErrorContainer.php';\n";
    $settings_php .= "\ninclude_once 'core/modules/system/src/Tests/Bootstrap/ExceptionContainer.php';\n";
    file_put_contents($settings_filename, $settings_php);
    $settings = [];
    $settings['config']['system.logging']['error_level'] = (object) [
      'value' => ERROR_REPORTING_DISPLAY_VERBOSE,
      'required' => TRUE,
    ];
    $this
      ->writeSettings($settings);
  }

  /**
   * Tests uncaught exception handling when system is in a bad state.
   */
  public function testUncaughtException() {
    $this->expectedExceptionMessage = 'Oh oh, bananas in the instruments.';
    \Drupal::state()
      ->set('error_service_test.break_bare_html_renderer', TRUE);
    $this
      ->config('system.logging')
      ->set('error_level', ERROR_REPORTING_HIDE)
      ->save();
    $settings = [];
    $settings['config']['system.logging']['error_level'] = (object) [
      'value' => ERROR_REPORTING_HIDE,
      'required' => TRUE,
    ];
    $this
      ->writeSettings($settings);
    $this
      ->drupalGet('');
    $this
      ->assertResponse(500);
    $this
      ->assertText('The website encountered an unexpected error. Please try again later.');
    $this
      ->assertNoText($this->expectedExceptionMessage);
    $this
      ->config('system.logging')
      ->set('error_level', ERROR_REPORTING_DISPLAY_ALL)
      ->save();
    $settings = [];
    $settings['config']['system.logging']['error_level'] = (object) [
      'value' => ERROR_REPORTING_DISPLAY_ALL,
      'required' => TRUE,
    ];
    $this
      ->writeSettings($settings);
    $this
      ->drupalGet('');
    $this
      ->assertResponse(500);
    $this
      ->assertText('The website encountered an unexpected error. Please try again later.');
    $this
      ->assertText($this->expectedExceptionMessage);
    $this
      ->assertErrorLogged($this->expectedExceptionMessage);
  }

  /**
   * Tests uncaught exception handling with custom exception handler.
   */
  public function testUncaughtExceptionCustomExceptionHandler() {
    $settings_filename = $this->siteDirectory . '/settings.php';
    chmod($settings_filename, 0777);
    $settings_php = file_get_contents($settings_filename);
    $settings_php .= "\n";
    $settings_php .= "set_exception_handler(function() {\n";
    $settings_php .= "  header('HTTP/1.1 418 I\\'m a teapot');\n";
    $settings_php .= "  print('Oh oh, flying teapots');\n";
    $settings_php .= "});\n";
    file_put_contents($settings_filename, $settings_php);
    \Drupal::state()
      ->set('error_service_test.break_bare_html_renderer', TRUE);
    $this
      ->drupalGet('');
    $this
      ->assertResponse(418);
    $this
      ->assertNoText('The website encountered an unexpected error. Please try again later.');
    $this
      ->assertNoText('Oh oh, bananas in the instruments');
    $this
      ->assertText('Oh oh, flying teapots');
  }

  /**
   * Tests a missing dependency on a service.
   */
  public function testMissingDependency() {
    $this->expectedExceptionMessage = 'Argument 1 passed to Drupal\\error_service_test\\LonelyMonkeyClass::__construct() must be an instance of Drupal\\Core\\Database\\Connection, non';
    $this
      ->drupalGet('broken-service-class');
    $this
      ->assertResponse(500);
    $this
      ->assertRaw('The website encountered an unexpected error.');
    $this
      ->assertRaw($this->expectedExceptionMessage);
    $this
      ->assertErrorLogged($this->expectedExceptionMessage);
  }

  /**
   * Tests a missing dependency on a service with a custom error handler.
   */
  public function testMissingDependencyCustomErrorHandler() {
    $settings_filename = $this->siteDirectory . '/settings.php';
    chmod($settings_filename, 0777);
    $settings_php = file_get_contents($settings_filename);
    $settings_php .= "\n";
    $settings_php .= "set_error_handler(function() {\n";
    $settings_php .= "  header('HTTP/1.1 418 I\\'m a teapot');\n";
    $settings_php .= "  print('Oh oh, flying teapots');\n";
    $settings_php .= "  exit();\n";
    $settings_php .= "});\n";
    $settings_php .= "\$settings['teapots'] = TRUE;\n";
    file_put_contents($settings_filename, $settings_php);
    $this
      ->drupalGet('broken-service-class');
    $this
      ->assertResponse(418);
    $this
      ->assertRaw('Oh oh, flying teapots');
    $message = 'Argument 1 passed to Drupal\\error_service_test\\LonelyMonkeyClass::__construct() must be an instance of Drupal\\Core\\Database\\Connection, non';
    $this
      ->assertNoRaw('The website encountered an unexpected error.');
    $this
      ->assertNoRaw($message);
    $found_exception = FALSE;
    foreach ($this->assertions as &$assertion) {
      if (strpos($assertion['message'], $message) !== FALSE) {
        $found_exception = TRUE;
        $this
          ->deleteAssert($assertion['message_id']);
        unset($assertion);
      }
    }
    $this
      ->assertTrue($found_exception, 'Ensure that the exception of a missing constructor argument was triggered.');
  }

  /**
   * Tests a container which has an error.
   */
  public function testErrorContainer() {
    $settings = [];
    $settings['settings']['container_base_class'] = (object) [
      'value' => '\\Drupal\\system\\Tests\\Bootstrap\\ErrorContainer',
      'required' => TRUE,
    ];
    $this
      ->writeSettings($settings);
    \Drupal::service('kernel')
      ->invalidateContainer();
    $this->expectedExceptionMessage = 'Argument 1 passed to Drupal\\system\\Tests\\Bootstrap\\ErrorContainer::Drupal\\system\\Tests\\Bootstrap\\{closur';
    $this
      ->drupalGet('');
    $this
      ->assertResponse(500);
    $this
      ->assertRaw($this->expectedExceptionMessage);
    $this
      ->assertErrorLogged($this->expectedExceptionMessage);
  }

  /**
   * Tests a container which has an exception really early.
   */
  public function testExceptionContainer() {
    $settings = [];
    $settings['settings']['container_base_class'] = (object) [
      'value' => '\\Drupal\\system\\Tests\\Bootstrap\\ExceptionContainer',
      'required' => TRUE,
    ];
    $this
      ->writeSettings($settings);
    \Drupal::service('kernel')
      ->invalidateContainer();
    $this->expectedExceptionMessage = 'Thrown exception during Container::get';
    $this
      ->drupalGet('');
    $this
      ->assertResponse(500);
    $this
      ->assertRaw('The website encountered an unexpected error');
    $this
      ->assertRaw($this->expectedExceptionMessage);
    $this
      ->assertErrorLogged($this->expectedExceptionMessage);
  }

  /**
   * Tests the case when the database connection is gone.
   */
  public function testLostDatabaseConnection() {
    $incorrect_username = $this
      ->randomMachineName(16);
    switch ($this->container
      ->get('database')
      ->driver()) {
      case 'pgsql':
      case 'mysql':
        $this->expectedExceptionMessage = $incorrect_username;
        break;
      default:

        // We can not carry out this test.
        $this
          ->pass('Unable to run \\Drupal\\system\\Tests\\System\\UncaughtExceptionTest::testLostDatabaseConnection for this database type.');
        return;
    }

    // We simulate a broken database connection by rewrite settings.php to no
    // longer have the proper data.
    $settings['databases']['default']['default']['username'] = (object) array(
      'value' => $incorrect_username,
      'required' => TRUE,
    );
    $settings['databases']['default']['default']['passowrd'] = (object) array(
      'value' => $this
        ->randomMachineName(16),
      'required' => TRUE,
    );
    $this
      ->writeSettings($settings);
    $this
      ->drupalGet('');
    $this
      ->assertResponse(500);
    $this
      ->assertRaw('PDOException');
    $this
      ->assertErrorLogged($this->expectedExceptionMessage);
  }

  /**
   * Tests fallback to PHP error log when an exception is thrown while logging.
   */
  public function testLoggerException() {

    // Ensure the test error log is empty before these tests.
    $this
      ->assertNoErrorsLogged();
    $this->expectedExceptionMessage = 'Deforestation';
    \Drupal::state()
      ->set('error_service_test.break_logger', TRUE);
    $this
      ->drupalGet('');
    $this
      ->assertResponse(500);
    $this
      ->assertText('The website encountered an unexpected error. Please try again later.');
    $this
      ->assertRaw($this->expectedExceptionMessage);

    // Find fatal error logged to the simpletest error.log
    $errors = file(\Drupal::root() . '/' . $this->siteDirectory . '/error.log');
    $this
      ->assertIdentical(count($errors), 2, 'The error + the error that the logging service is broken has been written to the error log.');
    $this
      ->assertTrue(strpos($errors[0], 'Failed to log error') !== FALSE, 'The error handling logs when an error could not be logged to the logger.');
    $expected_path = \Drupal::root() . '/core/modules/system/tests/modules/error_service_test/src/MonkeysInTheControlRoom.php';
    $expected_line = 63;
    $expected_entry = "Failed to log error: Exception: Deforestation in Drupal\\error_service_test\\MonkeysInTheControlRoom->handle() (line {$expected_line} of {$expected_path})";
    $this
      ->assert(strpos($errors[0], $expected_entry) !== FALSE, 'Original error logged to the PHP error log when an exception is thrown by a logger');

    // The exception is expected. Do not interpret it as a test failure. Not
    // using File API; a potential error must trigger a PHP warning.
    unlink(\Drupal::root() . '/' . $this->siteDirectory . '/error.log');
  }

  /**
   * {@inheritdoc}
   */
  protected function error($message = '', $group = 'Other', array $caller = NULL) {
    if (!empty($this->expectedExceptionMessage) && strpos($message, $this->expectedExceptionMessage) !== FALSE) {

      // We're expecting this error.
      return FALSE;
    }
    return parent::error($message, $group, $caller);
  }

}

Classes

Namesort descending Description
UncaughtExceptionTest Tests kernel panic when things are really messed up.