Merge pull request #232 from nextras/named-timezones-doc

Named timezones doc

Author: hrach

src/Bridges/NetteTracy/BluescreenQueryPanel.php

@@ -20,7 +20,8 @@ public static function renderBluescreenPanel(?\Throwable $exception): ?array
 
 		return [
 			'tab' => 'SQL',
-			'panel' => '<pre class="sql">' . SqlHighlighter::highlight($query) . "</pre>",
+			'panel' => '<pre class="sql">' . SqlHighlighter::highlight($query) . '</pre>' .
+				"<p>Error code: {$exception->getErrorCode()}<br>SQL STATE: {$exception->getErrorSqlState()}</p>",
 		];
 	}
 }

src/Drivers/Exception/UnknownMysqlTimezone.php

@@ -0,0 +1,27 @@
+<?php declare(strict_types = 1);
+
+namespace Nextras\Dbal\Drivers\Exception;
+
+
+use Exception;
+
+
+class UnknownMysqlTimezone extends QueryException
+{
+	public function __construct(
+		string $message,
+		int $errorCode = 0,
+		string $errorSqlState = '',
+		Exception $previousException = null,
+		?string $sqlQuery = null,
+	)
+	{
+		parent::__construct(
+			$message . "\nSee how to solve the issue: https://nextras.org/dbal/docs/main/timezones-mysql-support",
+			$errorCode,
+			$errorSqlState,
+			$previousException,
+			$sqlQuery,
+		);
+	}
+}

src/Drivers/Mysqli/MysqliDriver.php

@@ -12,6 +12,7 @@
 use Nextras\Dbal\Drivers\Exception\NotNullConstraintViolationException;
 use Nextras\Dbal\Drivers\Exception\QueryException;
 use Nextras\Dbal\Drivers\Exception\UniqueConstraintViolationException;
+use Nextras\Dbal\Drivers\Exception\UnknownMysqlTimezone;
 use Nextras\Dbal\Drivers\IDriver;
 use Nextras\Dbal\Exception\InvalidStateException;
 use Nextras\Dbal\Exception\NotSupportedException;
@@ -368,6 +369,8 @@ protected function createException(string $error, int $errorNo, string $sqlState
 			return new ConnectionException($error, $errorNo, $sqlState);
 		} elseif (in_array($errorNo, [1048, 1121, 1138, 1171, 1252, 1263, 1566], true)) {
 			return new NotNullConstraintViolationException($error, $errorNo, $sqlState, null, $query);
+		} elseif ($errorNo === 1298) {
+			return new UnknownMysqlTimezone($error, $errorNo, $sqlState, null, $query);
 		} elseif ($query !== null) {
 			return new QueryException($error, $errorNo, $sqlState, null, $query);
 		} else {

src/Drivers/PdoMysql/PdoMysqlDriver.php

@@ -11,6 +11,7 @@
 use Nextras\Dbal\Drivers\Exception\NotNullConstraintViolationException;
 use Nextras\Dbal\Drivers\Exception\QueryException;
 use Nextras\Dbal\Drivers\Exception\UniqueConstraintViolationException;
+use Nextras\Dbal\Drivers\Exception\UnknownMysqlTimezone;
 use Nextras\Dbal\Drivers\IDriver;
 use Nextras\Dbal\Drivers\Pdo\PdoDriver;
 use Nextras\Dbal\Exception\InvalidArgumentException;
@@ -153,6 +154,8 @@ protected function createException(string $error, int $errorNo, string $sqlState
 			return new ConnectionException($error, $errorNo, $sqlState);
 		} elseif (in_array($errorNo, [1048, 1121, 1138, 1171, 1252, 1263, 1566], true)) {
 			return new NotNullConstraintViolationException($error, $errorNo, $sqlState, null, $query);
+		} elseif ($errorNo === 1298) {
+			return new UnknownMysqlTimezone($error, $errorNo, $sqlState, null, $query);
 		} elseif ($query !== null) {
 			return new QueryException($error, $errorNo, $sqlState, null, $query);
 		} else {