more 2.0 changes

laravel/db.php

@@ -15,6 +15,14 @@ class DB {
 	 *
 	 * Note: Database connections are managed as singletons.
 	 *
+	 * <code>
+	 *		// Get the default database connection
+	 *		$connection = DB::connection();
+	 *
+	 *		// Get a specific database connection
+	 *		$connection = DB::connection('mysql');
+	 * </code>
+	 *
 	 * @param  string         $connection
 	 * @return DB\Connection
 	 */
@@ -29,7 +37,9 @@ class DB {
 				throw new \Exception("Database connection [$connection] is not defined.");
 			}
 
-			static::$connections[$connection] = new DB\Connection($connection, (object) $config, new DB\Connector);
+			$connector = DB\Connector\Factory::make($config['driver']);
+
+			static::$connections[$connection] = DB\Connection\Factory::make($connection, $config, $connector);
 		}
 
 		return static::$connections[$connection];
@@ -38,6 +48,19 @@ class DB {
 	/**
 	 * Begin a fluent query against a table.
 	 *
+	 * This method primarily serves as a short-cut to the $connection->table() method.
+	 *
+	 * <code>
+	 *		// Begin a fluent query against the "users" table
+	 *		$query = DB::table('users');
+	 *
+	 *		// Equivalent call using the connection table method.
+	 *		$query = DB::connection()->table('users');
+	 *
+	 *		// Begin a fluent query against the "users" table for a specific connection
+	 *		$query = DB::table('users', 'mysql');
+	 * </code>
+	 *
 	 * @param  string    $table
 	 * @param  string    $connection
 	 * @return DB\Query
@@ -49,6 +72,16 @@ class DB {
 
 	/**
 	 * Magic Method for calling methods on the default database connection.
+	 *
+	 * This provides a convenient API for querying or examining the default database connection.
+	 *
+	 * <code>
+	 *		// Run a query against the default database connection
+	 *		$results = DB::query('select * from users');
+	 *
+	 *		// Equivalent call using the connection instance
+	 *		$results = DB::connection()->query('select * from users');
+	 * </code>
 	 */
 	public static function __callStatic($method, $parameters)
 	{