View source
<?php
namespace Drupal\FunctionalTests\Bootstrap;
use Drupal\Component\Render\FormattableMarkup;
use Drupal\Tests\BrowserTestBase;
class UncaughtExceptionTest extends BrowserTestBase {
protected $expectedExceptionMessage;
protected static $modules = [
'error_service_test',
'error_test',
];
protected $defaultTheme = 'stark';
protected function setUp() : void {
parent::setUp();
$settings_filename = $this->siteDirectory . '/settings.php';
chmod($settings_filename, 0777);
$settings_php = file_get_contents($settings_filename);
$settings_php .= "\ninclude_once 'core/tests/Drupal/FunctionalTests/Bootstrap/ErrorContainer.php';\n";
$settings_php .= "\ninclude_once 'core/tests/Drupal/FunctionalTests/Bootstrap/ExceptionContainer.php';\n";
$settings_php .= "\ndefine('SIMPLETEST_COLLECT_ERRORS', FALSE);\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);
}
public function testUncaughtException() {
$this->expectedExceptionMessage = 'Oh oh, bananas in the instruments.';
\Drupal::state()
->set('error_service_test.break_bare_html_renderer', TRUE);
$settings = [];
$settings['config']['system.logging']['error_level'] = (object) [
'value' => ERROR_REPORTING_HIDE,
'required' => TRUE,
];
$this
->writeSettings($settings);
$this
->drupalGet('');
$this
->assertSession()
->statusCodeEquals(500);
$this
->assertSession()
->pageTextContains('The website encountered an unexpected error. Please try again later.');
$this
->assertSession()
->pageTextNotContains($this->expectedExceptionMessage);
$settings = [];
$settings['config']['system.logging']['error_level'] = (object) [
'value' => ERROR_REPORTING_DISPLAY_ALL,
'required' => TRUE,
];
$this
->writeSettings($settings);
$this
->drupalGet('');
$this
->assertSession()
->statusCodeEquals(500);
$this
->assertSession()
->pageTextContains('The website encountered an unexpected error. Please try again later.');
$this
->assertSession()
->pageTextContains($this->expectedExceptionMessage);
$this
->assertErrorLogged($this->expectedExceptionMessage);
}
public function testUncaughtFatalError() {
$fatal_error = [
'%type' => 'TypeError',
'@message' => 'Drupal\\error_test\\Controller\\ErrorTestController::Drupal\\error_test\\Controller\\{closure}(): Argument #1 ($test) must be of type array, string given, called in ' . \Drupal::root() . '/core/modules/system/tests/modules/error_test/src/Controller/ErrorTestController.php on line 65',
'%function' => 'Drupal\\error_test\\Controller\\ErrorTestController->Drupal\\error_test\\Controller\\{closure}()',
];
$this
->drupalGet('error-test/generate-fatals');
$this
->assertSession()
->statusCodeEquals(500);
$message = new FormattableMarkup('%type: @message in %function (line ', $fatal_error);
$this
->assertSession()
->responseContains((string) $message);
$this
->assertSession()
->responseContains('<pre class="backtrace">');
$this
->assertSession()
->responseContains('>');
$this
->assertSession()
->responseNotContains('&gt;');
}
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
->assertSession()
->statusCodeEquals(418);
$this
->assertSession()
->pageTextNotContains('The website encountered an unexpected error. Please try again later.');
$this
->assertSession()
->pageTextNotContains('Oh oh, bananas in the instruments');
$this
->assertSession()
->pageTextContains('Oh oh, flying teapots');
}
public function testMissingDependency() {
$this->expectedExceptionMessage = 'Too few arguments to function Drupal\\error_service_test\\LonelyMonkeyClass::__construct(), 0 passed';
$this
->drupalGet('broken-service-class');
$this
->assertSession()
->statusCodeEquals(500);
$this
->assertSession()
->pageTextContains('The website encountered an unexpected error.');
$this
->assertSession()
->pageTextContains($this->expectedExceptionMessage);
$this
->assertErrorLogged($this->expectedExceptionMessage);
}
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
->assertSession()
->statusCodeEquals(418);
$this
->assertSession()
->responseContains('Oh oh, flying teapots');
}
public function testErrorContainer() {
$settings = [];
$settings['settings']['container_base_class'] = (object) [
'value' => '\\Drupal\\FunctionalTests\\Bootstrap\\ErrorContainer',
'required' => TRUE,
];
$this
->writeSettings($settings);
\Drupal::service('kernel')
->invalidateContainer();
$this->expectedExceptionMessage = 'Drupal\\FunctionalTests\\Bootstrap\\ErrorContainer::Drupal\\FunctionalTests\\Bootstrap\\{closure}(): Argument #1 ($container) must be of type Drupal\\FunctionalTests\\Bootstrap\\ErrorContainer';
$this
->drupalGet('');
$this
->assertSession()
->statusCodeEquals(500);
$this
->assertSession()
->pageTextContains($this->expectedExceptionMessage);
$this
->assertErrorLogged($this->expectedExceptionMessage);
}
public function testExceptionContainer() {
$settings = [];
$settings['settings']['container_base_class'] = (object) [
'value' => '\\Drupal\\FunctionalTests\\Bootstrap\\ExceptionContainer',
'required' => TRUE,
];
$this
->writeSettings($settings);
\Drupal::service('kernel')
->invalidateContainer();
$this->expectedExceptionMessage = 'Thrown exception during Container::get';
$this
->drupalGet('');
$this
->assertSession()
->statusCodeEquals(500);
$this
->assertSession()
->pageTextContains('The website encountered an unexpected error');
$this
->assertSession()
->pageTextContains($this->expectedExceptionMessage);
$this
->assertErrorLogged($this->expectedExceptionMessage);
}
public function testLostDatabaseConnection() {
$incorrect_username = $this
->randomMachineName(16);
switch ($this->container
->get('database')
->driver()) {
case 'pgsql':
case 'mysql':
$this->expectedExceptionMessage = $incorrect_username;
break;
default:
$this
->markTestSkipped('Unable to run \\Drupal\\system\\Tests\\System\\UncaughtExceptionTest::testLostDatabaseConnection for this database type.');
}
$settings['databases']['default']['default']['username'] = (object) [
'value' => $incorrect_username,
'required' => TRUE,
];
$settings['databases']['default']['default']['password'] = (object) [
'value' => $this
->randomMachineName(16),
'required' => TRUE,
];
$this
->writeSettings($settings);
$this
->drupalGet('');
$this
->assertSession()
->statusCodeEquals(500);
$this
->assertSession()
->pageTextContains('DatabaseAccessDeniedException');
$this
->assertErrorLogged($this->expectedExceptionMessage);
}
public function testLoggerException() {
$this
->assertNoErrorsLogged();
$this->expectedExceptionMessage = 'Deforestation';
\Drupal::state()
->set('error_service_test.break_logger', TRUE);
$this
->drupalGet('');
$this
->assertSession()
->statusCodeEquals(500);
$this
->assertSession()
->pageTextContains('The website encountered an unexpected error. Please try again later.');
$this
->assertSession()
->pageTextContains($this->expectedExceptionMessage);
$errors = file(\Drupal::root() . '/' . $this->siteDirectory . '/error.log');
$this
->assertCount(8, $errors, 'The error + the error that the logging service is broken has been written to the error log.');
$this
->assertStringContainsString('Failed to log error', $errors[0], '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 = 62;
$expected_entry = "Failed to log error: Exception: Deforestation in Drupal\\error_service_test\\MonkeysInTheControlRoom->handle() (line {$expected_line} of {$expected_path})";
$this
->assertStringContainsString($expected_entry, $errors[0], 'Original error logged to the PHP error log when an exception is thrown by a logger');
unlink(\Drupal::root() . '/' . $this->siteDirectory . '/error.log');
}
protected function assertErrorLogged(string $error_message) : void {
$error_log_filename = DRUPAL_ROOT . '/' . $this->siteDirectory . '/error.log';
$this
->assertFileExists($error_log_filename);
$content = file_get_contents($error_log_filename);
$rows = explode(PHP_EOL, $content);
$found = FALSE;
foreach ($rows as $row_index => $row) {
if (strpos($content, $error_message) !== FALSE) {
$found = TRUE;
unset($rows[$row_index]);
}
}
file_put_contents($error_log_filename, implode("\n", $rows));
$this
->assertTrue($found, sprintf('The %s error message was logged.', $error_message));
}
protected function assertNoErrorsLogged() : void {
$this
->assertFileDoesNotExist(DRUPAL_ROOT . '/' . $this->siteDirectory . '/error.log');
}
}