DBAL 3.0: suggestions to improve the Driver\Connection interface

lib/Doctrine/DBAL/Driver/AbstractDriverException.php

@@ -36,6 +36,42 @@ public function __construct($message, $sqlState = null, $errorCode = null)
         $this->sqlState  = $sqlState;
     }
 
+    /**
+     * @return AbstractDriverException
+     */
+    public static function noInsertId() : self
+    {
+        $message = 'No identity value was generated by the last statement.';
+
+        if (static::class === self::class) {
+            // WIP regarding exceptions, see:
+            // https://github.com/doctrine/dbal/pull/3335#discussion_r234381175
+            return new class($message) extends AbstractDriverException {
+            };
+        }
+
+        return new static($message);
+    }
+
+    /**
+     * @param string $name The sequence name.
+     *
+     * @return AbstractDriverException
+     */
+    public static function noSuchSequence(string $name) : self
+    {
+        $message = 'No sequence with name "' . $name . '" found.';
+
+        if (static::class === self::class) {
+            // WIP regarding exceptions, see:
+            // https://github.com/doctrine/dbal/pull/3335#discussion_r234381175
+            return new class($message) extends AbstractDriverException {
+            };
+        }
+
+        return new static($message);
+    }
+
     /**
      * {@inheritdoc}
      */

lib/Doctrine/DBAL/Driver/IBMDB2/DB2Connection.php

@@ -130,7 +130,7 @@ public function lastInsertId(?string $name = null) : string
         $lastInsertId = db2_last_insert_id($this->conn);
 
         if ($lastInsertId === '') {
-            throw new DB2Exception('The last statement did not return an insert ID.');
+            throw DB2Exception::noInsertId();
         }
 
         return $lastInsertId;

lib/Doctrine/DBAL/Driver/Mysqli/MysqliConnection.php

@@ -170,7 +170,7 @@ public function lastInsertId(?string $name = null) : string
         $insertId = $this->conn->insert_id;
 
         if ($insertId === 0) {
-            throw new MysqliException('The last statement did not return an insert ID.');
+            throw MysqliException::noInsertId();
         }
 
         return (string) $insertId;

lib/Doctrine/DBAL/Driver/PDOConnection.php

@@ -101,10 +101,7 @@ public function lastInsertId(?string $name = null) : string
 
         // pdo_mysql and others return '0', pdo_sqlsrv returns ''
         if ($lastInsertId === '0' || $lastInsertId === '') {
-            // WIP regarding exceptions, see:
-            // https://github.com/doctrine/dbal/pull/3335#discussion_r234381175
-            throw new class ('The last statement did not return an insert ID.') extends AbstractDriverException {
-            };
+            throw AbstractDriverException::noInsertId();
         }
 
         return $lastInsertId;

lib/Doctrine/DBAL/Driver/PDOSqlsrv/Connection.php

@@ -28,10 +28,7 @@ public function lastInsertId(?string $name = null) : string
         $result = $stmt->fetchColumn();
 
         if ($result === false) {
-            // WIP regarding exceptions, see:
-            // https://github.com/doctrine/dbal/pull/3335#discussion_r234381175
-            throw new class ('No sequence with name "' . $name . '" found.') extends AbstractDriverException {
-            };
+            throw AbstractDriverException::noSuchSequence($name);
         }
 
         return (string) $result;

lib/Doctrine/DBAL/Driver/SQLAnywhere/SQLAnywhereConnection.php

@@ -140,7 +140,7 @@ public function lastInsertId(?string $name = null) : string
             }
 
             if ($result === 0) {
-                throw new SQLAnywhereException('The last insert did not affect an AUTOINCREMENT column.');
+                throw SQLAnywhereException::noInsertId();
             }
 
             return (string) $result;
@@ -149,7 +149,7 @@ public function lastInsertId(?string $name = null) : string
         $result = $this->query('SELECT ' . $name . '.CURRVAL')->fetchColumn();
 
         if ($result === false) {
-            throw new SQLAnywhereException('No sequence with name "' . $name . '" found.');
+            throw SQLAnywhereException::noSuchSequence($name);
         }
 
         return (string) $result;

lib/Doctrine/DBAL/Driver/SQLSrv/SQLSrvConnection.php

@@ -123,11 +123,11 @@ public function lastInsertId(?string $name = null) : string
 
         if ($name !== null) {
             if ($result === false) {
-                throw new SQLSrvException('No sequence with name "' . $name . '" found.');
+                throw SQLSrvException::noSuchSequence($name);
             }
         } else {
             if ($result === null) {
-                throw new SQLSrvException('No identity value was generated by the last statement.');
+                throw SQLSrvException::noInsertId();
             }
         }