my-simon 0.0.0 → 0.0.1

data/www/lib/php/plugins/php-activerecord/lib/Connection.php

@@ -0,0 +1,456 @@
+<?php
+/**
+ * @package ActiveRecord
+ */
+namespace ActiveRecord;
+
+require 'Column.php';
+
+use PDO;
+use PDOException;
+use Closure;
+
+/**
+ * The base class for database connection adapters.
+ *
+ * @package ActiveRecord
+ */
+abstract class Connection
+{
+	/**
+	 * The PDO connection object.
+	 * @var mixed
+	 */
+	public $connection;
+
+	/**
+	 * The last query run.
+	 * @var string
+	 */
+	public $last_query;
+
+	/**
+	 * Switch for logging.
+	 *
+	 * @var bool
+	 */
+	 private $logging = false;
+
+	/**
+	 * Contains a Logger object that must impelement a log() method.
+	 *
+	 * @var object
+	 */
+	private $logger;
+
+	/**
+	 * Default PDO options to set for each connection.
+	 * @var array
+	 */
+	static $PDO_OPTIONS = array(
+		PDO::ATTR_CASE				=> PDO::CASE_LOWER,
+		PDO::ATTR_ERRMODE			=> PDO::ERRMODE_EXCEPTION,
+		PDO::ATTR_ORACLE_NULLS		=> PDO::NULL_NATURAL,
+		PDO::ATTR_STRINGIFY_FETCHES	=> false);
+
+	/**
+	 * The quote character for stuff like column and field names.
+	 * @var string
+	 */
+	static $QUOTE_CHARACTER = '`';
+
+	/**
+	 * Default port.
+	 * @var int
+	 */
+	static $DEFAULT_PORT = 0;
+
+	/**
+	 * Retrieve a database connection.
+	 *
+	 * @param string $connection_string_or_connection_name A database connection string (ex. mysql://user:pass@host[:port]/dbname)
+	 *   Everything after the protocol:// part is specific to the connection adapter.
+	 *   OR
+	 *   A connection name that is set in ActiveRecord\Config
+	 *   If null it will use the default connection specified by ActiveRecord\Config->set_default_connection
+	 * @return Connection
+	 * @see parse_connection_url
+	 */
+	public static function instance($connection_string_or_connection_name=null)
+	{
+		$config = Config::instance();
+
+		if (strpos($connection_string_or_connection_name,'://') === false)
+		{
+			$connection_string = $connection_string_or_connection_name ?
+				$config->get_connection($connection_string_or_connection_name) :
+				$config->get_default_connection_string();
+		}
+		else
+			$connection_string = $connection_string_or_connection_name;
+
+		if (!$connection_string)
+			throw new DatabaseException("Empty connection string");
+
+		$info = static::parse_connection_url($connection_string);
+		$fqclass = static::load_adapter_class($info->protocol);
+
+		try {
+			$connection = new $fqclass($info);
+			$connection->protocol = $info->protocol;
+			$connection->logging = $config->get_logging();
+			$connection->logger = $connection->logging ? $config->get_logger() : null;
+		} catch (PDOException $e) {
+			throw new DatabaseException($e);
+		}
+		return $connection;
+	}
+
+	/**
+	 * Loads the specified class for an adapter.
+	 *
+	 * @param string $adapter Name of the adapter.
+	 * @return string The full name of the class including namespace.
+	 */
+	private static function load_adapter_class($adapter)
+	{
+		$class = ucwords($adapter) . 'Adapter';
+		$fqclass = 'ActiveRecord\\' . $class;
+		$source = dirname(__FILE__) . "/adapters/$class.php";
+
+		if (!file_exists($source))
+			throw new DatabaseException("$fqclass not found!");
+
+		require_once($source);
+		return $fqclass;
+	}
+
+	/**
+	 * Use this for any adapters that can take connection info in the form below
+	 * to set the adapters connection info.
+	 *
+	 * <code>
+	 * protocol://username:password@host[:port]/dbname
+	 * protocol://urlencoded%20username:urlencoded%20password@host[:port]/dbname?decode=true
+	 * protocol://username:password@unix(/some/file/path)/dbname
+	 * </code>
+	 *
+	 * @param string $connection_url A connection URL
+	 * @return object the parsed URL as an object.
+	 */
+	public static function parse_connection_url($connection_url)
+	{
+		$url = @parse_url($connection_url);
+
+		if (!isset($url['host']))
+			throw new DatabaseException('Database host must be specified in the connection string.');
+
+		$info = new \stdClass();
+		$info->protocol = $url['scheme'];
+		$info->host		= $url['host'];
+		$info->db		= isset($url['path']) ? substr($url['path'],1) : null;
+		$info->user		= isset($url['user']) ? $url['user'] : null;
+		$info->pass		= isset($url['pass']) ? $url['pass'] : null;
+
+		if ($info->host == 'unix(')
+		{
+			$socket_database = $info->host . '/' . $info->db;
+
+			if (preg_match_all('/^unix\((.+)\)\/(.+)$/', $socket_database, $matches) > 0)
+			{
+				$info->host = $matches[1][0];
+				$info->db = $matches[2][0];
+			}
+		}
+
+		if (isset($url['port']))
+			$info->port = $url['port'];
+
+		if (strpos($connection_url,'decode=true') !== false)
+		{
+			if ($info->user)
+				$info->user = urldecode($info->user);
+
+			if ($info->pass)
+				$info->pass = urldecode($info->pass);
+		}
+
+		return $info;
+	}
+
+	/**
+	 * Class Connection is a singleton. Access it via instance().
+	 *
+	 * @param array $info Array containing URL parts
+	 * @return Connection
+	 */
+	protected function __construct($info)
+	{
+		try
+		{
+			// unix sockets start with a /
+			if ($info->host[0] != '/')
+			{
+				$host = "host=$info->host";
+
+				if (isset($info->port))
+					$host .= ";port=$info->port";
+			}
+			else
+				$host = "unix_socket=$info->host";
+
+			$this->connection = new PDO("$info->protocol:$host;dbname=$info->db",$info->user,$info->pass,static::$PDO_OPTIONS);
+		} catch (PDOException $e) {
+			throw new DatabaseException($e);
+		}
+	}
+
+	/**
+	 * Retrieves column meta data for the specified table.
+	 *
+	 * @param string $table Name of a table
+	 * @return array An array of {@link Column} objects.
+	 */
+	public function columns($table)
+	{
+		$columns = array();
+		$sth = $this->query_column_info($table);
+
+		while (($row = $sth->fetch()))
+		{
+			$c = $this->create_column($row);
+			$columns[$c->name] = $c;
+		}
+		return $columns;
+	}
+
+	/**
+	 * Escapes quotes in a string.
+	 *
+	 * @param string $string The string to be quoted.
+	 * @return string The string with any quotes in it properly escaped.
+	 */
+	public function escape($string)
+	{
+		return $this->connection->quote($string);
+	}
+
+	/**
+	 * Retrieve the insert id of the last model saved.
+	 *
+	 * @param string $sequence Optional name of a sequence to use
+	 * @return int
+	 */
+	public function insert_id($sequence=null)
+	{
+		return $this->connection->lastInsertId($sequence);
+	}
+
+	/**
+	 * Execute a raw SQL query on the database.
+	 *
+	 * @param string $sql Raw SQL string to execute.
+	 * @param array &$values Optional array of bind values
+	 * @return mixed A result set object
+	 */
+	public function query($sql, &$values=array())
+	{
+		if ($this->logging)
+			$this->logger->log($sql);
+
+		$this->last_query = $sql;
+
+		try {
+			if (!($sth = $this->connection->prepare($sql)))
+				throw new DatabaseException($this);
+		} catch (PDOException $e) {
+			throw new DatabaseException($this);
+		}
+
+		$sth->setFetchMode(PDO::FETCH_ASSOC);
+
+		try {
+			if (!$sth->execute($values))
+				throw new DatabaseException($this);
+		} catch (PDOException $e) {
+			throw new DatabaseException($sth);
+		}
+		return $sth;
+	}
+
+	/**
+	 * Execute a query that returns maximum of one row with one field and return it.
+	 *
+	 * @param string $sql Raw SQL string to execute.
+	 * @param array &$values Optional array of values to bind to the query.
+	 * @return string
+	 */
+	public function query_and_fetch_one($sql, &$values=array())
+	{
+		$sth = $this->query($sql,$values);
+		$row = $sth->fetch(PDO::FETCH_NUM);
+		return $row[0];
+	}
+
+	/**
+	 * Execute a raw SQL query and fetch the results.
+	 *
+	 * @param string $sql Raw SQL string to execute.
+	 * @param Closure $handler Closure that will be passed the fetched results.
+	 */
+	public function query_and_fetch($sql, Closure $handler)
+	{
+		$sth = $this->query($sql);
+
+		while (($row = $sth->fetch(PDO::FETCH_ASSOC)))
+			$handler($row);
+	}
+
+	/**
+	 * Returns all tables for the current database.
+	 *
+	 * @return array Array containing table names.
+	 */
+	public function tables()
+	{
+		$tables = array();
+		$sth = $this->query_for_tables();
+
+		while (($row = $sth->fetch(PDO::FETCH_NUM)))
+			$tables[] = $row[0];
+
+		return $tables;
+	}
+
+	/**
+	 * Starts a transaction.
+	 */
+	public function transaction()
+	{
+		if (!$this->connection->beginTransaction())
+			throw new DatabaseException($this);
+	}
+
+	/**
+	 * Commits the current transaction.
+	 */
+	public function commit()
+	{
+		if (!$this->connection->commit())
+			throw new DatabaseException($this);
+	}
+
+	/**
+	 * Rollback a transaction.
+	 */
+	public function rollback()
+	{
+		if (!$this->connection->rollback())
+			throw new DatabaseException($this);
+	}
+
+	/**
+	 * Tells you if this adapter supports sequences or not.
+	 *
+	 * @return boolean
+	 */
+	function supports_sequences() { return false; }
+
+	/**
+	 * Return a default sequence name for the specified table.
+	 *
+	 * @param string $table Name of a table
+	 * @param string $column_name Name of column sequence is for
+	 * @return string sequence name or null if not supported.
+	 */
+	public function get_sequence_name($table, $column_name)
+	{
+		return "{$table}_seq";
+	}
+
+	/**
+	 * Return SQL for getting the next value in a sequence.
+	 *
+	 * @param string $sequence_name Name of the sequence
+	 * @return string
+	 */
+	public function next_sequence_value($sequence_name) { return null; }
+
+	/**
+	 * Quote a name like table names and field names.
+	 *
+	 * @param string $string String to quote.
+	 * @return string
+	 */
+	public function quote_name($string)
+	{
+		return $string[0] === static::$QUOTE_CHARACTER || $string[strlen($string)-1] === static::$QUOTE_CHARACTER ?
+			$string : static::$QUOTE_CHARACTER . $string . static::$QUOTE_CHARACTER;
+	}
+
+	/**
+	 * Return a date time formatted into the database's date format.
+	 *
+	 * @param DateTime $datetime The DateTime object
+	 * @return string
+	 */
+	public function date_to_string($datetime)
+	{
+		return $datetime->format('Y-m-d');
+	}
+
+	/**
+	 * Return a date time formatted into the database's datetime format.
+	 *
+	 * @param DateTime $datetime The DateTime object
+	 * @return string
+	 */
+	public function datetime_to_string($datetime)
+	{
+		return $datetime->format('Y-m-d H:i:s T');
+	}
+
+	/**
+	 * Converts a string representation of a datetime into a DateTime object.
+	 *
+	 * @param string $string A datetime in the form accepted by date_create()
+	 * @return DateTime
+	 */
+	public function string_to_datetime($string)
+	{
+		$date = date_create($string);
+		$errors = \DateTime::getLastErrors();
+
+		if ($errors['warning_count'] > 0 || $errors['error_count'] > 0)
+			return null;
+
+		return new DateTime($date->format('Y-m-d H:i:s T'));
+	}
+
+	/**
+	 * Adds a limit clause to the SQL query.
+	 *
+	 * @param string $sql The SQL statement.
+	 * @param int $offset Row offset to start at.
+	 * @param int $limit Maximum number of rows to return.
+	 * @return string The SQL query that will limit results to specified parameters
+	 */
+	abstract function limit($sql, $offset, $limit);
+
+	/**
+	 * Query for column meta info and return statement handle.
+	 *
+	 * @param string $table Name of a table
+	 * @return PDOStatement
+	 */
+	abstract public function query_column_info($table);
+
+	/**
+	 * Query for all tables in the current database. The result must only
+	 * contain one column which has the name of the table.
+	 *
+	 * @return PDOStatement
+	 */
+	abstract function query_for_tables();
+};
+?>

data/www/lib/php/plugins/php-activerecord/lib/ConnectionManager.php

@@ -0,0 +1,38 @@
+<?php
+/**
+ * @package ActiveRecord
+ */
+namespace ActiveRecord;
+
+/**
+ * Singleton to manage any and all database connections.
+ *
+ * @package ActiveRecord
+ */
+class ConnectionManager extends Singleton
+{
+	/**
+	 * Array of {@link Connection} objects.
+	 * @var array
+	 */
+	static private $connections = array();
+
+	/**
+	 * If $name is null then the default connection will be returned.
+	 *
+	 * @see Config
+	 * @param string $name Optional name of a connection
+	 * @return Connection
+	 */
+	public static function get_connection($name=null)
+	{
+		if (!isset(self::$connections[$name]) || !self::$connections[$name]->connection)
+		{
+			$config = Config::instance();
+			$connection_string = $name ? $config->get_connection($name) : $config->get_default_connection();
+			self::$connections[$name] = Connection::instance($connection_string);
+		}
+		return self::$connections[$name];
+	}
+};
+?>

data/www/lib/php/plugins/php-activerecord/lib/DateTime.php

@@ -0,0 +1,45 @@
+<?php
+namespace ActiveRecord;
+
+class DateTime extends \DateTime
+{
+	private $model;
+	private $attribute_name;
+
+	public function attribute_of($model, $attribute_name)
+	{
+		$this->model = $model;
+		$this->attribute_name = $attribute_name;
+	}
+
+	private function flag_dirty()
+	{
+		if ($this->model)
+			$this->model->flag_dirty($this->attribute_name);
+	}
+
+	public function setDate($year, $month, $day)
+	{
+		$this->flag_dirty();
+		call_user_func_array(array($this,'parent::setDate'),func_get_args());
+	}
+
+	public function setISODate($year, $week , $day=null)
+	{
+		$this->flag_dirty();
+		call_user_func_array(array($this,'parent::setISODate'),func_get_args());
+	}
+
+	public function setTime($hour, $minute, $second=null)
+	{
+		$this->flag_dirty();
+		call_user_func_array(array($this,'parent::setTime'),func_get_args());
+	}
+
+	public function setTimestamp($unixtimestamp)
+	{
+		$this->flag_dirty();
+		call_user_func_array(array($this,'parent::setTimestamp'),func_get_args());
+	}
+}
+?>

data/www/lib/php/plugins/php-activerecord/lib/Exceptions.php

@@ -0,0 +1,137 @@
+<?php
+/**
+ * @package ActiveRecord
+ */
+namespace ActiveRecord;
+
+/**
+ * Generic base exception for all ActiveRecord specific errors.
+ *
+ * @package ActiveRecord
+ */
+class ActiveRecordException extends \Exception {};
+
+/**
+ * Thrown when a record cannot be found.
+ *
+ * @package ActiveRecord
+ */
+class RecordNotFound extends ActiveRecordException {};
+
+/**
+ * Thrown when there was an error performing a database operation.
+ *
+ * The error will be specific to whatever database you are running.
+ *
+ * @package ActiveRecord
+ */
+class DatabaseException extends ActiveRecordException
+{
+	public function __construct($adapter_or_string_or_mystery)
+	{
+		if ($adapter_or_string_or_mystery instanceof Connection)
+		{
+			parent::__construct(
+				join(", ",$adapter_or_string_or_mystery->connection->errorInfo()),
+				intval($adapter_or_string_or_mystery->connection->errorCode()));
+		}
+		elseif ($adapter_or_string_or_mystery instanceof \PDOStatement)
+		{
+			parent::__construct(
+				join(", ",$adapter_or_string_or_mystery->errorInfo()),
+				intval($adapter_or_string_or_mystery->errorCode()));
+		}
+		else
+			parent::__construct($adapter_or_string_or_mystery);
+	}
+};
+
+/**
+ * Thrown by {@link Model}.
+ *
+ * @package ActiveRecord
+ */
+class ModelException extends ActiveRecordException {};
+
+/**
+ * Thrown by {@link Expressions}.
+ *
+ * @package ActiveRecord
+ */
+class ExpressionsException extends ActiveRecordException {};
+
+/**
+ * Thrown for configuration problems.
+ *
+ * @package ActiveRecord
+ */
+class ConfigException extends ActiveRecordException {};
+
+/**
+ * Thrown when attempting to access an invalid property on a {@link Model}.
+ *
+ * @package ActiveRecord
+ */
+class UndefinedPropertyException extends ModelException
+{
+	/**
+	 * Sets the exception message to show the undefined property's name.
+	 *
+	 * @param str $property_name name of undefined property
+	 * @return void
+	 */
+	public function __construct($class_name, $property_name)
+	{
+		if (is_array($property_name))
+		{
+			$this->message = implode("\r\n", $property_name);
+			return;
+		}
+
+		$this->message = "Undefined property: {$class_name}->{$property_name} in {$this->file} on line {$this->line}";
+		parent::__construct();
+	}
+};
+
+/**
+ * Thrown when attempting to perform a write operation on a {@link Model} that is in read-only mode.
+ *
+ * @package ActiveRecord
+ */
+class ReadOnlyException extends ModelException
+{
+	/**
+	 * Sets the exception message to show the undefined property's name.
+	 *
+	 * @param str $class_name name of the model that is read only
+	 * @param str $method_name name of method which attempted to modify the model
+	 * @return void
+	 */
+	public function __construct($class_name, $method_name)
+	{
+		$this->message = "{$class_name}::{$method_name}() cannot be invoked because this model is set to read only";
+		parent::__construct();
+	}
+};
+
+/**
+ * Thrown for validations exceptions.
+ *
+ * @package ActiveRecord
+ */
+class ValidationsArgumentError extends ActiveRecordException {};
+
+/**
+ * Thrown for relationship exceptions.
+ *
+ * @package ActiveRecord
+ */
+class RelationshipException extends ActiveRecordException {};
+
+/**
+ * Thrown for has many thru exceptions.
+ *
+ * @package ActiveRecord
+ */
+class HasManyThroughAssociationException extends RelationshipException {};
+?>