mirror of
				https://github.com/yiisoft/yii2.git
				synced 2025-11-04 06:37:55 +08:00 
			
		
		
		
	w
This commit is contained in:
		@ -1,34 +1,33 @@
 | 
			
		||||
<?php
 | 
			
		||||
/**
 | 
			
		||||
 * This file contains the CDbCommand class.
 | 
			
		||||
 * This file contains the Command class.
 | 
			
		||||
 *
 | 
			
		||||
 * @author Qiang Xue <qiang.xue@gmail.com>
 | 
			
		||||
 * @link http://www.yiiframework.com/
 | 
			
		||||
 * @copyright Copyright © 2008-2011 Yii Software LLC
 | 
			
		||||
 * @copyright Copyright © 2008-2012 Yii Software LLC
 | 
			
		||||
 * @license http://www.yiiframework.com/license/
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * CDbCommand represents an SQL statement to execute against a database.
 | 
			
		||||
 * Command represents a SQL statement to be executed against a database.
 | 
			
		||||
 *
 | 
			
		||||
 * It is usually created by calling {@link CDbConnection::createCommand}.
 | 
			
		||||
 * The SQL statement to be executed may be set via {@link setText Text}.
 | 
			
		||||
 * A command object is usually created by calling [[Connection::createCommand]].
 | 
			
		||||
 * The SQL statement it represents can be set via the [[text]] property.
 | 
			
		||||
 *
 | 
			
		||||
 * To execute a non-query SQL (such as insert, delete, update), call
 | 
			
		||||
 * {@link execute}. To execute an SQL statement that returns result data set
 | 
			
		||||
 * (such as SELECT), use {@link query} or its convenient versions {@link queryRow},
 | 
			
		||||
 * {@link queryColumn}, or {@link queryScalar}.
 | 
			
		||||
 * To execute a non-query SQL (such as insert, delete, update), call [[execute]].
 | 
			
		||||
 * To execute an SQL statement that returns result data set (such as SELECT),
 | 
			
		||||
 * use [[query]], [[queryRow]], [[queryColumn]], or [[queryScalar]].
 | 
			
		||||
 *
 | 
			
		||||
 * If an SQL statement returns results (such as a SELECT SQL), the results
 | 
			
		||||
 * can be accessed via the returned {@link CDbDataReader}.
 | 
			
		||||
 *
 | 
			
		||||
 * CDbCommand supports SQL statment preparation and parameter binding.
 | 
			
		||||
 * Command supports SQL statment preparation and parameter binding.
 | 
			
		||||
 * Call {@link bindParam} to bind a PHP variable to a parameter in SQL.
 | 
			
		||||
 * Call {@link bindValue} to bind a value to an SQL parameter.
 | 
			
		||||
 * When binding a parameter, the SQL statement is automatically prepared.
 | 
			
		||||
 * You may also call {@link prepare} to explicitly prepare an SQL statement.
 | 
			
		||||
 *
 | 
			
		||||
 * Starting from version 1.1.6, CDbCommand can also be used as a query builder
 | 
			
		||||
 * Starting from version 1.1.6, Command can also be used as a query builder
 | 
			
		||||
 * that builds a SQL statement from code fragments. For example,
 | 
			
		||||
 * <pre>
 | 
			
		||||
 * $user = Yii::app()->db->createCommand()
 | 
			
		||||
@ -39,11 +38,9 @@
 | 
			
		||||
 * </pre>
 | 
			
		||||
 *
 | 
			
		||||
 * @author Qiang Xue <qiang.xue@gmail.com>
 | 
			
		||||
 * @version $Id: CDbCommand.php 3240 2011-05-25 19:22:47Z qiang.xue $
 | 
			
		||||
 * @package system.db
 | 
			
		||||
 * @since 1.0
 | 
			
		||||
 * @since 2.0
 | 
			
		||||
 */
 | 
			
		||||
class CDbCommand extends CComponent
 | 
			
		||||
class Command extends CComponent
 | 
			
		||||
{
 | 
			
		||||
	/**
 | 
			
		||||
	 * @var array the parameters (name=>value) to be bound to the current query.
 | 
			
		||||
@ -104,7 +101,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	/**
 | 
			
		||||
	 * Set the default fetch mode for this statement
 | 
			
		||||
	 * @param mixed $mode fetch mode
 | 
			
		||||
	 * @return CDbCommand
 | 
			
		||||
	 * @return Command
 | 
			
		||||
	 * @see http://www.php.net/manual/en/function.PDOStatement-setFetchMode.php
 | 
			
		||||
	 * @since 1.1.7
 | 
			
		||||
	 */
 | 
			
		||||
@ -120,7 +117,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * This method is mainly used when a command object is being reused
 | 
			
		||||
	 * multiple times for building different queries.
 | 
			
		||||
	 * Calling this method will clean up all internal states of the command object.
 | 
			
		||||
	 * @return CDbCommand this command instance
 | 
			
		||||
	 * @return Command this command instance
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function reset()
 | 
			
		||||
@ -147,7 +144,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * Specifies the SQL statement to be executed.
 | 
			
		||||
	 * Any previous execution will be terminated or cancel.
 | 
			
		||||
	 * @param string $value the SQL statement to be executed
 | 
			
		||||
	 * @return CDbCommand this command instance
 | 
			
		||||
	 * @return Command this command instance
 | 
			
		||||
	 */
 | 
			
		||||
	public function setText($value)
 | 
			
		||||
	{
 | 
			
		||||
@ -194,9 +191,9 @@ class CDbCommand extends CComponent
 | 
			
		||||
			}
 | 
			
		||||
			catch(Exception $e)
 | 
			
		||||
			{
 | 
			
		||||
				Yii::log('Error in preparing SQL: ' . $this->getText(), CLogger::LEVEL_ERROR, 'system.db.CDbCommand');
 | 
			
		||||
				Yii::log('Error in preparing SQL: ' . $this->getText(), CLogger::LEVEL_ERROR, 'system.db.Command');
 | 
			
		||||
                $errorInfo = $e instanceof PDOException ? $e->errorInfo : null;
 | 
			
		||||
				throw new CDbException(Yii::t('yii', 'CDbCommand failed to prepare the SQL statement: {error}',
 | 
			
		||||
				throw new CDbException(Yii::t('yii', 'Command failed to prepare the SQL statement: {error}',
 | 
			
		||||
					array('{error}' => $e->getMessage())), (int)$e->getCode(), $errorInfo);
 | 
			
		||||
			}
 | 
			
		||||
		}
 | 
			
		||||
@ -220,7 +217,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * @param integer $dataType SQL data type of the parameter. If null, the type is determined by the PHP type of the value.
 | 
			
		||||
	 * @param integer $length length of the data type
 | 
			
		||||
	 * @param mixed $driverOptions the driver-specific options (this is available since version 1.1.6)
 | 
			
		||||
	 * @return CDbCommand the current command being executed (this is available since version 1.0.8)
 | 
			
		||||
	 * @return Command the current command being executed (this is available since version 1.0.8)
 | 
			
		||||
	 * @see http://www.php.net/manual/en/function.PDOStatement-bindParam.php
 | 
			
		||||
	 */
 | 
			
		||||
	public function bindParam($name, &$value, $dataType = null, $length = null, $driverOptions = null)
 | 
			
		||||
@ -246,7 +243,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * placeholders, this will be the 1-indexed position of the parameter.
 | 
			
		||||
	 * @param mixed $value The value to bind to the parameter
 | 
			
		||||
	 * @param integer $dataType SQL data type of the parameter. If null, the type is determined by the PHP type of the value.
 | 
			
		||||
	 * @return CDbCommand the current command being executed (this is available since version 1.0.8)
 | 
			
		||||
	 * @return Command the current command being executed (this is available since version 1.0.8)
 | 
			
		||||
	 * @see http://www.php.net/manual/en/function.PDOStatement-bindValue.php
 | 
			
		||||
	 */
 | 
			
		||||
	public function bindValue($name, $value, $dataType = null)
 | 
			
		||||
@ -267,7 +264,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * @param array $values the values to be bound. This must be given in terms of an associative
 | 
			
		||||
	 * array with array keys being the parameter names, and array values the corresponding parameter values.
 | 
			
		||||
	 * For example, <code>array(':name'=>'John', ':age'=>25)</code>.
 | 
			
		||||
	 * @return CDbCommand the current command being executed
 | 
			
		||||
	 * @return Command the current command being executed
 | 
			
		||||
	 * @since 1.1.5
 | 
			
		||||
	 */
 | 
			
		||||
	public function bindValues($values)
 | 
			
		||||
@ -305,11 +302,11 @@ class CDbCommand extends CComponent
 | 
			
		||||
		}
 | 
			
		||||
		else
 | 
			
		||||
			$par = '';
 | 
			
		||||
		Yii::trace('Executing SQL: ' . $this->getText() . $par, 'system.db.CDbCommand');
 | 
			
		||||
		Yii::trace('Executing SQL: ' . $this->getText() . $par, 'system.db.Command');
 | 
			
		||||
		try
 | 
			
		||||
		{
 | 
			
		||||
			if ($this->_connection->enableProfiling)
 | 
			
		||||
				Yii::beginProfile('system.db.CDbCommand.execute(' . $this->getText() . ')', 'system.db.CDbCommand.execute');
 | 
			
		||||
				Yii::beginProfile('system.db.Command.execute(' . $this->getText() . ')', 'system.db.Command.execute');
 | 
			
		||||
 | 
			
		||||
			$this->prepare();
 | 
			
		||||
			if ($params === array())
 | 
			
		||||
@ -319,21 +316,21 @@ class CDbCommand extends CComponent
 | 
			
		||||
			$n = $this->_statement->rowCount();
 | 
			
		||||
 | 
			
		||||
			if ($this->_connection->enableProfiling)
 | 
			
		||||
				Yii::endProfile('system.db.CDbCommand.execute(' . $this->getText() . ')', 'system.db.CDbCommand.execute');
 | 
			
		||||
				Yii::endProfile('system.db.Command.execute(' . $this->getText() . ')', 'system.db.Command.execute');
 | 
			
		||||
 | 
			
		||||
			return $n;
 | 
			
		||||
		}
 | 
			
		||||
		catch(Exception $e)
 | 
			
		||||
		{
 | 
			
		||||
			if ($this->_connection->enableProfiling)
 | 
			
		||||
				Yii::endProfile('system.db.CDbCommand.execute(' . $this->getText() . ')', 'system.db.CDbCommand.execute');
 | 
			
		||||
				Yii::endProfile('system.db.Command.execute(' . $this->getText() . ')', 'system.db.Command.execute');
 | 
			
		||||
            $errorInfo = $e instanceof PDOException ? $e->errorInfo : null;
 | 
			
		||||
            $message = $e->getMessage();
 | 
			
		||||
			Yii::log(Yii::t('yii', 'CDbCommand::execute() failed: {error}. The SQL statement executed was: {sql}.',
 | 
			
		||||
				array('{error}' => $message, '{sql}' => $this->getText() . $par)), CLogger::LEVEL_ERROR, 'system.db.CDbCommand');
 | 
			
		||||
			Yii::log(Yii::t('yii', 'Command::execute() failed: {error}. The SQL statement executed was: {sql}.',
 | 
			
		||||
				array('{error}' => $message, '{sql}' => $this->getText() . $par)), CLogger::LEVEL_ERROR, 'system.db.Command');
 | 
			
		||||
            if (YII_DEBUG)
 | 
			
		||||
            	$message .= '. The SQL statement executed was: ' . $this->getText() . $par;
 | 
			
		||||
			throw new CDbException(Yii::t('yii', 'CDbCommand failed to execute the SQL statement: {error}',
 | 
			
		||||
			throw new CDbException(Yii::t('yii', 'Command failed to execute the SQL statement: {error}',
 | 
			
		||||
				array('{error}' => $message)), (int)$e->getCode(), $errorInfo);
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
@ -458,7 +455,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
		else
 | 
			
		||||
			$par = '';
 | 
			
		||||
 | 
			
		||||
		Yii::trace('Querying SQL: ' . $this->getText() . $par, 'system.db.CDbCommand');
 | 
			
		||||
		Yii::trace('Querying SQL: ' . $this->getText() . $par, 'system.db.Command');
 | 
			
		||||
 | 
			
		||||
		if ($this->_connection->queryCachingCount > 0 && $method !== ''
 | 
			
		||||
				&& $this->_connection->queryCachingDuration > 0
 | 
			
		||||
@ -470,7 +467,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
			$cacheKey .= ':' . $this->getText() . ':' . serialize(array_merge($this->_paramLog, $params));
 | 
			
		||||
			if (($result = $cache->get($cacheKey)) !== false)
 | 
			
		||||
			{
 | 
			
		||||
				Yii::trace('Query result found in cache', 'system.db.CDbCommand');
 | 
			
		||||
				Yii::trace('Query result found in cache', 'system.db.Command');
 | 
			
		||||
				return $result;
 | 
			
		||||
			}
 | 
			
		||||
		}
 | 
			
		||||
@ -478,7 +475,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
		try
 | 
			
		||||
		{
 | 
			
		||||
			if ($this->_connection->enableProfiling)
 | 
			
		||||
				Yii::beginProfile('system.db.CDbCommand.query(' . $this->getText() . $par . ')', 'system.db.CDbCommand.query');
 | 
			
		||||
				Yii::beginProfile('system.db.Command.query(' . $this->getText() . $par . ')', 'system.db.Command.query');
 | 
			
		||||
 | 
			
		||||
			$this->prepare();
 | 
			
		||||
			if ($params === array())
 | 
			
		||||
@ -496,7 +493,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
			}
 | 
			
		||||
 | 
			
		||||
			if ($this->_connection->enableProfiling)
 | 
			
		||||
				Yii::endProfile('system.db.CDbCommand.query(' . $this->getText() . $par . ')', 'system.db.CDbCommand.query');
 | 
			
		||||
				Yii::endProfile('system.db.Command.query(' . $this->getText() . $par . ')', 'system.db.Command.query');
 | 
			
		||||
 | 
			
		||||
			if (isset($cache, $cacheKey))
 | 
			
		||||
				$cache->set($cacheKey, $result, $this->_connection->queryCachingDuration, $this->_connection->queryCachingDependency);
 | 
			
		||||
@ -506,14 +503,14 @@ class CDbCommand extends CComponent
 | 
			
		||||
		catch(Exception $e)
 | 
			
		||||
		{
 | 
			
		||||
			if ($this->_connection->enableProfiling)
 | 
			
		||||
				Yii::endProfile('system.db.CDbCommand.query(' . $this->getText() . $par . ')', 'system.db.CDbCommand.query');
 | 
			
		||||
				Yii::endProfile('system.db.Command.query(' . $this->getText() . $par . ')', 'system.db.Command.query');
 | 
			
		||||
            $errorInfo = $e instanceof PDOException ? $e->errorInfo : null;
 | 
			
		||||
            $message = $e->getMessage();
 | 
			
		||||
			Yii::log(Yii::t('yii', 'CDbCommand::{method}() failed: {error}. The SQL statement executed was: {sql}.',
 | 
			
		||||
				array('{method}' => $method, '{error}' => $message, '{sql}' => $this->getText() . $par)), CLogger::LEVEL_ERROR, 'system.db.CDbCommand');
 | 
			
		||||
			Yii::log(Yii::t('yii', 'Command::{method}() failed: {error}. The SQL statement executed was: {sql}.',
 | 
			
		||||
				array('{method}' => $method, '{error}' => $message, '{sql}' => $this->getText() . $par)), CLogger::LEVEL_ERROR, 'system.db.Command');
 | 
			
		||||
            if (YII_DEBUG)
 | 
			
		||||
            	$message .= '. The SQL statement executed was: ' . $this->getText() . $par;
 | 
			
		||||
			throw new CDbException(Yii::t('yii', 'CDbCommand failed to execute the SQL statement: {error}',
 | 
			
		||||
			throw new CDbException(Yii::t('yii', 'Command failed to execute the SQL statement: {error}',
 | 
			
		||||
				array('{error}' => $message)), (int)$e->getCode(), $errorInfo);
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
@ -572,7 +569,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * (which means the column contains a DB expression).
 | 
			
		||||
	 * @param string $option additional option that should be appended to the 'SELECT' keyword. For example,
 | 
			
		||||
	 * in MySQL, the option 'SQL_CALC_FOUND_ROWS' can be used. This parameter is supported since version 1.1.8.
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function select($columns = '*', $option = '')
 | 
			
		||||
@ -628,7 +625,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * Sets the SELECT part of the query with the DISTINCT flag turned on.
 | 
			
		||||
	 * This is the same as {@link select} except that the DISTINCT flag is turned on.
 | 
			
		||||
	 * @param mixed $columns the columns to be selected. See {@link select} for more details.
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function selectDistinct($columns = '*')
 | 
			
		||||
@ -664,7 +661,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * Table names can contain schema prefixes (e.g. 'public.tbl_user') and/or table aliases (e.g. 'tbl_user u').
 | 
			
		||||
	 * The method will automatically quote the table names unless it contains some parenthesis
 | 
			
		||||
	 * (which means the table is given as a sub-query or DB expression).
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function from($tables)
 | 
			
		||||
@ -746,7 +743,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * </ul>
 | 
			
		||||
	 * @param mixed $conditions the conditions that should be put in the WHERE part.
 | 
			
		||||
	 * @param array $params the parameters (name=>value) to be bound to the query
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function where($conditions, $params = array())
 | 
			
		||||
@ -787,7 +784,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * @param mixed $conditions the join condition that should appear in the ON part.
 | 
			
		||||
	 * Please refer to {@link where} on how to specify conditions.
 | 
			
		||||
	 * @param array $params the parameters (name=>value) to be bound to the query
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function join($table, $conditions, $params = array())
 | 
			
		||||
@ -828,7 +825,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * @param mixed $conditions the join condition that should appear in the ON part.
 | 
			
		||||
	 * Please refer to {@link where} on how to specify conditions.
 | 
			
		||||
	 * @param array $params the parameters (name=>value) to be bound to the query
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function leftJoin($table, $conditions, $params = array())
 | 
			
		||||
@ -845,7 +842,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * @param mixed $conditions the join condition that should appear in the ON part.
 | 
			
		||||
	 * Please refer to {@link where} on how to specify conditions.
 | 
			
		||||
	 * @param array $params the parameters (name=>value) to be bound to the query
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function rightJoin($table, $conditions, $params = array())
 | 
			
		||||
@ -860,7 +857,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * Table name can contain schema prefix (e.g. 'public.tbl_user') and/or table alias (e.g. 'tbl_user u').
 | 
			
		||||
	 * The method will automatically quote the table name unless it contains some parenthesis
 | 
			
		||||
	 * (which means the table is given as a sub-query or DB expression).
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function crossJoin($table)
 | 
			
		||||
@ -875,7 +872,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * Table name can contain schema prefix (e.g. 'public.tbl_user') and/or table alias (e.g. 'tbl_user u').
 | 
			
		||||
	 * The method will automatically quote the table name unless it contains some parenthesis
 | 
			
		||||
	 * (which means the table is given as a sub-query or DB expression).
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function naturalJoin($table)
 | 
			
		||||
@ -889,7 +886,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * Columns can be specified in either a string (e.g. "id, name") or an array (e.g. array('id', 'name')).
 | 
			
		||||
	 * The method will automatically quote the column names unless a column contains some parenthesis
 | 
			
		||||
	 * (which means the column contains a DB expression).
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function group($columns)
 | 
			
		||||
@ -938,7 +935,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * @param mixed $conditions the conditions to be put after HAVING.
 | 
			
		||||
	 * Please refer to {@link where} on how to specify conditions.
 | 
			
		||||
	 * @param array $params the parameters (name=>value) to be bound to the query
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function having($conditions, $params = array())
 | 
			
		||||
@ -976,7 +973,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * Columns can be specified in either a string (e.g. "id ASC, name DESC") or an array (e.g. array('id ASC', 'name DESC')).
 | 
			
		||||
	 * The method will automatically quote the column names unless a column contains some parenthesis
 | 
			
		||||
	 * (which means the column contains a DB expression).
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function order($columns)
 | 
			
		||||
@ -1029,7 +1026,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * Sets the LIMIT part of the query.
 | 
			
		||||
	 * @param integer $limit the limit
 | 
			
		||||
	 * @param integer $offset the offset
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function limit($limit, $offset = null)
 | 
			
		||||
@ -1064,7 +1061,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	/**
 | 
			
		||||
	 * Sets the OFFSET part of the query.
 | 
			
		||||
	 * @param integer $offset the offset
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function offset($offset)
 | 
			
		||||
@ -1097,7 +1094,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	/**
 | 
			
		||||
	 * Appends a SQL statement using UNION operator.
 | 
			
		||||
	 * @param string $sql the SQL statement to be appended using UNION
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	public function union($sql)
 | 
			
		||||
@ -1470,7 +1467,7 @@ class CDbCommand extends CComponent
 | 
			
		||||
	 * @param mixed $conditions the join condition that should appear in the ON part.
 | 
			
		||||
	 * Please refer to {@link where} on how to specify conditions.
 | 
			
		||||
	 * @param array $params the parameters (name=>value) to be bound to the query
 | 
			
		||||
	 * @return CDbCommand the command object itself
 | 
			
		||||
	 * @return Command the command object itself
 | 
			
		||||
	 * @since 1.1.6
 | 
			
		||||
	 */
 | 
			
		||||
	private function joinInternal($type, $table, $conditions = '', $params = array())
 | 
			
		||||
 | 
			
		||||
@ -56,7 +56,7 @@ namespace yii\db\dao;
 | 
			
		||||
 *     $transaction->commit();
 | 
			
		||||
 * }
 | 
			
		||||
 * catch(Exception $e) {
 | 
			
		||||
 *    $transaction->rollBack();
 | 
			
		||||
 *     $transaction->rollBack();
 | 
			
		||||
 * }
 | 
			
		||||
 * ~~~
 | 
			
		||||
 *
 | 
			
		||||
@ -580,12 +580,12 @@ class Connection extends \yii\base\ApplicationComponent
 | 
			
		||||
	public function getStats()
 | 
			
		||||
	{
 | 
			
		||||
		$logger = \Yii::getLogger();
 | 
			
		||||
		$timings = $logger->getProfilingResults(null, 'yii\db\dao\Command::query');
 | 
			
		||||
		$timings = $logger->getProfiling(array('yii\db\dao\Command::query', 'yii\db\dao\Command::execute'));
 | 
			
		||||
		$count = count($timings);
 | 
			
		||||
		$time = array_sum($timings);
 | 
			
		||||
		$timings = $logger->getProfilingResults(null, 'yii\db\dao\Command::execute');
 | 
			
		||||
		$count += count($timings);
 | 
			
		||||
		$time += array_sum($timings);
 | 
			
		||||
		$time = 0;
 | 
			
		||||
		foreach ($timings as $timing) {
 | 
			
		||||
			$time += $timing[1];
 | 
			
		||||
		}
 | 
			
		||||
		return array($count, $time);
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
@ -1,36 +1,37 @@
 | 
			
		||||
<?php
 | 
			
		||||
/**
 | 
			
		||||
 * CDbDataReader class file
 | 
			
		||||
 * DataReader class file
 | 
			
		||||
 *
 | 
			
		||||
 * @author Qiang Xue <qiang.xue@gmail.com>
 | 
			
		||||
 * @link http://www.yiiframework.com/
 | 
			
		||||
 * @copyright Copyright © 2008-2011 Yii Software LLC
 | 
			
		||||
 * @copyright Copyright © 2008-2012 Yii Software LLC
 | 
			
		||||
 * @license http://www.yiiframework.com/license/
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * CDbDataReader represents a forward-only stream of rows from a query result set.
 | 
			
		||||
 * DataReader represents a forward-only stream of rows from a query result set.
 | 
			
		||||
 *
 | 
			
		||||
 * To read the current row of data, call {@link read}. The method {@link readAll}
 | 
			
		||||
 * To read the current row of data, call [[read]]. The method [[readAll]]
 | 
			
		||||
 * returns all the rows in a single array.
 | 
			
		||||
 *
 | 
			
		||||
 * One can also retrieve the rows of data in CDbDataReader by using foreach:
 | 
			
		||||
 * <pre>
 | 
			
		||||
 * foreach($reader as $row)
 | 
			
		||||
 * One can also retrieve the rows of data in DataReader by using `foreach`:
 | 
			
		||||
 *
 | 
			
		||||
 * ~~~
 | 
			
		||||
 * foreach($reader as $row) {
 | 
			
		||||
 *     // $row represents a row of data
 | 
			
		||||
 * </pre>
 | 
			
		||||
 * Since CDbDataReader is a forward-only stream, you can only traverse it once.
 | 
			
		||||
 * }
 | 
			
		||||
 * ~~~
 | 
			
		||||
 *
 | 
			
		||||
 * Since DataReader is a forward-only stream, you can only traverse it once.
 | 
			
		||||
 *
 | 
			
		||||
 * It is possible to use a specific mode of data fetching by setting
 | 
			
		||||
 * {@link setFetchMode FetchMode}. See {@link http://www.php.net/manual/en/function.PDOStatement-setFetchMode.php}
 | 
			
		||||
 * for more details.
 | 
			
		||||
 * [[fetchMode]]. See the [PHP manual](http://www.php.net/manual/en/function.PDOStatement-setFetchMode.php)
 | 
			
		||||
 * for more details about possible fetch mode.
 | 
			
		||||
 *
 | 
			
		||||
 * @author Qiang Xue <qiang.xue@gmail.com>
 | 
			
		||||
 * @version $Id: CDbDataReader.php 3204 2011-05-05 21:36:32Z alexander.makarow $
 | 
			
		||||
 * @package system.db
 | 
			
		||||
 * @since 1.0
 | 
			
		||||
 * @since 2.0
 | 
			
		||||
 */
 | 
			
		||||
class CDbDataReader extends CComponent implements Iterator, Countable
 | 
			
		||||
class DataReader extends \yii\base\Component implements \Iterator, \Countable
 | 
			
		||||
{
 | 
			
		||||
	private $_statement;
 | 
			
		||||
	private $_closed = false;
 | 
			
		||||
@ -39,12 +40,12 @@ class CDbDataReader extends CComponent implements Iterator, Countable
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
	 * Constructor.
 | 
			
		||||
	 * @param CDbCommand $command the command generating the query result
 | 
			
		||||
	 * @param Command $command the command generating the query result
 | 
			
		||||
	 */
 | 
			
		||||
	public function __construct(CDbCommand $command)
 | 
			
		||||
	public function __construct(Command $command)
 | 
			
		||||
	{
 | 
			
		||||
		$this->_statement = $command->getPdoStatement();
 | 
			
		||||
		$this->_statement->setFetchMode(PDO::FETCH_ASSOC);
 | 
			
		||||
		$this->_statement->setFetchMode(\PDO::FETCH_ASSOC);
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
@ -60,10 +61,12 @@ class CDbDataReader extends CComponent implements Iterator, Countable
 | 
			
		||||
	 */
 | 
			
		||||
	public function bindColumn($column, &$value, $dataType = null)
 | 
			
		||||
	{
 | 
			
		||||
		if ($dataType === null)
 | 
			
		||||
		if ($dataType === null) {
 | 
			
		||||
			$this->_statement->bindColumn($column, $value);
 | 
			
		||||
		else
 | 
			
		||||
		}
 | 
			
		||||
		else {
 | 
			
		||||
			$this->_statement->bindColumn($column, $value, $dataType);
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
@ -125,8 +128,9 @@ class CDbDataReader extends CComponent implements Iterator, Countable
 | 
			
		||||
	 */
 | 
			
		||||
	public function nextResult()
 | 
			
		||||
	{
 | 
			
		||||
		if (($result = $this->_statement->nextRowset()) !== false)
 | 
			
		||||
		if (($result = $this->_statement->nextRowset()) !== false) {
 | 
			
		||||
			$this->_index = -1;
 | 
			
		||||
		}
 | 
			
		||||
		return $result;
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
@ -186,17 +190,17 @@ class CDbDataReader extends CComponent implements Iterator, Countable
 | 
			
		||||
	/**
 | 
			
		||||
	 * Resets the iterator to the initial state.
 | 
			
		||||
	 * This method is required by the interface Iterator.
 | 
			
		||||
	 * @throws CException if this method is invoked twice
 | 
			
		||||
	 * @throws Exception if this method is invoked twice
 | 
			
		||||
	 */
 | 
			
		||||
	public function rewind()
 | 
			
		||||
	{
 | 
			
		||||
		if ($this->_index < 0)
 | 
			
		||||
		{
 | 
			
		||||
		if ($this->_index < 0) {
 | 
			
		||||
			$this->_row = $this->_statement->fetch();
 | 
			
		||||
			$this->_index = 0;
 | 
			
		||||
		}
 | 
			
		||||
		else
 | 
			
		||||
			throw new CDbException(Yii::t('yii', 'CDbDataReader cannot rewind. It is a forward-only reader.'));
 | 
			
		||||
		else {
 | 
			
		||||
			throw new Exception('DataReader cannot rewind. It is a forward-only reader.');
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
 | 
			
		||||
@ -1,108 +1,92 @@
 | 
			
		||||
<?php
 | 
			
		||||
/**
 | 
			
		||||
 * CDbTransaction class file
 | 
			
		||||
 * Transaction class file.
 | 
			
		||||
 *
 | 
			
		||||
 * @author Qiang Xue <qiang.xue@gmail.com>
 | 
			
		||||
 * @link http://www.yiiframework.com/
 | 
			
		||||
 * @copyright Copyright © 2008-2011 Yii Software LLC
 | 
			
		||||
 * @copyright Copyright © 2008-2012 Yii Software LLC
 | 
			
		||||
 * @license http://www.yiiframework.com/license/
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
namespace yii\db\dao;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * CDbTransaction represents a DB transaction.
 | 
			
		||||
 * Transaction represents a DB transaction.
 | 
			
		||||
 *
 | 
			
		||||
 * It is usually created by calling {@link CDbConnection::beginTransaction}.
 | 
			
		||||
 * It is usually created by calling [[Connection::beginTransaction]].
 | 
			
		||||
 *
 | 
			
		||||
 * The following code is a common scenario of using transactions:
 | 
			
		||||
 * <pre>
 | 
			
		||||
 * $transaction=$connection->beginTransaction();
 | 
			
		||||
 * try
 | 
			
		||||
 * {
 | 
			
		||||
 *    $connection->createCommand($sql1)->execute();
 | 
			
		||||
 *    $connection->createCommand($sql2)->execute();
 | 
			
		||||
 *    //.... other SQL executions
 | 
			
		||||
 *    $transaction->commit();
 | 
			
		||||
 * The following code is a typical example of using transactions (note that some
 | 
			
		||||
 * DBMS may not support transactions):
 | 
			
		||||
 *
 | 
			
		||||
 * ~~~
 | 
			
		||||
 * $transaction = $connection->beginTransaction();
 | 
			
		||||
 * try {
 | 
			
		||||
 *     $connection->createCommand($sql1)->execute();
 | 
			
		||||
 *     $connection->createCommand($sql2)->execute();
 | 
			
		||||
 *     //.... other SQL executions
 | 
			
		||||
 *     $transaction->commit();
 | 
			
		||||
 * }
 | 
			
		||||
 * catch(Exception $e)
 | 
			
		||||
 * {
 | 
			
		||||
 *    $transaction->rollBack();
 | 
			
		||||
 * catch(Exception $e) {
 | 
			
		||||
 *     $transaction->rollBack();
 | 
			
		||||
 * }
 | 
			
		||||
 * </pre>
 | 
			
		||||
 * ~~~
 | 
			
		||||
 *
 | 
			
		||||
 * @author Qiang Xue <qiang.xue@gmail.com>
 | 
			
		||||
 * @version $Id: CDbTransaction.php 3069 2011-03-14 00:28:38Z qiang.xue $
 | 
			
		||||
 * @package system.db
 | 
			
		||||
 * @since 1.0
 | 
			
		||||
 * @since 2.0
 | 
			
		||||
 */
 | 
			
		||||
class CDbTransaction extends CComponent
 | 
			
		||||
class Transaction extends \yii\base\Component
 | 
			
		||||
{
 | 
			
		||||
	private $_connection = null;
 | 
			
		||||
	private $_active;
 | 
			
		||||
	/**
 | 
			
		||||
	 * @var boolean whether this transaction is active. Only an active transaction
 | 
			
		||||
	 * can [[commit]] or [[rollBack]]. This property is set true when the transaction is started.
 | 
			
		||||
	 */
 | 
			
		||||
	public $active;
 | 
			
		||||
	/**
 | 
			
		||||
	 * @var Connection the database connection that this transaction is associated with.
 | 
			
		||||
	 * This property is set true when the transaction is started.
 | 
			
		||||
	 */
 | 
			
		||||
	public $connection;
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
	 * Constructor.
 | 
			
		||||
	 * @param CDbConnection $connection the connection associated with this transaction
 | 
			
		||||
	 * @see CDbConnection::beginTransaction
 | 
			
		||||
	 * @param Connection $connection the connection associated with this transaction
 | 
			
		||||
	 * @see Connection::beginTransaction
 | 
			
		||||
	 */
 | 
			
		||||
	public function __construct(CDbConnection $connection)
 | 
			
		||||
	public function __construct($connection)
 | 
			
		||||
	{
 | 
			
		||||
		$this->_connection = $connection;
 | 
			
		||||
		$this->_active = true;
 | 
			
		||||
		$this->active = true;
 | 
			
		||||
		$this->connection = $connection;
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
	 * Commits a transaction.
 | 
			
		||||
	 * @throws CException if the transaction or the DB connection is not active.
 | 
			
		||||
	 * @throws Exception if the transaction or the DB connection is not active.
 | 
			
		||||
	 */
 | 
			
		||||
	public function commit()
 | 
			
		||||
	{
 | 
			
		||||
		if ($this->_active && $this->_connection->getActive())
 | 
			
		||||
		{
 | 
			
		||||
			Yii::trace('Committing transaction', 'system.db.CDbTransaction');
 | 
			
		||||
			$this->_connection->getPdoInstance()->commit();
 | 
			
		||||
			$this->_active = false;
 | 
			
		||||
		if ($this->active && $this->connection->getActive()) {
 | 
			
		||||
			Yii::trace('Committing transaction', __CLASS__);
 | 
			
		||||
			$this->connection->pdo->commit();
 | 
			
		||||
			$this->active = false;
 | 
			
		||||
		}
 | 
			
		||||
		else {
 | 
			
		||||
			throw new Exception('Transaction is inactive and cannot perform commit operation.');
 | 
			
		||||
		}
 | 
			
		||||
		else
 | 
			
		||||
			throw new CDbException(Yii::t('yii', 'CDbTransaction is inactive and cannot perform commit or roll back operations.'));
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
	 * Rolls back a transaction.
 | 
			
		||||
	 * @throws CException if the transaction or the DB connection is not active.
 | 
			
		||||
	 * @throws Exception if the transaction or the DB connection is not active.
 | 
			
		||||
	 */
 | 
			
		||||
	public function rollback()
 | 
			
		||||
	{
 | 
			
		||||
		if ($this->_active && $this->_connection->getActive())
 | 
			
		||||
		{
 | 
			
		||||
			Yii::trace('Rolling back transaction', 'system.db.CDbTransaction');
 | 
			
		||||
			$this->_connection->getPdoInstance()->rollBack();
 | 
			
		||||
			$this->_active = false;
 | 
			
		||||
		if ($this->active && $this->connection->getActive()) {
 | 
			
		||||
			Yii::trace('Rolling back transaction', __CLASS__);
 | 
			
		||||
			$this->connection->pdo->rollBack();
 | 
			
		||||
			$this->active = false;
 | 
			
		||||
		}
 | 
			
		||||
		else {
 | 
			
		||||
			throw new Exception('Transaction is inactive and cannot perform roll back operation.');
 | 
			
		||||
		}
 | 
			
		||||
		else
 | 
			
		||||
			throw new CDbException(Yii::t('yii', 'CDbTransaction is inactive and cannot perform commit or roll back operations.'));
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
	 * @return CDbConnection the DB connection for this transaction
 | 
			
		||||
	 */
 | 
			
		||||
	public function getConnection()
 | 
			
		||||
	{
 | 
			
		||||
		return $this->_connection;
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
	 * @return boolean whether this transaction is active
 | 
			
		||||
	 */
 | 
			
		||||
	public function getActive()
 | 
			
		||||
	{
 | 
			
		||||
		return $this->_active;
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	/**
 | 
			
		||||
	 * @param boolean $value whether this transaction is active
 | 
			
		||||
	 */
 | 
			
		||||
	protected function setActive($value)
 | 
			
		||||
	{
 | 
			
		||||
		$this->_active = $value;
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
@ -95,9 +95,9 @@ abstract class Validator extends \yii\base\Component
 | 
			
		||||
	public $on;
 | 
			
		||||
	/**
 | 
			
		||||
	 * @var boolean whether this validation rule should be skipped if the attribute being validated
 | 
			
		||||
	 * already has some validation error according to the previous rules. Defaults to false.
 | 
			
		||||
	 * already has some validation error according to the previous rules. Defaults to true.
 | 
			
		||||
	 */
 | 
			
		||||
	public $skipOnError = false;
 | 
			
		||||
	public $skipOnError = true;
 | 
			
		||||
	/**
 | 
			
		||||
	 * @var boolean whether attributes listed with this validator should be considered safe for
 | 
			
		||||
	 * massive assignment. Defaults to true.
 | 
			
		||||
 | 
			
		||||
		Reference in New Issue
	
	Block a user