123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453 |
- <?php
- namespace Doctrine\DBAL\Schema;
- use Doctrine\DBAL\Types\Type;
- use Doctrine\Deprecations\Deprecation;
- use function array_merge;
- use function is_numeric;
- use function method_exists;
- /**
- * Object representation of a database column.
- */
- class Column extends AbstractAsset
- {
- /** @var Type */
- protected $_type;
- /** @var int|null */
- protected $_length;
- /** @var int */
- protected $_precision = 10;
- /** @var int */
- protected $_scale = 0;
- /** @var bool */
- protected $_unsigned = false;
- /** @var bool */
- protected $_fixed = false;
- /** @var bool */
- protected $_notnull = true;
- /** @var string|null */
- protected $_default;
- /** @var bool */
- protected $_autoincrement = false;
- /** @var mixed[] */
- protected $_platformOptions = [];
- /** @var string|null */
- protected $_columnDefinition;
- /** @var string|null */
- protected $_comment;
- /** @var mixed[] */
- protected $_customSchemaOptions = [];
- /**
- * Creates a new Column.
- *
- * @param string $name
- * @param mixed[] $options
- */
- public function __construct($name, Type $type, array $options = [])
- {
- $this->_setName($name);
- $this->setType($type);
- $this->setOptions($options);
- }
- /**
- * @param mixed[] $options
- *
- * @return Column
- */
- public function setOptions(array $options)
- {
- foreach ($options as $name => $value) {
- $method = 'set' . $name;
- if (! method_exists($this, $method)) {
- // next major: throw an exception
- Deprecation::trigger(
- 'doctrine/dbal',
- 'https://github.com/doctrine/dbal/pull/2846',
- 'The "%s" column option is not supported,' .
- ' setting unknown options is deprecated and will cause an error in Doctrine DBAL 3.0',
- $name
- );
- continue;
- }
- $this->$method($value);
- }
- return $this;
- }
- /**
- * @return Column
- */
- public function setType(Type $type)
- {
- $this->_type = $type;
- return $this;
- }
- /**
- * @param int|null $length
- *
- * @return Column
- */
- public function setLength($length)
- {
- if ($length !== null) {
- $this->_length = (int) $length;
- } else {
- $this->_length = null;
- }
- return $this;
- }
- /**
- * @param int $precision
- *
- * @return Column
- */
- public function setPrecision($precision)
- {
- if (! is_numeric($precision)) {
- $precision = 10; // defaults to 10 when no valid precision is given.
- }
- $this->_precision = (int) $precision;
- return $this;
- }
- /**
- * @param int $scale
- *
- * @return Column
- */
- public function setScale($scale)
- {
- if (! is_numeric($scale)) {
- $scale = 0;
- }
- $this->_scale = (int) $scale;
- return $this;
- }
- /**
- * @param bool $unsigned
- *
- * @return Column
- */
- public function setUnsigned($unsigned)
- {
- $this->_unsigned = (bool) $unsigned;
- return $this;
- }
- /**
- * @param bool $fixed
- *
- * @return Column
- */
- public function setFixed($fixed)
- {
- $this->_fixed = (bool) $fixed;
- return $this;
- }
- /**
- * @param bool $notnull
- *
- * @return Column
- */
- public function setNotnull($notnull)
- {
- $this->_notnull = (bool) $notnull;
- return $this;
- }
- /**
- * @param mixed $default
- *
- * @return Column
- */
- public function setDefault($default)
- {
- $this->_default = $default;
- return $this;
- }
- /**
- * @param mixed[] $platformOptions
- *
- * @return Column
- */
- public function setPlatformOptions(array $platformOptions)
- {
- $this->_platformOptions = $platformOptions;
- return $this;
- }
- /**
- * @param string $name
- * @param mixed $value
- *
- * @return Column
- */
- public function setPlatformOption($name, $value)
- {
- $this->_platformOptions[$name] = $value;
- return $this;
- }
- /**
- * @param string $value
- *
- * @return Column
- */
- public function setColumnDefinition($value)
- {
- $this->_columnDefinition = $value;
- return $this;
- }
- /**
- * @return Type
- */
- public function getType()
- {
- return $this->_type;
- }
- /**
- * @return int|null
- */
- public function getLength()
- {
- return $this->_length;
- }
- /**
- * @return int
- */
- public function getPrecision()
- {
- return $this->_precision;
- }
- /**
- * @return int
- */
- public function getScale()
- {
- return $this->_scale;
- }
- /**
- * @return bool
- */
- public function getUnsigned()
- {
- return $this->_unsigned;
- }
- /**
- * @return bool
- */
- public function getFixed()
- {
- return $this->_fixed;
- }
- /**
- * @return bool
- */
- public function getNotnull()
- {
- return $this->_notnull;
- }
- /**
- * @return string|null
- */
- public function getDefault()
- {
- return $this->_default;
- }
- /**
- * @return mixed[]
- */
- public function getPlatformOptions()
- {
- return $this->_platformOptions;
- }
- /**
- * @param string $name
- *
- * @return bool
- */
- public function hasPlatformOption($name)
- {
- return isset($this->_platformOptions[$name]);
- }
- /**
- * @param string $name
- *
- * @return mixed
- */
- public function getPlatformOption($name)
- {
- return $this->_platformOptions[$name];
- }
- /**
- * @return string|null
- */
- public function getColumnDefinition()
- {
- return $this->_columnDefinition;
- }
- /**
- * @return bool
- */
- public function getAutoincrement()
- {
- return $this->_autoincrement;
- }
- /**
- * @param bool $flag
- *
- * @return Column
- */
- public function setAutoincrement($flag)
- {
- $this->_autoincrement = $flag;
- return $this;
- }
- /**
- * @param string|null $comment
- *
- * @return Column
- */
- public function setComment($comment)
- {
- $this->_comment = $comment;
- return $this;
- }
- /**
- * @return string|null
- */
- public function getComment()
- {
- return $this->_comment;
- }
- /**
- * @param string $name
- * @param mixed $value
- *
- * @return Column
- */
- public function setCustomSchemaOption($name, $value)
- {
- $this->_customSchemaOptions[$name] = $value;
- return $this;
- }
- /**
- * @param string $name
- *
- * @return bool
- */
- public function hasCustomSchemaOption($name)
- {
- return isset($this->_customSchemaOptions[$name]);
- }
- /**
- * @param string $name
- *
- * @return mixed
- */
- public function getCustomSchemaOption($name)
- {
- return $this->_customSchemaOptions[$name];
- }
- /**
- * @param mixed[] $customSchemaOptions
- *
- * @return Column
- */
- public function setCustomSchemaOptions(array $customSchemaOptions)
- {
- $this->_customSchemaOptions = $customSchemaOptions;
- return $this;
- }
- /**
- * @return mixed[]
- */
- public function getCustomSchemaOptions()
- {
- return $this->_customSchemaOptions;
- }
- /**
- * @return mixed[]
- */
- public function toArray()
- {
- return array_merge([
- 'name' => $this->_name,
- 'type' => $this->_type,
- 'default' => $this->_default,
- 'notnull' => $this->_notnull,
- 'length' => $this->_length,
- 'precision' => $this->_precision,
- 'scale' => $this->_scale,
- 'fixed' => $this->_fixed,
- 'unsigned' => $this->_unsigned,
- 'autoincrement' => $this->_autoincrement,
- 'columnDefinition' => $this->_columnDefinition,
- 'comment' => $this->_comment,
- ], $this->_platformOptions, $this->_customSchemaOptions);
- }
- }
|