initial commit

lib/symfony/database/sfDatabaseManager.class.php

@@ -0,0 +1,79 @@
+<?php
+
+/*
+ * This file is part of the symfony package.
+ * (c) 2004-2006 Fabien Potencier <fabien.potencier@symfony-project.com>
+ * (c) 2004-2006 Sean Kerr.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+/**
+ * sfDatabaseManager allows you to setup your database connectivity before the
+ * request is handled. This eliminates the need for a filter to manage database
+ * connections.
+ *
+ * @package    symfony
+ * @subpackage database
+ * @author     Fabien Potencier <fabien.potencier@symfony-project.com>
+ * @author     Sean Kerr <skerr@mojavi.org>
+ * @version    SVN: $Id: sfDatabaseManager.class.php 3210 2007-01-10 20:28:16Z fabien $
+ */
+class sfDatabaseManager
+{
+  protected
+    $databases = array();
+
+  /**
+   * Retrieves the database connection associated with this sfDatabase implementation.
+   *
+   * @param string A database name
+   *
+   * @return mixed A Database instance
+   *
+   * @throws <b>sfDatabaseException</b> If the requested database name does not exist
+   */
+  public function getDatabase($name = 'default')
+  {
+    if (isset($this->databases[$name]))
+    {
+      return $this->databases[$name];
+    }
+
+    // nonexistent database name
+    $error = 'Database "%s" does not exist';
+    $error = sprintf($error, $name);
+
+    throw new sfDatabaseException($error);
+  }
+
+  /**
+   * Initializes this sfDatabaseManager object
+   *
+   * @return bool true, if initialization completes successfully, otherwise false
+   *
+   * @throws <b>sfInitializationException</b> If an error occurs while initializing this sfDatabaseManager object
+   */
+  public function initialize()
+  {
+    // load database configuration
+    require(sfConfigCache::getInstance()->checkConfig(sfConfig::get('sf_app_config_dir_name').'/databases.yml'));
+  }
+
+  /**
+   * Executes the shutdown procedure
+   *
+   * @return void
+   *
+   * @throws <b>sfDatabaseException</b> If an error occurs while shutting down this DatabaseManager
+   */
+  public function shutdown()
+  {
+    // loop through databases and shutdown connections
+    foreach ($this->databases as $database)
+    {
+      $database->shutdown();
+    }
+  }
+}