laravel/system/db.php

<?php namespace System;

class DB {

	/**
	 * The active database connections.
	 *
	 * @var array
	 */
	private static $connections = array();

	/**
	 * Get a database connection.
	 *
	 * @param  string  $connection
	 * @return PDO
	 */
	public static function connection($connection = null)
	{
		// ---------------------------------------------------
		// If no connection was given, use the default.
		// ---------------------------------------------------
		if (is_null($connection))
		{
			$connection = Config::get('db.default');
		}

		// ---------------------------------------------------
		// If we have already established this connection,
		// simply return the existing connection.
		// ---------------------------------------------------
		if ( ! array_key_exists($connection, static::$connections))
		{
			// ---------------------------------------------------
			// Get the database configurations.
			// ---------------------------------------------------
			$config = Config::get('db.connections');

			// ---------------------------------------------------
			// Verify the connection has been defined.
			// ---------------------------------------------------
			if ( ! array_key_exists($connection, $config))
			{
				throw new \Exception("Database connection [$connection] is not defined.");
			}

			// ---------------------------------------------------
			// Establish the database connection.
			// ---------------------------------------------------
			static::$connections[$connection] = DB\Connector::connect((object) $config[$connection]);
		}

		return static::$connections[$connection];
	}

	/**
	 * Execute a SQL query against the connection.
	 *
	 * @param  string  $sql
	 * @param  array   $bindings
	 * @param  string  $connection
	 * @return mixed
	 */
	public static function query($sql, $bindings = array(), $connection = null)
	{
		// ---------------------------------------------------
		// Create a new PDO statement from the SQL.
		// ---------------------------------------------------
		$query = static::connection($connection)->prepare($sql);

		// ---------------------------------------------------
		// Execute the query with the bindings.
		// ---------------------------------------------------
		$result = $query->execute($bindings);

		// ---------------------------------------------------
		// For SELECT statements, return the results in an
		// array of stdClasses.
		//
		// For UPDATE and DELETE statements, return the number
		// or rows affected by the query.
		//
		// For INSERT statements, return a boolean.
		// ---------------------------------------------------
		if (strpos(Str::upper($sql), 'SELECT') === 0)
		{
			return $query->fetchAll(\PDO::FETCH_CLASS, 'stdClass');
		}
		elseif (strpos(Str::upper($sql), 'UPDATE') === 0 or strpos(Str::upper($sql), 'DELETE') === 0)
		{
			return $query->rowCount();
		}
		else
		{
			return $result;
		}
	}

	/**
	 * Begin a fluent query against a table.
	 *
	 * @param  string  $table
	 * @param  string  $connection
	 * @return Query
	 */
	public static function table($table, $connection = null)
	{
		return new DB\Query($table, $connection);
	}

}