Add new db_connect convenience function.

Author: lonnieezell

system/Common.php

@@ -102,6 +102,35 @@ function config(string $name, bool $getShared = true)
 
 //--------------------------------------------------------------------
 
+if (! function_exists('db_connnect'))
+{
+	/**
+	 * Grabs a database connection and returns it to the user.
+	 *
+	 * This is a convenience wrapper for \Config\Database::connect()
+	 * and supports the same parameters. Namely:
+	 *
+	 * When passing in $db, you may pass any of the following to connect:
+	 * - group name
+	 * - existing connection instance
+	 * - array of database configuration values
+	 *
+	 * If $getShared === false then a new connection instance will be provided,
+	 * otherwise it will all calls will return the same instance.
+	 *
+	 * @param \CodeIgniter\Database\ConnectionInterface|array|string $db
+	 * @param bool                                                   $getShared
+	 *
+	 * @return \CodeIgniter\Database\BaseConnection
+	 */
+	function db_connect($db, bool $getShared = true)
+	{
+		return \Config\Database::connect($db, $getShared);
+	}
+}
+
+//--------------------------------------------------------------------
+
 if (! function_exists('view'))
 {
 	/**

user_guide_src/source/database/connecting.rst

@@ -14,6 +14,11 @@ If the above function does **not** contain any information in the first
 parameter it will connect to the default group specified in your database config
 file. For most people, this is the preferred method of use.
 
+A convenience method exists that is purely a wrapper around the above line
+and is provided for your convenience::
+
+    $db = db_connect();
+
 Available Parameters
 --------------------
 
@@ -89,7 +94,7 @@ the same format as the groups are defined in the configuration file::
 		'failover' => [],
 		'port'     => 3306,
 	];
-    $db = \Config\Database::connect($custom); 
+    $db = \Config\Database::connect($custom);
 
 
 Reconnecting / Keeping the Connection Alive