DRAFT: add static connect method

Author: jnoordsij

src/Php84/Resources/stubs/Pdo/Dblib.php

@@ -33,5 +33,10 @@ public function __construct(string $dsn, ?string $username = null, ?string $pass
                 throw new PDOException("Pdo\Dblib::__construct() cannot be used for connecting to the \"$driver\" driver");
             }
         }
+
+        public static function connect(string $dsn, ?string $username = null, ?string $password = null, ?array $options = null): static
+        {
+            return new static($dsn, $username, $password, $options);
+        }
     }
 }

src/Php84/Resources/stubs/Pdo/Firebird.php

@@ -29,5 +29,10 @@ public function __construct(string $dsn, ?string $username = null, ?string $pass
                 throw new PDOException("Pdo\Firebird::__construct() cannot be used for connecting to the \"$driver\" driver");
             }
         }
+
+        public static function connect(string $dsn, ?string $username = null, ?string $password = null, ?array $options = null): static
+        {
+            return new static($dsn, $username, $password, $options);
+        }
     }
 }

src/Php84/Resources/stubs/Pdo/Mysql.php

@@ -48,6 +48,11 @@ public function __construct(string $dsn, ?string $username = null, ?string $pass
                     throw new PDOException("Pdo\Mysql::__construct() cannot be used for connecting to the \"$driver\" driver");
                 }
             }
+
+            public static function connect(string $dsn, ?string $username = null, ?string $password = null, ?array $options = null): static
+            {
+                return new static($dsn, $username, $password, $options);
+            }
         }
     } else {
         class Mysql extends PDO
@@ -81,6 +86,11 @@ public function __construct(string $dsn, ?string $username = null, ?string $pass
                     throw new PDOException("Pdo\Mysql::__construct() cannot be used for connecting to the \"$driver\" driver");
                 }
             }
+
+            public static function connect(string $dsn, ?string $username = null, ?string $password = null, ?array $options = null): static
+            {
+                return new static($dsn, $username, $password, $options);
+            }
         }
     }
 }

src/Php84/Resources/stubs/Pdo/Odbc.php

@@ -31,5 +31,10 @@ public function __construct(string $dsn, ?string $username = null, ?string $pass
                 throw new PDOException("Pdo\Odbc::__construct() cannot be used for connecting to the \"$driver\" driver");
             }
         }
+
+        public static function connect(string $dsn, ?string $username = null, ?string $password = null, ?array $options = null): static
+        {
+            return new static($dsn, $username, $password, $options);
+        }
     }
 }

src/Php84/Resources/stubs/Pdo/Pgsql.php

@@ -28,6 +28,11 @@ public function __construct(string $dsn, ?string $username = null, ?string $pass
             }
         }
 
+        public static function connect(string $dsn, ?string $username = null, ?string $password = null, ?array $options = null): static
+        {
+            return new static($dsn, $username, $password, $options);
+        }
+
         public function copyFromArray(string $tableName, array $rows, string $separator = "\t", string $nullAs = "\\\\N", ?string $fields = null): bool
         {
             return $this->pgsqlCopyFromArray($tableName, $rows, $separator, $nullAs, $fields);

src/Php84/Resources/stubs/Pdo/Sqlite.php

@@ -34,6 +34,11 @@ public function __construct(string $dsn, ?string $username = null, ?string $pass
             }
         }
 
+        public static function connect(string $dsn, ?string $username = null, ?string $password = null, ?array $options = null): static
+        {
+            return new static($dsn, $username, $password, $options);
+        }
+
         public function createAggregate(string $name, callable $step, callable $finalize, int $numArgs = -1): bool
         {
             return $this->sqliteCreateAggregate($name, $step, $finalize, $numArgs);

tests/Php84/PdoTest.php

@@ -80,6 +80,70 @@ public function testSqliteConstructor()
         $this->assertInstanceOf(\Pdo\Sqlite::class, $sqlite);
     }
 
+    /**
+     * @requires extension pdo_dblib
+     * @requires extension pdo_sqlite
+     */
+    public function testDblibConnect()
+    {
+        $this->expectException(PDOException::class);
+        $this->expectExceptionMessage("Pdo\Dblib::__construct() cannot be used for connecting to the \"sqlite\" driver");
+        \Pdo\Dblib::connect("sqlite:");
+    }
+
+    /**
+     * @requires extension pdo_firebird
+     * @requires extension pdo_sqlite
+     */
+    public function testFirebirdConnect()
+    {
+        $this->expectException(PDOException::class);
+        $this->expectExceptionMessage("Pdo\Firebird::__construct() cannot be used for connecting to the \"sqlite\" driver");
+        \Pdo\Firebird::connect("sqlite:");
+    }
+
+    /**
+     * @requires extension pdo_mysql
+     * @requires extension pdo_sqlite
+     */
+    public function testMysqlConnect()
+    {
+        $this->expectException(PDOException::class);
+        $this->expectExceptionMessage("Pdo\Mysql::__construct() cannot be used for connecting to the \"sqlite\" driver");
+        \Pdo\Mysql::connect("sqlite:");
+    }
+
+    /**
+     * @requires extension pdo_odbc
+     * @requires extension pdo_sqlite
+     */
+    public function testOdbcConnect()
+    {
+        $this->expectException(PDOException::class);
+        $this->expectExceptionMessage("Pdo\Odbc::__construct() cannot be used for connecting to the \"sqlite\" driver");
+        \Pdo\Odbc::connect("sqlite:");
+    }
+
+    /**
+     * @requires extension pdo_pgsql
+     * @requires extension pdo_sqlite
+     */
+    public function testPgsqlConnect()
+    {
+        $this->expectException(PDOException::class);
+        $this->expectExceptionMessage("Pdo\Pgsql::__construct() cannot be used for connecting to the \"sqlite\" driver");
+        \Pdo\Pgsql::connect("sqlite:");
+    }
+
+    /**
+     * @requires extension pdo_sqlite
+     */
+    public function testSqliteConnect()
+    {
+        $sqlite = \Pdo\Sqlite::connect("sqlite:");
+        $this->assertInstanceOf(\Pdo\Sqlite::class, $sqlite);
+    }
+
     /**
      * @requires extension pdo_dblib
      */