[11.x] Add DB::build method (#53464)

* Add ability to build a database connection without specifying name

* Add test

Author: stevebauman

src/Illuminate/Database/DatabaseManager.php

@@ -99,6 +99,21 @@ public function connection($name = null)
         return $this->connections[$name];
     }
 
+    /**
+     * Build a database connection instance from the given configuration.
+     *
+     * @param  array  $config
+     * @return \Illuminate\Database\ConnectionInterface
+     */
+    public function build(array $config)
+    {
+        return $this->connectUsing(
+            $config['name'] ?? 'ondemand',
+            $config,
+            true,
+        );
+    }
+
     /**
      * Get a database connection instance from the given configuration.
      *

src/Illuminate/Support/Facades/DB.php

@@ -10,6 +10,7 @@
 /**
  * @method static \Illuminate\Database\Connection connection(string|null $name = null)
  * @method static \Illuminate\Database\ConnectionInterface connectUsing(string $name, array $config, bool $force = false)
+ * @method static \Illuminate\Database\ConnectionInterface build(array $config)
  * @method static void purge(string|null $name = null)
  * @method static void disconnect(string|null $name = null)
  * @method static \Illuminate\Database\Connection reconnect(string|null $name = null)

tests/Integration/Database/DatabaseConnectionsTest.php

@@ -6,11 +6,25 @@
 
 use Illuminate\Database\DatabaseManager;
 use Illuminate\Database\Events\ConnectionEstablished;
+use Illuminate\Database\SQLiteConnection;
 use Illuminate\Events\Dispatcher;
 use RuntimeException;
 
 class DatabaseConnectionsTest extends DatabaseTestCase
 {
+    public function testBuildDatabaseConnection()
+    {
+        /** @var \Illuminate\Database\DatabaseManager $manager */
+        $manager = $this->app->make(DatabaseManager::class);
+
+        $connection = $manager->build([
+            'driver' => 'sqlite',
+            'database' => ':memory:',
+        ]);
+
+        $this->assertInstanceOf(SQLiteConnection::class, $connection);
+    }
+
     public function testEstablishDatabaseConnection()
     {
         /** @var \Illuminate\Database\DatabaseManager $manager */