From 647db40033de25f281f856081352db40041f0a6b Mon Sep 17 00:00:00 2001
From: Jan Skrasek <hrach.cz@gmail.com>
Date: Tue, 12 Mar 2024 16:53:16 +0100
Subject: [PATCH] better document what to do when mysql named zones are not
 supported

---
 .../Exception/UnknownMysqlTimezone.php        | 27 +++++++++++++++++++
 src/Drivers/Mysqli/MysqliDriver.php           |  3 +++
 src/Drivers/PdoMysql/PdoMysqlDriver.php       |  3 +++
 3 files changed, 33 insertions(+)
 create mode 100644 src/Drivers/Exception/UnknownMysqlTimezone.php

diff --git a/src/Drivers/Exception/UnknownMysqlTimezone.php b/src/Drivers/Exception/UnknownMysqlTimezone.php
new file mode 100644
index 0000000..93c0dba
--- /dev/null
+++ b/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,
+		);
+	}
+}
diff --git a/src/Drivers/Mysqli/MysqliDriver.php b/src/Drivers/Mysqli/MysqliDriver.php
index 7d7edd4..b383191 100644
--- a/src/Drivers/Mysqli/MysqliDriver.php
+++ b/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 {
diff --git a/src/Drivers/PdoMysql/PdoMysqlDriver.php b/src/Drivers/PdoMysql/PdoMysqlDriver.php
index 6166553..4c8675c 100644
--- a/src/Drivers/PdoMysql/PdoMysqlDriver.php
+++ b/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 {