|  |  |  | <?php
 | 
					
						
							|  |  |  | /**
 | 
					
						
							|  |  |  |  * @link http://www.yiiframework.com/
 | 
					
						
							|  |  |  |  * @copyright Copyright (c) 2008 Yii Software LLC
 | 
					
						
							|  |  |  |  * @license http://www.yiiframework.com/license/
 | 
					
						
							|  |  |  |  */
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | namespace yii\db;
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | use yii\base\Object;
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /**
 | 
					
						
							|  |  |  |  * ColumnSchema class describes the metadata of a column in a database table.
 | 
					
						
							|  |  |  |  *
 | 
					
						
							|  |  |  |  * @author Qiang Xue <qiang.xue@gmail.com>
 | 
					
						
							|  |  |  |  * @since 2.0
 | 
					
						
							|  |  |  |  */
 | 
					
						
							|  |  |  | class ColumnSchema extends Object
 | 
					
						
							|  |  |  | {
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var string name of this column (without quotes).
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $name;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var boolean whether this column can be null.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $allowNull;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var string abstract type of this column. Possible abstract types include:
 | 
					
						
							|  |  |  | 	 * string, text, boolean, smallint, integer, bigint, float, decimal, datetime,
 | 
					
						
							|  |  |  | 	 * timestamp, time, date, binary, and money.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $type;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var string the PHP type of this column. Possible PHP types include:
 | 
					
						
							|  |  |  | 	 * string, boolean, integer, double.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $phpType;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var string the DB type of this column. Possible DB types vary according to the type of DBMS.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $dbType;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var mixed default value of this column
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $defaultValue;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var array enumerable values. This is set only if the column is declared to be an enumerable type.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $enumValues;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var integer display size of the column.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $size;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var integer precision of the column data, if it is numeric.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $precision;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var integer scale of the column data, if it is numeric.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $scale;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var boolean whether this column is a primary key
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $isPrimaryKey;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var boolean whether this column is auto-incremental
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $autoIncrement = false;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var boolean whether this column is unsigned. This is only meaningful
 | 
					
						
							|  |  |  | 	 * when [[type]] is `smallint`, `integer` or `bigint`.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $unsigned;
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * @var string comment of this column. Not all DBMS support this.
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public $comment;
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	/**
 | 
					
						
							|  |  |  | 	 * Converts the input value according to [[phpType]].
 | 
					
						
							|  |  |  | 	 * If the value is null or an [[Expression]], it will not be converted.
 | 
					
						
							|  |  |  | 	 * @param mixed $value input value
 | 
					
						
							|  |  |  | 	 * @return mixed converted value
 | 
					
						
							|  |  |  | 	 */
 | 
					
						
							|  |  |  | 	public function typecast($value)
 | 
					
						
							|  |  |  | 	{
 | 
					
						
							|  |  |  | 		if ($value === null || gettype($value) === $this->phpType || $value instanceof Expression) {
 | 
					
						
							|  |  |  | 			return $value;
 | 
					
						
							|  |  |  | 		}
 | 
					
						
							|  |  |  | 		if ($value === '' && $this->type !== Schema::TYPE_TEXT && $this->type !== Schema::TYPE_STRING) {
 | 
					
						
							|  |  |  | 			return null;
 | 
					
						
							|  |  |  | 		}
 | 
					
						
							|  |  |  | 		switch ($this->phpType) {
 | 
					
						
							|  |  |  | 			case 'string':
 | 
					
						
							|  |  |  | 				return (string)$value;
 | 
					
						
							|  |  |  | 			case 'integer':
 | 
					
						
							|  |  |  | 				return (integer)$value;
 | 
					
						
							|  |  |  | 			case 'boolean':
 | 
					
						
							|  |  |  | 				return (boolean)$value;
 | 
					
						
							|  |  |  | 		}
 | 
					
						
							|  |  |  | 		return $value;
 | 
					
						
							|  |  |  | 	}
 | 
					
						
							|  |  |  | }
 |