public function ExceptionHandler::handleStatementException in Drupal 9

Same name and namespace in other branches

1. 10 core/lib/Drupal/Core/Database/ExceptionHandler.php \Drupal\Core\Database\ExceptionHandler::handleStatementException()

Handles exceptions thrown during the preparation of statement objects.

Parameters

\Exception $exception: The exception to be handled.

string $sql: The SQL statement that was requested to be prepared.

array $options: An associative array of options to control how the database operation is run.

Throws

\Drupal\Core\Database\DatabaseExceptionWrapper

File

core/lib/Drupal/Core/Database/ExceptionHandler.php, line 27

Class

ExceptionHandler

Base Database exception handler class.

Namespace

Drupal\Core\Database

Code

public function handleStatementException(\Exception $exception, string $sql, array $options = []) : void {
  if (array_key_exists('throw_exception', $options)) {
    @trigger_error('Passing a \'throw_exception\' option to ' . __METHOD__ . ' is deprecated in drupal:9.2.0 and is removed in drupal:10.0.0. Always catch exceptions. See https://www.drupal.org/node/3201187', E_USER_DEPRECATED);
    if (!$options['throw_exception']) {
      return;
    }
  }
  if ($exception instanceof \PDOException) {

    // Wrap the exception in another exception, because PHP does not allow
    // overriding Exception::getMessage(). Its message is the extra database
    // debug information.
    $message = $exception
      ->getMessage() . ": " . $sql . "; ";
    throw new DatabaseExceptionWrapper($message, 0, $exception);
  }
  throw $exception;
}