AbstractPlatform.php 79 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
<?php
/*
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * This software consists of voluntary contributions made by many individuals
 * and is licensed under the LGPL. For more information, see
17
 * <http://www.doctrine-project.org>.
18 19
 */

20 21
namespace Doctrine\DBAL\Platforms;

22
use Doctrine\DBAL\DBALException,
23
    Doctrine\DBAL\Connection,
24 25 26
    Doctrine\DBAL\Types,
    Doctrine\DBAL\Schema\Table,
    Doctrine\DBAL\Schema\Index,
27
    Doctrine\DBAL\Schema\ForeignKeyConstraint,
28
    Doctrine\DBAL\Schema\TableDiff,
29
    Doctrine\DBAL\Schema\Column,
30
    Doctrine\DBAL\Schema\ColumnDiff,
31
    Doctrine\DBAL\Types\Type,
32 33 34
    Doctrine\DBAL\Events,
    Doctrine\Common\EventManager,
    Doctrine\DBAL\Event\SchemaCreateTableEventArgs,
35
    Doctrine\DBAL\Event\SchemaCreateTableColumnEventArgs,
36
    Doctrine\DBAL\Event\SchemaDropTableEventArgs,
37
    Doctrine\DBAL\Event\SchemaAlterTableEventArgs,
38 39 40 41
    Doctrine\DBAL\Event\SchemaAlterTableAddColumnEventArgs,
    Doctrine\DBAL\Event\SchemaAlterTableRemoveColumnEventArgs,
    Doctrine\DBAL\Event\SchemaAlterTableChangeColumnEventArgs,
    Doctrine\DBAL\Event\SchemaAlterTableRenameColumnEventArgs;
42 43 44 45 46 47

/**
 * Base class for all DatabasePlatforms. The DatabasePlatforms are the central
 * point of abstraction of platform-specific behaviors, features and SQL dialects.
 * They are a passive source of information.
 *
48 49 50 51 52 53 54 55
 * @license http://www.opensource.org/licenses/lgpl-license.php LGPL
 * @link    www.doctrine-project.org
 * @since   2.0
 * @version $Revision: 3938 $
 * @author  Guilherme Blanco <guilhermeblanco@hotmail.com>
 * @author  Jonathan Wage <jonwage@gmail.com>
 * @author  Roman Borschel <roman@code-factory.org>
 * @author  Lukas Smith <smith@pooteeweet.org> (PEAR MDB2 library)
56
 * @author  Benjamin Eberlei <kontakt@beberlei.de>
57
 * @todo Remove any unnecessary methods.
58
 */
59
abstract class AbstractPlatform
60
{
61 62 63 64 65 66 67 68 69 70
    /**
     * @var int
     */
    const CREATE_INDEXES = 1;

    /**
     * @var int
     */
    const CREATE_FOREIGNKEYS = 2;

71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
    /**
     * @var int
     */
    const TRIM_UNSPECIFIED = 0;

    /**
     * @var int
     */
    const TRIM_LEADING = 1;

    /**
     * @var int
     */
    const TRIM_TRAILING = 2;

    /**
     * @var int
     */
    const TRIM_BOTH = 3;

91 92 93 94 95
    /**
     * @var array
     */
    protected $doctrineTypeMapping = null;

96 97 98 99 100 101 102 103
    /**
     * Contains a list of all columns that should generate parseable column comments for type-detection
     * in reverse engineering scenarios.
     *
     * @var array
     */
    protected $doctrineTypeComments = null;

104 105 106 107 108
    /**
     * @var Doctrine\Common\EventManager
     */
    protected $_eventManager;

109 110 111 112
    /**
     * Constructor.
     */
    public function __construct() {}
113

114 115 116
    /**
     * Sets the EventManager used by the Platform.
     *
jsor's avatar
jsor committed
117
     * @param \Doctrine\Common\EventManager
118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133
     */
    public function setEventManager(EventManager $eventManager)
    {
        $this->_eventManager = $eventManager;
    }

    /**
     * Gets the EventManager used by the Platform.
     *
     * @return \Doctrine\Common\EventManager
     */
    public function getEventManager()
    {
        return $this->_eventManager;
    }

134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185
    /**
     * Gets the SQL snippet that declares a boolean column.
     *
     * @param array $columnDef
     * @return string
     */
    abstract public function getBooleanTypeDeclarationSQL(array $columnDef);

    /**
     * Gets the SQL snippet that declares a 4 byte integer column.
     *
     * @param array $columnDef
     * @return string
     */
    abstract public function getIntegerTypeDeclarationSQL(array $columnDef);

    /**
     * Gets the SQL snippet that declares an 8 byte integer column.
     *
     * @param array $columnDef
     * @return string
     */
    abstract public function getBigIntTypeDeclarationSQL(array $columnDef);

    /**
     * Gets the SQL snippet that declares a 2 byte integer column.
     *
     * @param array $columnDef
     * @return string
     */
    abstract public function getSmallIntTypeDeclarationSQL(array $columnDef);

    /**
     * Gets the SQL snippet that declares common properties of an integer column.
     *
     * @param array $columnDef
     * @return string
     */
    abstract protected function _getCommonIntegerTypeDeclarationSQL(array $columnDef);

    /**
     * Lazy load Doctrine Type Mappings
     *
     * @return void
     */
    abstract protected function initializeDoctrineTypeMappings();

    /**
     * Gets the SQL snippet used to declare a VARCHAR column type.
     *
     * @param array $field
     */
186 187 188 189 190 191 192 193 194 195 196 197 198 199 200
    public function getVarcharTypeDeclarationSQL(array $field)
    {
        if ( !isset($field['length'])) {
            $field['length'] = $this->getVarcharDefaultLength();
        }

        $fixed = (isset($field['fixed'])) ? $field['fixed'] : false;

        if ($field['length'] > $this->getVarcharMaxLength()) {
            return $this->getClobTypeDeclarationSQL($field);
        } else {
            return $this->getVarcharTypeDeclarationSQLSnippet($field['length'], $fixed);
        }
    }

201 202 203 204 205 206 207 208 209 210 211 212 213 214
    /**
     * Get the SQL Snippet to create a GUID/UUID field.
     *
     * By default this maps directly to a VARCHAR and only maps to more
     * special datatypes when the underlying databases support this datatype.
     *
     * @param array $field
     * @return string
     */
    public function getGuidTypeDeclartionSQL(array $field)
    {
        return $this->getVarcharTypeDeclarationSQL($field);
    }

215 216 217 218
    protected function getVarcharTypeDeclarationSQLSnippet($length, $fixed)
    {
        throw DBALException::notSupported('VARCHARs not supported by Platform.');
    }
219 220 221 222 223 224 225 226

    /**
     * Gets the SQL snippet used to declare a CLOB column type.
     *
     * @param array $field
     */
    abstract public function getClobTypeDeclarationSQL(array $field);

227 228
    /**
     * Gets the SQL Snippet used to declare a BLOB column type.
229 230
     *
     * @param array $field
231 232 233
     */
    abstract public function getBlobTypeDeclarationSQL(array $field);

234 235 236 237 238 239 240
    /**
     * Gets the name of the platform.
     *
     * @return string
     */
    abstract public function getName();

241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262
    /**
     * Register a doctrine type to be used in conjunction with a column type of this platform.
     *
     * @param string $dbType
     * @param string $doctrineType
     */
    public function registerDoctrineTypeMapping($dbType, $doctrineType)
    {
        if ($this->doctrineTypeMapping === null) {
            $this->initializeDoctrineTypeMappings();
        }

        if (!Types\Type::hasType($doctrineType)) {
            throw DBALException::typeNotFound($doctrineType);
        }

        $dbType = strtolower($dbType);
        $this->doctrineTypeMapping[$dbType] = $doctrineType;
    }

    /**
     * Get the Doctrine type that is mapped for the given database column type.
263
     *
264 265 266 267 268 269 270 271
     * @param  string $dbType
     * @return string
     */
    public function getDoctrineTypeMapping($dbType)
    {
        if ($this->doctrineTypeMapping === null) {
            $this->initializeDoctrineTypeMappings();
        }
272

273
        $dbType = strtolower($dbType);
274
        if (!isset($this->doctrineTypeMapping[$dbType])) {
275 276
            throw new \Doctrine\DBAL\DBALException("Unknown database type ".$dbType." requested, " . get_class($this) . " may not support it.");
        }
277 278

        return $this->doctrineTypeMapping[$dbType];
279 280
    }

281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296
    /**
     * Check if a database type is currently supported by this platform.
     *
     * @param string $dbType
     * @return bool
     */
    public function hasDoctrineTypeMappingFor($dbType)
    {
        if ($this->doctrineTypeMapping === null) {
            $this->initializeDoctrineTypeMappings();
        }

        $dbType = strtolower($dbType);
        return isset($this->doctrineTypeMapping[$dbType]);
    }

297 298 299 300 301 302 303 304 305 306 307 308 309 310
    /**
     * Initialize the Doctrine Type comments instance variable for in_array() checks.
     *
     * @return void
     */
    protected function initializeCommentedDoctrineTypes()
    {
        $this->doctrineTypeComments = array(Type::TARRAY, Type::OBJECT);
    }

    /**
     * Is it necessary for the platform to add a parsable type comment to allow reverse engineering the given type?
     *
     * @param Type $doctrineType
311
     * @return boolean
312 313 314 315 316 317 318 319 320 321 322 323
     */
    public function isCommentedDoctrineType(Type $doctrineType)
    {
        if ($this->doctrineTypeComments === null) {
            $this->initializeCommentedDoctrineTypes();
        }

        return in_array($doctrineType->getName(), $this->doctrineTypeComments);
    }

    /**
     * Mark this type as to be commented in ALTER TABLE and CREATE TABLE statements.
324
     *
325 326 327 328 329 330 331 332 333 334 335 336 337
     * @param Type $doctrineType
     * @return void
     */
    public function markDoctrineTypeCommented(Type $doctrineType)
    {
        if ($this->doctrineTypeComments === null) {
            $this->initializeCommentedDoctrineTypes();
        }
        $this->doctrineTypeComments[] = $doctrineType->getName();
    }

    /**
     * Get the comment to append to a column comment that helps parsing this type in reverse engineering.
338
     *
339 340 341 342 343 344 345 346
     * @param Type $doctrineType
     * @return string
     */
    public function getDoctrineTypeComment(Type $doctrineType)
    {
        return '(DC2Type:' . $doctrineType->getName() . ')';
    }

347 348
    /**
     * Return the comment of a passed column modified by potential doctrine type comment hints.
349
     *
350 351 352 353 354 355 356 357 358 359 360 361
     * @param Column $column
     * @return string
     */
    protected function getColumnComment(Column $column)
    {
        $comment = $column->getComment();
        if ($this->isCommentedDoctrineType($column->getType())) {
            $comment .= $this->getDoctrineTypeComment($column->getType());
        }
        return $comment;
    }

362 363 364 365 366 367 368 369 370
    /**
     * Gets the character used for identifier quoting.
     *
     * @return string
     */
    public function getIdentifierQuoteCharacter()
    {
        return '"';
    }
371

372 373 374 375 376 377 378 379 380
    /**
     * Gets the string portion that starts an SQL comment.
     *
     * @return string
     */
    public function getSqlCommentStartString()
    {
        return "--";
    }
381

382
    /**
383
     * Gets the string portion that ends an SQL comment.
384 385 386 387 388 389 390
     *
     * @return string
     */
    public function getSqlCommentEndString()
    {
        return "\n";
    }
391

392 393 394 395 396 397
    /**
     * Gets the maximum length of a varchar field.
     *
     * @return integer
     */
    public function getVarcharMaxLength()
398 399 400 401 402 403 404 405 406 407
    {
        return 4000;
    }

    /**
     * Gets the default length of a varchar field.
     *
     * @return integer
     */
    public function getVarcharDefaultLength()
408 409 410
    {
        return 255;
    }
411

412 413 414 415 416 417 418 419 420
    /**
     * Gets all SQL wildcard characters of the platform.
     *
     * @return array
     */
    public function getWildcards()
    {
        return array('%', '_');
    }
421

422 423 424 425 426 427 428
    /**
     * Returns the regular expression operator.
     *
     * @return string
     */
    public function getRegexpExpression()
    {
429
        throw DBALException::notSupported(__METHOD__);
430
    }
431

432 433 434 435 436 437 438 439
    /**
     * Returns global unique identifier
     *
     * @return string to get global unique identifier
     */
    public function getGuidExpression()
    {
        throw DBALException::notSupported(__METHOD__);
440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506
    }

    /**
     * Returns the average value of a column
     *
     * @param string $column    the column to use
     * @return string           generated sql including an AVG aggregate function
     */
    public function getAvgExpression($column)
    {
        return 'AVG(' .  $column . ')';
    }

    /**
     * Returns the number of rows (without a NULL value) of a column
     *
     * If a '*' is used instead of a column the number of selected rows
     * is returned.
     *
     * @param string|integer $column    the column to use
     * @return string                   generated sql including a COUNT aggregate function
     */
    public function getCountExpression($column)
    {
        return 'COUNT(' . $column . ')';
    }

    /**
     * Returns the highest value of a column
     *
     * @param string $column    the column to use
     * @return string           generated sql including a MAX aggregate function
     */
    public function getMaxExpression($column)
    {
        return 'MAX(' . $column . ')';
    }

    /**
     * Returns the lowest value of a column
     *
     * @param string $column the column to use
     * @return string
     */
    public function getMinExpression($column)
    {
        return 'MIN(' . $column . ')';
    }

    /**
     * Returns the total sum of a column
     *
     * @param string $column the column to use
     * @return string
     */
    public function getSumExpression($column)
    {
        return 'SUM(' . $column . ')';
    }

    // scalar functions

    /**
     * Returns the md5 sum of a field.
     *
     * Note: Not SQL92, but common functionality
     *
507
     * @param string $column
508 509 510 511 512 513 514 515 516 517
     * @return string
     */
    public function getMd5Expression($column)
    {
        return 'MD5(' . $column . ')';
    }

    /**
     * Returns the length of a text field.
     *
518
     * @param string $column
519 520 521 522 523 524 525
     * @return string
     */
    public function getLengthExpression($column)
    {
        return 'LENGTH(' . $column . ')';
    }

526 527 528 529 530 531 532 533 534 535 536
    /**
     * Returns the squared value of a column
     *
     * @param string $column    the column to use
     * @return string           generated sql including an SQRT aggregate function
     */
    public function getSqrtExpression($column)
    {
        return 'SQRT(' . $column . ')';
    }

537 538 539
    /**
     * Rounds a numeric field to the number of decimals specified.
     *
540
     * @param string $column
541
     * @param integer $decimals
542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562
     * @return string
     */
    public function getRoundExpression($column, $decimals = 0)
    {
        return 'ROUND(' . $column . ', ' . $decimals . ')';
    }

    /**
     * Returns the remainder of the division operation
     * $expression1 / $expression2.
     *
     * @param string $expression1
     * @param string $expression2
     * @return string
     */
    public function getModExpression($expression1, $expression2)
    {
        return 'MOD(' . $expression1 . ', ' . $expression2 . ')';
    }

    /**
563
     * Trim a string, leading/trailing/both and with a given char which defaults to space.
564
     *
565 566 567
     * @param string $str
     * @param int $pos
     * @param string $char has to be quoted already
568 569
     * @return string
     */
570
    public function getTrimExpression($str, $pos = self::TRIM_UNSPECIFIED, $char = false)
571
    {
572 573
        $posStr = '';
        $trimChar = ($char != false) ? $char . ' FROM ' : '';
574

575 576 577 578 579 580 581 582 583
        if ($pos == self::TRIM_LEADING) {
            $posStr = 'LEADING '.$trimChar;
        } else if($pos == self::TRIM_TRAILING) {
            $posStr = 'TRAILING '.$trimChar;
        } else if($pos == self::TRIM_BOTH) {
            $posStr = 'BOTH '.$trimChar;
        }

        return 'TRIM(' . $posStr . $str . ')';
584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638
    }

    /**
     * rtrim
     * returns the string $str with proceeding space characters removed
     *
     * @param string $str       literal string or column name
     * @return string
     */
    public function getRtrimExpression($str)
    {
        return 'RTRIM(' . $str . ')';
    }

    /**
     * ltrim
     * returns the string $str with leading space characters removed
     *
     * @param string $str       literal string or column name
     * @return string
     */
    public function getLtrimExpression($str)
    {
        return 'LTRIM(' . $str . ')';
    }

    /**
     * upper
     * Returns the string $str with all characters changed to
     * uppercase according to the current character set mapping.
     *
     * @param string $str       literal string or column name
     * @return string
     */
    public function getUpperExpression($str)
    {
        return 'UPPER(' . $str . ')';
    }

    /**
     * lower
     * Returns the string $str with all characters changed to
     * lowercase according to the current character set mapping.
     *
     * @param string $str       literal string or column name
     * @return string
     */
    public function getLowerExpression($str)
    {
        return 'LOWER(' . $str . ')';
    }

    /**
     * returns the position of the first occurrence of substring $substr in string $str
     *
639 640
     * @param string  $str       literal string
     * @param string  $substr    literal string to find
641
     * @param integer $startPos  position to start at, beginning of string by default
642 643
     * @return integer
     */
644
    public function getLocateExpression($str, $substr, $startPos = false)
645
    {
646
        throw DBALException::notSupported(__METHOD__);
647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665
    }

    /**
     * Returns the current system date.
     *
     * @return string
     */
    public function getNowExpression()
    {
        return 'NOW()';
    }

    /**
     * return string to call a function to get a substring inside an SQL statement
     *
     * Note: Not SQL92, but common functionality.
     *
     * SQLite only supports the 2 parameter variant of this function
     *
666 667 668 669
     * @param  string $value         an sql string literal or column name/alias
     * @param  integer $from     where to start the substring portion
     * @param  integer $len       the substring portion length
     * @return string
670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690
     */
    public function getSubstringExpression($value, $from, $len = null)
    {
        if ($len === null)
            return 'SUBSTRING(' . $value . ' FROM ' . $from . ')';
        else {
            return 'SUBSTRING(' . $value . ' FROM ' . $from . ' FOR ' . $len . ')';
        }
    }

    /**
     * Returns a series of strings concatinated
     *
     * concat() accepts an arbitrary number of parameters. Each parameter
     * must contain an expression
     *
     * @param string $arg1, $arg2 ... $argN     strings that will be concatinated.
     * @return string
     */
    public function getConcatExpression()
    {
691
        return join(' || ' , func_get_args());
692 693 694 695 696 697 698 699 700 701 702 703 704
    }

    /**
     * Returns the SQL for a logical not.
     *
     * Example:
     * <code>
     * $q = new Doctrine_Query();
     * $e = $q->expr;
     * $q->select('*')->from('table')
     *   ->where($e->eq('id', $e->not('null'));
     * </code>
     *
705
     * @param string $expression
706 707 708 709
     * @return string a logical expression
     */
    public function getNotExpression($expression)
    {
710
        return 'NOT(' . $expression . ')';
711 712 713 714
    }

    /**
     * Returns the SQL to check if a value is one in a set of
715
     * given values.
716 717 718 719 720 721
     *
     * in() accepts an arbitrary number of parameters. The first parameter
     * must always specify the value that should be matched against. Successive
     * must contain a logical expression or an array with logical expressions.
     * These expressions will be matched against the first parameter.
     *
722 723
     * @param string $column                the value that should be matched against
     * @param string|array(string) $values  values that will be matched against $column
724 725 726 727 728 729 730 731 732 733
     * @return string logical expression
     */
    public function getInExpression($column, $values)
    {
        if ( ! is_array($values)) {
            $values = array($values);
        }
        $values = $this->getIdentifiers($values);

        if (count($values) == 0) {
734
            throw new \InvalidArgumentException('Values must not be empty.');
735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799
        }
        return $column . ' IN (' . implode(', ', $values) . ')';
    }

    /**
     * Returns SQL that checks if a expression is null.
     *
     * @param string $expression the expression that should be compared to null
     * @return string logical expression
     */
    public function getIsNullExpression($expression)
    {
        return $expression . ' IS NULL';
    }

    /**
     * Returns SQL that checks if a expression is not null.
     *
     * @param string $expression the expression that should be compared to null
     * @return string logical expression
     */
    public function getIsNotNullExpression($expression)
    {
        return $expression . ' IS NOT NULL';
    }

    /**
     * Returns SQL that checks if an expression evaluates to a value between
     * two values.
     *
     * The parameter $expression is checked if it is between $value1 and $value2.
     *
     * Note: There is a slight difference in the way BETWEEN works on some databases.
     * http://www.w3schools.com/sql/sql_between.asp. If you want complete database
     * independence you should avoid using between().
     *
     * @param string $expression the value to compare to
     * @param string $value1 the lower value to compare with
     * @param string $value2 the higher value to compare with
     * @return string logical expression
     */
    public function getBetweenExpression($expression, $value1, $value2)
    {
        return $expression . ' BETWEEN ' .$value1 . ' AND ' . $value2;
    }

    public function getAcosExpression($value)
    {
        return 'ACOS(' . $value . ')';
    }

    public function getSinExpression($value)
    {
        return 'SIN(' . $value . ')';
    }

    public function getPiExpression()
    {
        return 'PI()';
    }

    public function getCosExpression($value)
    {
        return 'COS(' . $value . ')';
    }
800

801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862
    /**
     * Calculate the difference in days between the two passed dates.
     *
     * Computes diff = date1 - date2
     *
     * @param string $date1
     * @param string $date2
     * @return string
     */
    public function getDateDiffExpression($date1, $date2)
    {
        throw DBALException::notSupported(__METHOD__);
    }

    /**
     * Add the number of given days to a date.
     *
     * @param string $date
     * @param int $days
     * @return string
     */
    public function getDateAddDaysExpression($date, $days)
    {
        throw DBALException::notSupported(__METHOD__);
    }

    /**
     * Substract the number of given days to a date.
     *
     * @param string $date
     * @param int $days
     * @return string
     */
    public function getDateSubDaysExpression($date, $days)
    {
        throw DBALException::notSupported(__METHOD__);
    }

    /**
     * Add the number of given months to a date.
     *
     * @param string $date
     * @param int $months
     * @return string
     */
    public function getDateAddMonthExpression($date, $months)
    {
        throw DBALException::notSupported(__METHOD__);
    }

    /**
     * Substract the number of given months to a date.
     *
     * @param string $date
     * @param int $months
     * @return string
     */
    public function getDateSubMonthExpression($date, $months)
    {
        throw DBALException::notSupported(__METHOD__);
    }

863
    /**
Fabio B. Silva's avatar
Fabio B. Silva committed
864
     * Gets SQL bit AND comparison  expression
865 866 867 868 869 870 871 872 873
     *
     * @param   string $value1
     * @param   string $value2
     * @return  string
     */
    public function getBitAndComparisonExpression($value1, $value2)
    {
        return '(' . $value1 . ' & ' . $value2 . ')';
    }
Fabio B. Silva's avatar
Fabio B. Silva committed
874

875
    /**
Fabio B. Silva's avatar
Fabio B. Silva committed
876
     * Gets SQL bit OR comparison expression
877 878 879 880 881 882 883 884 885 886
     *
     * @param   string $value1
     * @param   string $value2
     * @return  string
     */
    public function getBitOrComparisonExpression($value1, $value2)
    {
        return '(' . $value1 . ' | ' . $value2 . ')';
    }

887
    public function getForUpdateSQL()
888 889 890
    {
        return 'FOR UPDATE';
    }
891

892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928
    /**
     * Honors that some SQL vendors such as MsSql use table hints for locking instead of the ANSI SQL FOR UPDATE specification.
     *
     * @param  string $fromClause
     * @param  int $lockMode
     * @return string
     */
    public function appendLockHint($fromClause, $lockMode)
    {
        return $fromClause;
    }

    /**
     * Get the sql snippet to append to any SELECT statement which locks rows in shared read lock.
     *
     * This defaults to the ASNI SQL "FOR UPDATE", which is an exclusive lock (Write). Some database
     * vendors allow to lighten this constraint up to be a real read lock.
     *
     * @return string
     */
    public function getReadLockSQL()
    {
        return $this->getForUpdateSQL();
    }

    /**
     * Get the SQL snippet to append to any SELECT statement which obtains an exclusive lock on the rows.
     *
     * The semantics of this lock mode should equal the SELECT .. FOR UPDATE of the ASNI SQL standard.
     *
     * @return string
     */
    public function getWriteLockSQL()
    {
        return $this->getForUpdateSQL();
    }

929
    public function getDropDatabaseSQL($database)
930 931 932
    {
        return 'DROP DATABASE ' . $database;
    }
933

934 935
    /**
     * Drop a Table
936 937
     *
     * @throws \InvalidArgumentException
938 939 940
     * @param  Table|string $table
     * @return string
     */
941
    public function getDropTableSQL($table)
942
    {
943 944
        $tableArg = $table;

945
        if ($table instanceof \Doctrine\DBAL\Schema\Table) {
946
            $table = $table->getQuotedName($this);
947 948
        } else if(!is_string($table)) {
            throw new \InvalidArgumentException('getDropTableSQL() expects $table parameter to be string or \Doctrine\DBAL\Schema\Table.');
949 950
        }

951
        if (null !== $this->_eventManager && $this->_eventManager->hasListeners(Events::onSchemaDropTable)) {
952
            $eventArgs = new SchemaDropTableEventArgs($tableArg, $this);
953 954 955 956 957 958
            $this->_eventManager->dispatchEvent(Events::onSchemaDropTable, $eventArgs);

            if ($eventArgs->isDefaultPrevented()) {
                return $eventArgs->getSql();
            }
        }
959

960 961
        return 'DROP TABLE ' . $table;
    }
962

963 964 965
    /**
     * Get SQL to safely drop a temporary table WITHOUT implicitly committing an open transaction.
     *
966
     * @param Table|string $table
967 968 969 970 971 972 973
     * @return string
     */
    public function getDropTemporaryTableSQL($table)
    {
        return $this->getDropTableSQL($table);
    }

974 975 976 977 978 979 980
    /**
     * Drop index from a table
     *
     * @param Index|string $name
     * @param string|Table $table
     * @return string
     */
981
    public function getDropIndexSQL($index, $table=null)
982
    {
983
        if($index instanceof \Doctrine\DBAL\Schema\Index) {
984
            $index = $index->getQuotedName($this);
985
        } else if(!is_string($index)) {
986
            throw new \InvalidArgumentException('AbstractPlatform::getDropIndexSQL() expects $index parameter to be string or \Doctrine\DBAL\Schema\Index.');
987 988 989
        }

        return 'DROP INDEX ' . $index;
990
    }
991

992 993
    /**
     * Get drop constraint sql
994
     *
995 996 997 998
     * @param  \Doctrine\DBAL\Schema\Constraint $constraint
     * @param  string|Table $table
     * @return string
     */
999
    public function getDropConstraintSQL($constraint, $table)
1000
    {
1001
        if ($constraint instanceof \Doctrine\DBAL\Schema\Constraint) {
1002
            $constraint = $constraint->getQuotedName($this);
1003 1004
        }

1005
        if ($table instanceof \Doctrine\DBAL\Schema\Table) {
1006
            $table = $table->getQuotedName($this);
1007 1008 1009
        }

        return 'ALTER TABLE ' . $table . ' DROP CONSTRAINT ' . $constraint;
1010
    }
1011

1012 1013 1014 1015 1016
    /**
     * @param  ForeignKeyConstraint|string $foreignKey
     * @param  Table|string $table
     * @return string
     */
1017
    public function getDropForeignKeySQL($foreignKey, $table)
1018
    {
1019
        if ($foreignKey instanceof \Doctrine\DBAL\Schema\ForeignKeyConstraint) {
1020
            $foreignKey = $foreignKey->getQuotedName($this);
1021 1022 1023
        }

        if ($table instanceof \Doctrine\DBAL\Schema\Table) {
1024
            $table = $table->getQuotedName($this);
1025 1026 1027
        }

        return 'ALTER TABLE ' . $table . ' DROP FOREIGN KEY ' . $foreignKey;
1028
    }
1029

1030
    /**
1031
     * Gets the SQL statement(s) to create a table with the specified name, columns and constraints
1032
     * on this platform.
1033
     *
1034
     * @param string $table The name of the table.
1035
     * @param int $createFlags
1036
     * @return array The sequence of SQL statements.
1037
     */
1038
    public function getCreateTableSQL(Table $table, $createFlags=self::CREATE_INDEXES)
1039
    {
1040
        if ( ! is_int($createFlags)) {
1041
            throw new \InvalidArgumentException("Second argument of AbstractPlatform::getCreateTableSQL() has to be integer.");
1042 1043
        }

1044 1045 1046 1047
        if (count($table->getColumns()) == 0) {
            throw DBALException::noColumnsSpecifiedForTable($table->getName());
        }

1048
        $tableName = $table->getQuotedName($this);
1049 1050 1051 1052 1053
        $options = $table->getOptions();
        $options['uniqueConstraints'] = array();
        $options['indexes'] = array();
        $options['primary'] = array();

1054
        if (($createFlags&self::CREATE_INDEXES) > 0) {
1055
            foreach ($table->getIndexes() as $index) {
1056 1057 1058
                /* @var $index Index */
                if ($index->isPrimary()) {
                    $options['primary'] = $index->getColumns();
1059
                    $options['primary_index'] = $index;
1060 1061 1062
                } else {
                    $options['indexes'][$index->getName()] = $index;
                }
1063 1064
            }
        }
1065

1066
        $columnSql = array();
1067
        $columns = array();
1068
        foreach ($table->getColumns() as $column) {
1069
            /* @var \Doctrine\DBAL\Schema\Column $column */
1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081

            if (null !== $this->_eventManager && $this->_eventManager->hasListeners(Events::onSchemaCreateTableColumn)) {
                $eventArgs = new SchemaCreateTableColumnEventArgs($column, $table, $this);
                $this->_eventManager->dispatchEvent(Events::onSchemaCreateTableColumn, $eventArgs);

                $columnSql = array_merge($columnSql, $eventArgs->getSql());

                if ($eventArgs->isDefaultPrevented()) {
                    continue;
                }
            }

1082
            $columnData = array();
1083
            $columnData['name'] = $column->getQuotedName($this);
1084 1085 1086
            $columnData['type'] = $column->getType();
            $columnData['length'] = $column->getLength();
            $columnData['notnull'] = $column->getNotNull();
1087
            $columnData['fixed'] = $column->getFixed();
1088
            $columnData['unique'] = false; // TODO: what do we do about this?
1089 1090 1091 1092
            $columnData['version'] = ($column->hasPlatformOption("version"))?$column->getPlatformOption('version'):false;
            if(strtolower($columnData['type']) == "string" && $columnData['length'] === null) {
                $columnData['length'] = 255;
            }
1093
            $columnData['unsigned'] = $column->getUnsigned();
1094 1095 1096
            $columnData['precision'] = $column->getPrecision();
            $columnData['scale'] = $column->getScale();
            $columnData['default'] = $column->getDefault();
1097
            $columnData['columnDefinition'] = $column->getColumnDefinition();
1098
            $columnData['autoincrement'] = $column->getAutoincrement();
1099
            $columnData['comment'] = $this->getColumnComment($column);
1100 1101 1102 1103 1104 1105 1106 1107

            if(in_array($column->getName(), $options['primary'])) {
                $columnData['primary'] = true;
            }

            $columns[$columnData['name']] = $columnData;
        }

1108 1109
        if (($createFlags&self::CREATE_FOREIGNKEYS) > 0) {
            $options['foreignKeys'] = array();
1110
            foreach ($table->getForeignKeys() as $fkConstraint) {
1111 1112 1113 1114
                $options['foreignKeys'][] = $fkConstraint;
            }
        }

1115 1116 1117
        if (null !== $this->_eventManager && $this->_eventManager->hasListeners(Events::onSchemaCreateTable)) {
            $eventArgs = new SchemaCreateTableEventArgs($table, $columns, $options, $this);
            $this->_eventManager->dispatchEvent(Events::onSchemaCreateTable, $eventArgs);
1118

Jan Sorgalla's avatar
Jan Sorgalla committed
1119 1120 1121
            if ($eventArgs->isDefaultPrevented()) {
                return array_merge($eventArgs->getSql(), $columnSql);
            }
1122
        }
1123

1124 1125
        $sql = $this->_getCreateTableSQL($tableName, $columns, $options);
        if ($this->supportsCommentOnStatement()) {
1126
            foreach ($table->getColumns() as $column) {
1127
                if ($this->getColumnComment($column)) {
1128
                    $sql[] = $this->getCommentOnColumnSQL($tableName, $column->getName(), $this->getColumnComment($column));
1129 1130 1131
                }
            }
        }
1132

Jan Sorgalla's avatar
Jan Sorgalla committed
1133
        return array_merge($sql, $columnSql);
1134 1135 1136 1137
    }

    public function getCommentOnColumnSQL($tableName, $columnName, $comment)
    {
1138
        return "COMMENT ON COLUMN " . $tableName . "." . $columnName . " IS '" . $comment . "'";
1139 1140 1141
    }

    /**
1142
     * @param string $tableName
1143 1144 1145 1146
     * @param array $columns
     * @param array $options
     * @return array
     */
1147
    protected function _getCreateTableSQL($tableName, array $columns, array $options = array())
1148
    {
1149
        $columnListSql = $this->getColumnDeclarationListSQL($columns);
1150

1151
        if (isset($options['uniqueConstraints']) && ! empty($options['uniqueConstraints'])) {
1152
            foreach ($options['uniqueConstraints'] as $name => $definition) {
1153
                $columnListSql .= ', ' . $this->getUniqueConstraintDeclarationSQL($name, $definition);
1154 1155
            }
        }
1156

1157
        if (isset($options['primary']) && ! empty($options['primary'])) {
1158
            $columnListSql .= ', PRIMARY KEY(' . implode(', ', array_unique(array_values($options['primary']))) . ')';
1159 1160 1161 1162
        }

        if (isset($options['indexes']) && ! empty($options['indexes'])) {
            foreach($options['indexes'] as $index => $definition) {
1163
                $columnListSql .= ', ' . $this->getIndexDeclarationSQL($index, $definition);
1164 1165 1166
            }
        }

1167
        $query = 'CREATE TABLE ' . $tableName . ' (' . $columnListSql;
1168

1169
        $check = $this->getCheckDeclarationSQL($columns);
1170 1171
        if ( ! empty($check)) {
            $query .= ', ' . $check;
1172
        }
1173 1174 1175 1176 1177
        $query .= ')';

        $sql[] = $query;

        if (isset($options['foreignKeys'])) {
1178
            foreach ((array) $options['foreignKeys'] as $definition) {
1179
                $sql[] = $this->getCreateForeignKeySQL($definition, $tableName);
1180 1181
            }
        }
1182

1183 1184
        return $sql;
    }
1185

1186
    public function getCreateTemporaryTableSnippetSQL()
1187 1188 1189
    {
        return "CREATE TEMPORARY TABLE";
    }
1190

1191
    /**
1192
     * Gets the SQL to create a sequence on this platform.
1193
     *
1194
     * @param \Doctrine\DBAL\Schema\Sequence $sequence
1195
     * @throws DBALException
1196
     */
1197
    public function getCreateSequenceSQL(\Doctrine\DBAL\Schema\Sequence $sequence)
1198
    {
1199
        throw DBALException::notSupported(__METHOD__);
1200
    }
1201

1202 1203
    /**
     * Gets the SQL statement to change a sequence on this platform.
1204 1205
     *
     * @param \Doctrine\DBAL\Schema\Sequence $sequence
1206 1207 1208 1209 1210 1211
     * @return string
     */
    public function getAlterSequenceSQL(\Doctrine\DBAL\Schema\Sequence $sequence)
    {
        throw DBALException::notSupported(__METHOD__);
    }
1212

1213
    /**
1214
     * Gets the SQL to create a constraint on a table on this platform.
1215
     *
1216
     * @param \Doctrine\DBAL\Schema\Constraint $constraint
1217
     * @param string|Table $table
1218
     * @return string
1219
     */
1220
    public function getCreateConstraintSQL(\Doctrine\DBAL\Schema\Constraint $constraint, $table)
1221
    {
1222
        if ($table instanceof \Doctrine\DBAL\Schema\Table) {
1223
            $table = $table->getQuotedName($this);
1224 1225
        }

1226
        $query = 'ALTER TABLE ' . $table . ' ADD CONSTRAINT ' . $constraint->getQuotedName($this);
1227

1228
        $columns = array();
1229
        foreach ($constraint->getColumns() as $column) {
1230
            $columns[] = $column;
1231
        }
1232 1233 1234 1235 1236 1237 1238 1239 1240 1241
        $columnList = '('. implode(', ', $columns) . ')';

        $referencesClause = '';
        if ($constraint instanceof \Doctrine\DBAL\Schema\Index) {
            if($constraint->isPrimary()) {
                $query .= ' PRIMARY KEY';
            } elseif ($constraint->isUnique()) {
                $query .= ' UNIQUE';
            } else {
                throw new \InvalidArgumentException(
1242
                    'Can only create primary or unique constraints, no common indexes with getCreateConstraintSQL().'
1243 1244 1245 1246 1247 1248
                );
            }
        } else if ($constraint instanceof \Doctrine\DBAL\Schema\ForeignKeyConstraint) {
            $query .= ' FOREIGN KEY';

            $foreignColumns = array();
1249
            foreach ($constraint->getForeignColumns() as $column) {
1250 1251
                $foreignColumns[] = $column;
            }
1252

1253 1254 1255
            $referencesClause = ' REFERENCES '.$constraint->getForeignTableName(). ' ('.implode(', ', $foreignColumns).')';
        }
        $query .= ' '.$columnList.$referencesClause;
1256 1257 1258

        return $query;
    }
1259

1260
    /**
1261
     * Gets the SQL to create an index on a table on this platform.
1262
     *
1263 1264
     * @param Index $index
     * @param string|Table $table name of the table on which the index is to be created
1265 1266
     * @return string
     */
1267
    public function getCreateIndexSQL(Index $index, $table)
1268
    {
1269
        if ($table instanceof Table) {
1270
            $table = $table->getQuotedName($this);
1271
        }
1272
        $name = $index->getQuotedName($this);
1273 1274 1275 1276
        $columns = $index->getColumns();

        if (count($columns) == 0) {
            throw new \InvalidArgumentException("Incomplete definition. 'columns' required.");
1277
        }
1278

1279 1280 1281
        if ($index->isPrimary()) {
            return $this->getCreatePrimaryKeySQL($index, $table);
        } else {
1282

1283
            $query = 'CREATE ' . $this->getCreateIndexSQLFlags($index) . 'INDEX ' . $name . ' ON ' . $table;
1284
            $query .= ' (' . $this->getIndexFieldDeclarationListSQL($columns) . ')';
1285 1286 1287 1288
        }

        return $query;
    }
1289

1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304
    /**
     * Adds additional flags for index generation
     *
     * @param Index $index
     * @return string
     */
    protected function getCreateIndexSQLFlags(Index $index)
    {
        $type = '';
        if ($index->isUnique()) {
            $type = 'UNIQUE ';
        }
        return $type;
    }

1305 1306
    /**
     * Get SQL to create an unnamed primary key constraint.
1307
     *
1308 1309 1310 1311 1312 1313 1314 1315
     * @param Index $index
     * @param string|Table $table
     * @return string
     */
    public function getCreatePrimaryKeySQL(Index $index, $table)
    {
        return 'ALTER TABLE ' . $table . ' ADD PRIMARY KEY (' . $this->getIndexFieldDeclarationListSQL($index->getColumns()) . ')';
    }
1316

1317
    /**
1318
     * Quotes a string so that it can be safely used as a table or column name,
1319
     * even if it is a reserved word of the platform. This also detects identifier
1320
     * chains separated by dot and quotes them independently.
1321
     *
1322
     * NOTE: Just because you CAN use quoted identifiers doesn't mean
1323 1324 1325 1326 1327 1328 1329
     * you SHOULD use them.  In general, they end up causing way more
     * problems than they solve.
     *
     * @param string $str           identifier name to be quoted
     * @return string               quoted identifier string
     */
    public function quoteIdentifier($str)
1330 1331 1332 1333 1334 1335 1336 1337 1338 1339
    {
        if (strpos($str, ".") !== false) {
            $parts = array_map(array($this, "quoteIdentifier"), explode(".", $str));
            return implode(".", $parts);
        }

        return $this->quoteSingleIdentifier($str);
    }

    /**
1340
     * Quote a single identifier (no dot chain separation)
1341 1342 1343 1344 1345
     *
     * @param string $str
     * @return string
     */
    public function quoteSingleIdentifier($str)
1346 1347 1348
    {
        $c = $this->getIdentifierQuoteCharacter();

1349
        return $c . str_replace($c, $c.$c, $str) . $c;
1350
    }
1351

1352
    /**
1353
     * Create a new foreign key
1354
     *
1355 1356
     * @param ForeignKeyConstraint  $foreignKey    ForeignKey instance
     * @param string|Table          $table         name of the table on which the foreign key is to be created
1357 1358
     * @return string
     */
1359
    public function getCreateForeignKeySQL(ForeignKeyConstraint $foreignKey, $table)
1360
    {
1361
        if ($table instanceof \Doctrine\DBAL\Schema\Table) {
1362
            $table = $table->getQuotedName($this);
1363 1364
        }

1365
        $query = 'ALTER TABLE ' . $table . ' ADD ' . $this->getForeignKeyDeclarationSQL($foreignKey);
1366 1367 1368

        return $query;
    }
1369

1370
    /**
1371 1372 1373
     * Gets the sql statements for altering an existing table.
     *
     * The method returns an array of sql statements, since some platforms need several statements.
1374
     *
1375
     * @param TableDiff $diff
1376
     * @return array
1377
     */
1378
    public function getAlterTableSQL(TableDiff $diff)
1379
    {
1380
        throw DBALException::notSupported(__METHOD__);
1381
    }
1382

1383 1384 1385 1386
    /**
     * @param Column $column
     * @param TableDiff $diff
     * @param array $columnSql
1387
     * @return boolean
1388 1389 1390 1391 1392 1393 1394
     */
    protected function onSchemaAlterTableAddColumn(Column $column, TableDiff $diff, &$columnSql)
    {
        if (null === $this->_eventManager) {
            return false;
        }

1395
        if ( ! $this->_eventManager->hasListeners(Events::onSchemaAlterTableAddColumn)) {
1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410
            return false;
        }

        $eventArgs = new SchemaAlterTableAddColumnEventArgs($column, $diff, $this);
        $this->_eventManager->dispatchEvent(Events::onSchemaAlterTableAddColumn, $eventArgs);

        $columnSql = array_merge($columnSql, $eventArgs->getSql());

        return $eventArgs->isDefaultPrevented();
    }

    /**
     * @param Column $column
     * @param TableDiff $diff
     * @param array $columnSql
1411
     * @return boolean
1412 1413 1414 1415 1416 1417 1418
     */
    protected function onSchemaAlterTableRemoveColumn(Column $column, TableDiff $diff, &$columnSql)
    {
        if (null === $this->_eventManager) {
            return false;
        }

1419
        if ( ! $this->_eventManager->hasListeners(Events::onSchemaAlterTableRemoveColumn)) {
1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434
            return false;
        }

        $eventArgs = new SchemaAlterTableRemoveColumnEventArgs($column, $diff, $this);
        $this->_eventManager->dispatchEvent(Events::onSchemaAlterTableRemoveColumn, $eventArgs);

        $columnSql = array_merge($columnSql, $eventArgs->getSql());

        return $eventArgs->isDefaultPrevented();
    }

    /**
     * @param ColumnDiff $columnDiff
     * @param TableDiff $diff
     * @param array $columnSql
1435
     * @return boolean
1436 1437 1438 1439 1440 1441 1442
     */
    protected function onSchemaAlterTableChangeColumn(ColumnDiff $columnDiff, TableDiff $diff, &$columnSql)
    {
        if (null === $this->_eventManager) {
            return false;
        }

1443
        if ( ! $this->_eventManager->hasListeners(Events::onSchemaAlterTableChangeColumn)) {
1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459
            return false;
        }

        $eventArgs = new SchemaAlterTableChangeColumnEventArgs($columnDiff, $diff, $this);
        $this->_eventManager->dispatchEvent(Events::onSchemaAlterTableChangeColumn, $eventArgs);

        $columnSql = array_merge($columnSql, $eventArgs->getSql());

        return $eventArgs->isDefaultPrevented();
    }

    /**
     * @param string $oldColumnName
     * @param Column $column
     * @param TableDiff $diff
     * @param array $columnSql
1460
     * @return boolean
1461 1462 1463 1464 1465 1466 1467
     */
    protected function onSchemaAlterTableRenameColumn($oldColumnName, Column $column, TableDiff $diff, &$columnSql)
    {
        if (null === $this->_eventManager) {
            return false;
        }

1468
        if ( ! $this->_eventManager->hasListeners(Events::onSchemaAlterTableRenameColumn)) {
1469 1470 1471 1472 1473 1474 1475 1476 1477 1478
            return false;
        }

        $eventArgs = new SchemaAlterTableRenameColumnEventArgs($oldColumnName, $column, $diff, $this);
        $this->_eventManager->dispatchEvent(Events::onSchemaAlterTableRenameColumn, $eventArgs);

        $columnSql = array_merge($columnSql, $eventArgs->getSql());

        return $eventArgs->isDefaultPrevented();
    }
1479 1480
    /**
     * @param TableDiff $diff
1481 1482
     * @param array $qql
     * @return boolean
1483 1484 1485 1486 1487 1488 1489
     */
    protected function onSchemaAlterTable(TableDiff $diff, &$sql)
    {
        if (null === $this->_eventManager) {
            return false;
        }

1490
        if ( ! $this->_eventManager->hasListeners(Events::onSchemaAlterTable)) {
1491 1492 1493 1494 1495 1496 1497 1498 1499 1500
            return false;
        }

        $eventArgs = new SchemaAlterTableEventArgs($diff, $this);
        $this->_eventManager->dispatchEvent(Events::onSchemaAlterTable, $eventArgs);

        $sql = array_merge($sql, $eventArgs->getSql());

        return $eventArgs->isDefaultPrevented();
    }
1501

1502 1503 1504
    protected function getPreAlterTableIndexForeignKeySQL(TableDiff $diff)
    {
        $tableName = $diff->name;
1505

1506 1507
        $sql = array();
        if ($this->supportsForeignKeyConstraints()) {
1508
            foreach ($diff->removedForeignKeys as $foreignKey) {
1509 1510
                $sql[] = $this->getDropForeignKeySQL($foreignKey, $tableName);
            }
1511
            foreach ($diff->changedForeignKeys as $foreignKey) {
1512 1513 1514 1515
                $sql[] = $this->getDropForeignKeySQL($foreignKey, $tableName);
            }
        }

1516
        foreach ($diff->removedIndexes as $index) {
1517 1518
            $sql[] = $this->getDropIndexSQL($index, $tableName);
        }
1519
        foreach ($diff->changedIndexes as $index) {
1520 1521 1522 1523 1524
            $sql[] = $this->getDropIndexSQL($index, $tableName);
        }

        return $sql;
    }
1525

1526
    protected function getPostAlterTableIndexForeignKeySQL(TableDiff $diff)
1527
    {
1528 1529 1530 1531 1532 1533
        if ($diff->newName !== false) {
            $tableName = $diff->newName;
        } else {
            $tableName = $diff->name;
        }

1534 1535
        $sql = array();
        if ($this->supportsForeignKeyConstraints()) {
1536
            foreach ($diff->addedForeignKeys as $foreignKey) {
1537
                $sql[] = $this->getCreateForeignKeySQL($foreignKey, $tableName);
1538
            }
1539
            foreach ($diff->changedForeignKeys as $foreignKey) {
1540
                $sql[] = $this->getCreateForeignKeySQL($foreignKey, $tableName);
1541 1542 1543
            }
        }

1544
        foreach ($diff->addedIndexes as $index) {
1545
            $sql[] = $this->getCreateIndexSQL($index, $tableName);
1546
        }
1547
        foreach ($diff->changedIndexes as $index) {
1548
            $sql[] = $this->getCreateIndexSQL($index, $tableName);
1549 1550 1551 1552
        }

        return $sql;
    }
1553

1554 1555 1556 1557 1558 1559 1560 1561 1562 1563
    /**
     * Common code for alter table statement generation that updates the changed Index and Foreign Key definitions.
     *
     * @param TableDiff $diff
     * @return array
     */
    protected function _getAlterTableIndexForeignKeySQL(TableDiff $diff)
    {
        return array_merge($this->getPreAlterTableIndexForeignKeySQL($diff), $this->getPostAlterTableIndexForeignKeySQL($diff));
    }
1564

1565
    /**
1566
     * Get declaration of a number of fields in bulk
1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593
     *
     * @param array $fields  a multidimensional associative array.
     *      The first dimension determines the field name, while the second
     *      dimension is keyed with the name of the properties
     *      of the field being declared as array indexes. Currently, the types
     *      of supported field properties are as follows:
     *
     *      length
     *          Integer value that determines the maximum length of the text
     *          field. If this argument is missing the field should be
     *          declared to have the longest length allowed by the DBMS.
     *
     *      default
     *          Text value to be used as default for this field.
     *
     *      notnull
     *          Boolean flag that indicates whether this field is constrained
     *          to not be set to null.
     *      charset
     *          Text value with the default CHARACTER SET for this field.
     *      collation
     *          Text value with the default COLLATION for this field.
     *      unique
     *          unique constraint
     *
     * @return string
     */
1594
    public function getColumnDeclarationListSQL(array $fields)
1595
    {
1596
        $queryFields = array();
1597
        foreach ($fields as $fieldName => $field) {
1598
            $query = $this->getColumnDeclarationSQL($fieldName, $field);
1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631
            $queryFields[] = $query;
        }
        return implode(', ', $queryFields);
    }

    /**
     * Obtain DBMS specific SQL code portion needed to declare a generic type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name   name the field to be declared.
     * @param array  $field  associative array with the name of the properties
     *      of the field being declared as array indexes. Currently, the types
     *      of supported field properties are as follows:
     *
     *      length
     *          Integer value that determines the maximum length of the text
     *          field. If this argument is missing the field should be
     *          declared to have the longest length allowed by the DBMS.
     *
     *      default
     *          Text value to be used as default for this field.
     *
     *      notnull
     *          Boolean flag that indicates whether this field is constrained
     *          to not be set to null.
     *      charset
     *          Text value with the default CHARACTER SET for this field.
     *      collation
     *          Text value with the default COLLATION for this field.
     *      unique
     *          unique constraint
     *      check
     *          column check constraint
1632 1633
     *      columnDefinition
     *          a string that defines the complete column
1634
     *
1635
     * @return string  DBMS specific SQL code portion that should be used to declare the column.
1636
     */
1637
    public function getColumnDeclarationSQL($name, array $field)
1638
    {
1639
        if (isset($field['columnDefinition'])) {
1640
            $columnDef = $this->getCustomTypeDeclarationSQL($field);
1641
        } else {
1642
            $default = $this->getDefaultValueDeclarationSQL($field);
1643

1644
            $charset = (isset($field['charset']) && $field['charset']) ?
1645
                    ' ' . $this->getColumnCharsetDeclarationSQL($field['charset']) : '';
1646

1647
            $collation = (isset($field['collation']) && $field['collation']) ?
1648
                    ' ' . $this->getColumnCollationDeclarationSQL($field['collation']) : '';
1649

1650
            $notnull = (isset($field['notnull']) && $field['notnull']) ? ' NOT NULL' : '';
1651

1652
            $unique = (isset($field['unique']) && $field['unique']) ?
1653
                    ' ' . $this->getUniqueFieldDeclarationSQL() : '';
1654

1655 1656
            $check = (isset($field['check']) && $field['check']) ?
                    ' ' . $field['check'] : '';
1657

1658 1659 1660
            $typeDecl = $field['type']->getSqlDeclaration($field, $this);
            $columnDef = $typeDecl . $charset . $default . $notnull . $unique . $check . $collation;
        }
1661

1662 1663 1664 1665
        if ($this->supportsInlineColumnComments() && isset($field['comment']) && $field['comment']) {
            $columnDef .= " COMMENT '" . $field['comment'] . "'";
        }

1666
        return $name . ' ' . $columnDef;
1667
    }
1668

1669 1670 1671 1672 1673 1674
    /**
     * Gets the SQL snippet that declares a floating point column of arbitrary precision.
     *
     * @param array $columnDef
     * @return string
     */
1675
    public function getDecimalTypeDeclarationSQL(array $columnDef)
1676 1677
    {
        $columnDef['precision'] = ( ! isset($columnDef['precision']) || empty($columnDef['precision']))
1678
            ? 10 : $columnDef['precision'];
1679 1680
        $columnDef['scale'] = ( ! isset($columnDef['scale']) || empty($columnDef['scale']))
            ? 0 : $columnDef['scale'];
1681

1682 1683
        return 'NUMERIC(' . $columnDef['precision'] . ', ' . $columnDef['scale'] . ')';
    }
1684 1685 1686 1687 1688 1689 1690 1691

    /**
     * Obtain DBMS specific SQL code portion needed to set a default value
     * declaration to be used in statements like CREATE TABLE.
     *
     * @param array $field      field definition array
     * @return string           DBMS specific SQL code portion needed to set a default value
     */
1692
    public function getDefaultValueDeclarationSQL($field)
1693
    {
1694
        $default = empty($field['notnull']) ? ' DEFAULT NULL' : '';
1695

1696
        if (isset($field['default'])) {
1697 1698 1699 1700
            $default = " DEFAULT '".$field['default']."'";
            if (isset($field['type'])) {
                if (in_array((string)$field['type'], array("Integer", "BigInteger", "SmallInteger"))) {
                    $default = " DEFAULT ".$field['default'];
1701 1702
                } else if ((string)$field['type'] == 'DateTime' && $field['default'] == $this->getCurrentTimestampSQL()) {
                    $default = " DEFAULT ".$this->getCurrentTimestampSQL();
1703
                } else if ((string) $field['type'] == 'Boolean') {
1704
                    $default = " DEFAULT '" . $this->convertBooleans($field['default']) . "'";
1705 1706
                }
            }
1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717
        }
        return $default;
    }

    /**
     * Obtain DBMS specific SQL code portion needed to set a CHECK constraint
     * declaration to be used in statements like CREATE TABLE.
     *
     * @param array $definition     check definition
     * @return string               DBMS specific SQL code portion needed to set a CHECK constraint
     */
1718
    public function getCheckDeclarationSQL(array $definition)
1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736
    {
        $constraints = array();
        foreach ($definition as $field => $def) {
            if (is_string($def)) {
                $constraints[] = 'CHECK (' . $def . ')';
            } else {
                if (isset($def['min'])) {
                    $constraints[] = 'CHECK (' . $field . ' >= ' . $def['min'] . ')';
                }

                if (isset($def['max'])) {
                    $constraints[] = 'CHECK (' . $field . ' <= ' . $def['max'] . ')';
                }
            }
        }

        return implode(', ', $constraints);
    }
1737

1738 1739 1740 1741 1742 1743
    /**
     * Obtain DBMS specific SQL code portion needed to set a unique
     * constraint declaration to be used in statements like CREATE TABLE.
     *
     * @param string $name          name of the unique constraint
     * @param Index $index          index definition
1744
     * @return string               DBMS specific SQL code portion needed
1745 1746
     *                              to set a constraint
     */
1747
    public function getUniqueConstraintDeclarationSQL($name, Index $index)
1748 1749
    {
        if (count($index->getColumns()) == 0) {
1750
            throw new \InvalidArgumentException("Incomplete definition. 'columns' required.");
1751
        }
1752

1753
        return 'CONSTRAINT ' . $name . ' UNIQUE ('
1754
             . $this->getIndexFieldDeclarationListSQL($index->getColumns())
1755 1756
             . ')';
    }
1757 1758 1759 1760 1761 1762

    /**
     * Obtain DBMS specific SQL code portion needed to set an index
     * declaration to be used in statements like CREATE TABLE.
     *
     * @param string $name          name of the index
1763
     * @param Index $index          index definition
1764 1765
     * @return string               DBMS specific SQL code portion needed to set an index
     */
1766
    public function getIndexDeclarationSQL($name, Index $index)
1767
    {
1768
        $type = '';
1769

1770
        if($index->isUnique()) {
1771
            $type = 'UNIQUE ';
1772 1773
        }

1774
        if (count($index->getColumns()) == 0) {
1775
            throw new \InvalidArgumentException("Incomplete definition. 'columns' required.");
1776 1777
        }

1778
        return $type . 'INDEX ' . $name . ' ('
1779
             . $this->getIndexFieldDeclarationListSQL($index->getColumns())
1780
             . ')';
1781 1782
    }

1783 1784 1785 1786 1787 1788
    /**
     * getCustomTypeDeclarationSql
     * Obtail SQL code portion needed to create a custom column,
     * e.g. when a field has the "columnDefinition" keyword.
     * Only "AUTOINCREMENT" and "PRIMARY KEY" are added if appropriate.
     *
1789
     * @param array $columnDef
1790 1791
     * @return string
     */
1792
    public function getCustomTypeDeclarationSQL(array $columnDef)
1793 1794 1795 1796
    {
        return $columnDef['columnDefinition'];
    }

1797 1798 1799 1800 1801
    /**
     * getIndexFieldDeclarationList
     * Obtain DBMS specific SQL code portion needed to set an index
     * declaration to be used in statements like CREATE TABLE.
     *
1802
     * @param array $fields
1803 1804
     * @return string
     */
1805
    public function getIndexFieldDeclarationListSQL(array $fields)
1806 1807 1808 1809
    {
        $ret = array();
        foreach ($fields as $field => $definition) {
            if (is_array($definition)) {
1810
                $ret[] = $field;
1811
            } else {
1812
                $ret[] = $definition;
1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831
            }
        }
        return implode(', ', $ret);
    }

    /**
     * A method to return the required SQL string that fits between CREATE ... TABLE
     * to create the table as a temporary table.
     *
     * Should be overridden in driver classes to return the correct string for the
     * specific database type.
     *
     * The default is to return the string "TEMPORARY" - this will result in a
     * SQL error for any database that does not support temporary tables, or that
     * requires a different SQL command from "CREATE TEMPORARY TABLE".
     *
     * @return string The string required to be placed between "CREATE" and "TABLE"
     *                to generate a temporary table, if possible.
     */
1832
    public function getTemporaryTableSQL()
1833 1834 1835
    {
        return 'TEMPORARY';
    }
1836

1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847
    /**
     * Some vendors require temporary table names to be qualified specially.
     *
     * @param  string $tableName
     * @return string
     */
    public function getTemporaryTableName($tableName)
    {
        return $tableName;
    }

1848
    /**
1849
     * Get sql query to show a list of database.
1850
     *
1851
     * @return string
1852
     */
1853
    public function getShowDatabasesSQL()
1854
    {
1855
        throw DBALException::notSupported(__METHOD__);
1856
    }
1857

1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898
    /**
     * Obtain DBMS specific SQL code portion needed to set the FOREIGN KEY constraint
     * of a field declaration to be used in statements like CREATE TABLE.
     *
     * @param array $definition         an associative array with the following structure:
     *          name                    optional constraint name
     *
     *          local                   the local field(s)
     *
     *          foreign                 the foreign reference field(s)
     *
     *          foreignTable            the name of the foreign table
     *
     *          onDelete                referential delete action
     *
     *          onUpdate                referential update action
     *
     *          deferred                deferred constraint checking
     *
     * The onDelete and onUpdate keys accept the following values:
     *
     * CASCADE: Delete or update the row from the parent table and automatically delete or
     *          update the matching rows in the child table. Both ON DELETE CASCADE and ON UPDATE CASCADE are supported.
     *          Between two tables, you should not define several ON UPDATE CASCADE clauses that act on the same column
     *          in the parent table or in the child table.
     *
     * SET NULL: Delete or update the row from the parent table and set the foreign key column or columns in the
     *          child table to NULL. This is valid only if the foreign key columns do not have the NOT NULL qualifier
     *          specified. Both ON DELETE SET NULL and ON UPDATE SET NULL clauses are supported.
     *
     * NO ACTION: In standard SQL, NO ACTION means no action in the sense that an attempt to delete or update a primary
     *           key value is not allowed to proceed if there is a related foreign key value in the referenced table.
     *
     * RESTRICT: Rejects the delete or update operation for the parent table. NO ACTION and RESTRICT are the same as
     *           omitting the ON DELETE or ON UPDATE clause.
     *
     * SET DEFAULT
     *
     * @return string  DBMS specific SQL code portion needed to set the FOREIGN KEY constraint
     *                 of a field declaration.
     */
1899
    public function getForeignKeyDeclarationSQL(ForeignKeyConstraint $foreignKey)
1900
    {
1901 1902
        $sql  = $this->getForeignKeyBaseDeclarationSQL($foreignKey);
        $sql .= $this->getAdvancedForeignKeyOptionsSQL($foreignKey);
1903 1904 1905 1906 1907 1908 1909 1910

        return $sql;
    }

    /**
     * Return the FOREIGN KEY query section dealing with non-standard options
     * as MATCH, INITIALLY DEFERRED, ON UPDATE, ...
     *
1911
     * @param ForeignKeyConstraint $foreignKey     foreign key definition
1912 1913
     * @return string
     */
1914
    public function getAdvancedForeignKeyOptionsSQL(ForeignKeyConstraint $foreignKey)
1915 1916
    {
        $query = '';
1917
        if ($this->supportsForeignKeyOnUpdate() && $foreignKey->hasOption('onUpdate')) {
1918
            $query .= ' ON UPDATE ' . $this->getForeignKeyReferentialActionSQL($foreignKey->getOption('onUpdate'));
1919
        }
1920
        if ($foreignKey->hasOption('onDelete')) {
1921
            $query .= ' ON DELETE ' . $this->getForeignKeyReferentialActionSQL($foreignKey->getOption('onDelete'));
1922 1923 1924 1925 1926 1927 1928 1929
        }
        return $query;
    }

    /**
     * returns given referential action in uppercase if valid, otherwise throws
     * an exception
     *
1930
     * @throws \InvalidArgumentException if unknown referential action given
1931
     * @param string $action    foreign key referential action
1932
     * @return string
1933
     */
1934
    public function getForeignKeyReferentialActionSQL($action)
1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945
    {
        $upper = strtoupper($action);
        switch ($upper) {
            case 'CASCADE':
            case 'SET NULL':
            case 'NO ACTION':
            case 'RESTRICT':
            case 'SET DEFAULT':
                return $upper;
            break;
            default:
1946
                throw new \InvalidArgumentException('Invalid foreign key action: ' . $upper);
1947 1948 1949 1950 1951 1952 1953
        }
    }

    /**
     * Obtain DBMS specific SQL code portion needed to set the FOREIGN KEY constraint
     * of a field declaration to be used in statements like CREATE TABLE.
     *
1954
     * @param ForeignKeyConstraint $foreignKey
1955 1956
     * @return string
     */
1957
    public function getForeignKeyBaseDeclarationSQL(ForeignKeyConstraint $foreignKey)
1958 1959
    {
        $sql = '';
1960
        if (strlen($foreignKey->getName())) {
1961
            $sql .= 'CONSTRAINT ' . $foreignKey->getQuotedName($this) . ' ';
1962 1963 1964
        }
        $sql .= 'FOREIGN KEY (';

1965
        if (count($foreignKey->getLocalColumns()) == 0) {
1966
            throw new \InvalidArgumentException("Incomplete definition. 'local' required.");
1967
        }
1968
        if (count($foreignKey->getForeignColumns()) == 0) {
1969
            throw new \InvalidArgumentException("Incomplete definition. 'foreign' required.");
1970
        }
1971
        if (strlen($foreignKey->getForeignTableName()) == 0) {
1972
            throw new \InvalidArgumentException("Incomplete definition. 'foreignTable' required.");
1973 1974
        }

1975
        $sql .= implode(', ', $foreignKey->getLocalColumns())
1976
              . ') REFERENCES '
1977
              . $foreignKey->getForeignTableName() . ' ('
1978
              . implode(', ', $foreignKey->getForeignColumns()) . ')';
1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989

        return $sql;
    }

    /**
     * Obtain DBMS specific SQL code portion needed to set the UNIQUE constraint
     * of a field declaration to be used in statements like CREATE TABLE.
     *
     * @return string  DBMS specific SQL code portion needed to set the UNIQUE constraint
     *                 of a field declaration.
     */
1990
    public function getUniqueFieldDeclarationSQL()
1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002
    {
        return 'UNIQUE';
    }

    /**
     * Obtain DBMS specific SQL code portion needed to set the CHARACTER SET
     * of a field declaration to be used in statements like CREATE TABLE.
     *
     * @param string $charset   name of the charset
     * @return string  DBMS specific SQL code portion needed to set the CHARACTER SET
     *                 of a field declaration.
     */
2003
    public function getColumnCharsetDeclarationSQL($charset)
2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015
    {
        return '';
    }

    /**
     * Obtain DBMS specific SQL code portion needed to set the COLLATION
     * of a field declaration to be used in statements like CREATE TABLE.
     *
     * @param string $collation   name of the collation
     * @return string  DBMS specific SQL code portion needed to set the COLLATION
     *                 of a field declaration.
     */
2016
    public function getColumnCollationDeclarationSQL($collation)
2017 2018 2019
    {
        return '';
    }
2020

2021 2022 2023 2024 2025 2026 2027 2028 2029 2030
    /**
     * Whether the platform prefers sequences for ID generation.
     * Subclasses should override this method to return TRUE if they prefer sequences.
     *
     * @return boolean
     */
    public function prefersSequences()
    {
        return false;
    }
2031

2032 2033 2034 2035 2036 2037 2038 2039 2040 2041
    /**
     * Whether the platform prefers identity columns (eg. autoincrement) for ID generation.
     * Subclasses should override this method to return TRUE if they prefer identity columns.
     *
     * @return boolean
     */
    public function prefersIdentityColumns()
    {
        return false;
    }
2042

2043 2044
    /**
     * Some platforms need the boolean values to be converted.
2045
     *
romanb's avatar
romanb committed
2046
     * The default conversion in this implementation converts to integers (false => 0, true => 1).
2047
     *
romanb's avatar
romanb committed
2048
     * @param mixed $item
2049
     * @return mixed
2050 2051 2052 2053 2054 2055 2056 2057 2058
     */
    public function convertBooleans($item)
    {
        if (is_array($item)) {
            foreach ($item as $k => $value) {
                if (is_bool($value)) {
                    $item[$k] = (int) $value;
                }
            }
romanb's avatar
romanb committed
2059 2060
        } else if (is_bool($item)) {
            $item = (int) $item;
2061 2062 2063 2064 2065
        }
        return $item;
    }

    /**
2066
     * Gets the SQL statement specific for the platform to set the charset.
2067
     *
2068 2069 2070
     * This function is MySQL specific and required by
     * {@see \Doctrine\DBAL\Connection::setCharset($charset)}
     *
2071
     * @param string $charset
2072 2073
     * @return string
     */
2074
    public function getSetCharsetSQL($charset)
2075
    {
2076
        return "SET NAMES '".$charset."'";
2077
    }
2078

2079 2080 2081 2082 2083
    /**
     * Gets the SQL specific for the platform to get the current date.
     *
     * @return string
     */
2084
    public function getCurrentDateSQL()
2085 2086 2087 2088 2089 2090 2091 2092 2093
    {
        return 'CURRENT_DATE';
    }

    /**
     * Gets the SQL specific for the platform to get the current time.
     *
     * @return string
     */
2094
    public function getCurrentTimeSQL()
2095 2096 2097 2098
    {
        return 'CURRENT_TIME';
    }

2099 2100 2101 2102 2103
    /**
     * Gets the SQL specific for the platform to get the current timestamp
     *
     * @return string
     */
2104
    public function getCurrentTimestampSQL()
2105 2106 2107
    {
        return 'CURRENT_TIMESTAMP';
    }
2108

romanb's avatar
romanb committed
2109
    /**
2110
     * Get sql for transaction isolation level Connection constant
romanb's avatar
romanb committed
2111
     *
2112
     * @param integer $level
romanb's avatar
romanb committed
2113
     */
2114
    protected function _getTransactionIsolationLevelSQL($level)
romanb's avatar
romanb committed
2115 2116
    {
        switch ($level) {
2117
            case Connection::TRANSACTION_READ_UNCOMMITTED:
romanb's avatar
romanb committed
2118
                return 'READ UNCOMMITTED';
2119
            case Connection::TRANSACTION_READ_COMMITTED:
romanb's avatar
romanb committed
2120
                return 'READ COMMITTED';
2121
            case Connection::TRANSACTION_REPEATABLE_READ:
romanb's avatar
romanb committed
2122
                return 'REPEATABLE READ';
2123
            case Connection::TRANSACTION_SERIALIZABLE:
romanb's avatar
romanb committed
2124 2125
                return 'SERIALIZABLE';
            default:
2126
                throw new \InvalidArgumentException('Invalid isolation level:' . $level);
2127 2128 2129
        }
    }

2130
    public function getListDatabasesSQL()
2131
    {
2132
        throw DBALException::notSupported(__METHOD__);
2133 2134
    }

2135
    public function getListSequencesSQL($database)
2136
    {
2137
        throw DBALException::notSupported(__METHOD__);
2138 2139
    }

2140
    public function getListTableConstraintsSQL($table)
2141
    {
2142
        throw DBALException::notSupported(__METHOD__);
2143 2144
    }

2145
    public function getListTableColumnsSQL($table, $database = null)
2146
    {
2147
        throw DBALException::notSupported(__METHOD__);
2148 2149
    }

2150
    public function getListTablesSQL()
2151
    {
2152
        throw DBALException::notSupported(__METHOD__);
2153 2154
    }

2155
    public function getListUsersSQL()
2156
    {
2157
        throw DBALException::notSupported(__METHOD__);
2158 2159
    }

2160 2161 2162 2163 2164 2165
    /**
     * Get the SQL to list all views of a database or user.
     *
     * @param string $database
     * @return string
     */
2166
    public function getListViewsSQL($database)
2167
    {
2168
        throw DBALException::notSupported(__METHOD__);
2169 2170
    }

2171 2172
    /**
     * Get the list of indexes for the current database.
2173
     *
2174 2175
     * The current database parameter is optional but will always be passed
     * when using the SchemaManager API and is the database the given table is in.
2176
     *
2177 2178 2179
     * Attention: Some platforms only support currentDatabase when they
     * are connected with that database. Cross-database information schema
     * requests may be impossible.
2180
     *
2181
     * @param string $table
2182
     * @param string $currentDatabase
2183 2184
     */
    public function getListTableIndexesSQL($table, $currentDatabase = null)
2185
    {
2186
        throw DBALException::notSupported(__METHOD__);
2187 2188
    }

2189
    public function getListTableForeignKeysSQL($table)
2190
    {
2191
        throw DBALException::notSupported(__METHOD__);
2192 2193
    }

2194
    public function getCreateViewSQL($name, $sql)
2195
    {
2196
        throw DBALException::notSupported(__METHOD__);
2197 2198
    }

2199
    public function getDropViewSQL($name)
2200
    {
2201
        throw DBALException::notSupported(__METHOD__);
2202 2203
    }

2204
    public function getDropSequenceSQL($sequence)
2205
    {
2206
        throw DBALException::notSupported(__METHOD__);
2207 2208
    }

2209
    public function getSequenceNextValSQL($sequenceName)
2210
    {
2211
        throw DBALException::notSupported(__METHOD__);
romanb's avatar
romanb committed
2212
    }
2213

2214
    public function getCreateDatabaseSQL($database)
2215
    {
2216
        throw DBALException::notSupported(__METHOD__);
2217 2218
    }

romanb's avatar
romanb committed
2219
    /**
2220
     * Get sql to set the transaction isolation level
romanb's avatar
romanb committed
2221
     *
2222
     * @param integer $level
romanb's avatar
romanb committed
2223
     */
2224
    public function getSetTransactionIsolationSQL($level)
romanb's avatar
romanb committed
2225
    {
2226
        throw DBALException::notSupported(__METHOD__);
romanb's avatar
romanb committed
2227
    }
2228

2229
    /**
2230
     * Obtain DBMS specific SQL to be used to create datetime fields in
2231 2232
     * statements like CREATE TABLE
     *
2233
     * @param array $fieldDeclaration
2234 2235
     * @return string
     */
2236
    public function getDateTimeTypeDeclarationSQL(array $fieldDeclaration)
2237
    {
2238
        throw DBALException::notSupported(__METHOD__);
2239
    }
2240 2241 2242

    /**
     * Obtain DBMS specific SQL to be used to create datetime with timezone offset fields.
2243
     *
2244 2245 2246 2247
     * @param array $fieldDeclaration
     */
    public function getDateTimeTzTypeDeclarationSQL(array $fieldDeclaration)
    {
2248
        return $this->getDateTimeTypeDeclarationSQL($fieldDeclaration);
2249
    }
2250 2251


2252 2253 2254
    /**
     * Obtain DBMS specific SQL to be used to create date fields in statements
     * like CREATE TABLE.
2255
     *
2256 2257 2258
     * @param array $fieldDeclaration
     * @return string
     */
2259
    public function getDateTypeDeclarationSQL(array $fieldDeclaration)
2260
    {
2261
        throw DBALException::notSupported(__METHOD__);
2262
    }
2263

2264 2265 2266 2267 2268 2269 2270
    /**
     * Obtain DBMS specific SQL to be used to create time fields in statements
     * like CREATE TABLE.
     *
     * @param array $fieldDeclaration
     * @return string
     */
2271
    public function getTimeTypeDeclarationSQL(array $fieldDeclaration)
2272
    {
2273
        throw DBALException::notSupported(__METHOD__);
2274 2275
    }

2276 2277 2278 2279 2280
    public function getFloatDeclarationSQL(array $fieldDeclaration)
    {
        return 'DOUBLE PRECISION';
    }

romanb's avatar
romanb committed
2281 2282 2283 2284
    /**
     * Gets the default transaction isolation level of the platform.
     *
     * @return integer The default isolation level.
2285
     * @see Doctrine\DBAL\Connection\TRANSACTION_* constants.
romanb's avatar
romanb committed
2286 2287 2288
     */
    public function getDefaultTransactionIsolationLevel()
    {
2289
        return Connection::TRANSACTION_READ_COMMITTED;
romanb's avatar
romanb committed
2290
    }
2291

2292
    /* supports*() methods */
2293 2294 2295 2296 2297 2298

    /**
     * Whether the platform supports sequences.
     *
     * @return boolean
     */
2299 2300 2301 2302
    public function supportsSequences()
    {
        return false;
    }
2303 2304 2305 2306 2307 2308 2309 2310

    /**
     * Whether the platform supports identity columns.
     * Identity columns are columns that recieve an auto-generated value from the
     * database on insert of a row.
     *
     * @return boolean
     */
2311 2312 2313 2314
    public function supportsIdentityColumns()
    {
        return false;
    }
2315 2316 2317 2318 2319 2320

    /**
     * Whether the platform supports indexes.
     *
     * @return boolean
     */
2321 2322 2323 2324
    public function supportsIndexes()
    {
        return true;
    }
2325

2326 2327 2328 2329 2330
    public function supportsAlterTable()
    {
        return true;
    }

2331 2332 2333 2334 2335
    /**
     * Whether the platform supports transactions.
     *
     * @return boolean
     */
2336 2337 2338 2339
    public function supportsTransactions()
    {
        return true;
    }
2340 2341 2342 2343 2344 2345

    /**
     * Whether the platform supports savepoints.
     *
     * @return boolean
     */
2346 2347 2348 2349
    public function supportsSavepoints()
    {
        return true;
    }
2350

2351 2352 2353 2354 2355 2356 2357 2358 2359 2360
    /**
     * Whether the platform supports releasing savepoints.
     *
     * @return boolean
     */
    public function supportsReleaseSavepoints()
    {
        return $this->supportsSavepoints();
    }

2361 2362 2363 2364 2365
    /**
     * Whether the platform supports primary key constraints.
     *
     * @return boolean
     */
2366 2367 2368 2369
    public function supportsPrimaryConstraints()
    {
        return true;
    }
2370 2371

    /**
2372
     * Does the platform supports foreign key constraints?
2373 2374 2375
     *
     * @return boolean
     */
2376 2377 2378 2379
    public function supportsForeignKeyConstraints()
    {
        return true;
    }
2380 2381 2382

    /**
     * Does this platform supports onUpdate in foreign key constraints?
2383
     *
2384 2385 2386 2387 2388 2389
     * @return bool
     */
    public function supportsForeignKeyOnUpdate()
    {
        return ($this->supportsForeignKeyConstraints() && true);
    }
2390

2391 2392
    /**
     * Whether the platform supports database schemas.
2393
     *
2394 2395 2396 2397 2398 2399
     * @return boolean
     */
    public function supportsSchemas()
    {
        return false;
    }
2400

2401 2402 2403 2404 2405 2406 2407 2408 2409 2410 2411 2412 2413 2414
    /**
     * Can this platform emulate schemas?
     *
     * Platforms that either support or emulate schemas don't automatically
     * filter a schema for the namespaced elements in {@link
     * AbstractManager#createSchema}.
     *
     * @return bool
     */
    public function canEmulateSchemas()
    {
        return false;
    }

2415 2416 2417 2418 2419 2420 2421 2422 2423 2424
    /**
     * Some databases don't allow to create and drop databases at all or only with certain tools.
     *
     * @return bool
     */
    public function supportsCreateDropDatabase()
    {
        return true;
    }

2425
    /**
2426
     * Whether the platform supports getting the affected rows of a recent
2427 2428 2429 2430
     * update/delete type query.
     *
     * @return boolean
     */
2431 2432 2433 2434
    public function supportsGettingAffectedRows()
    {
        return true;
    }
2435

2436 2437 2438 2439 2440 2441 2442 2443 2444 2445 2446 2447
    /**
     * Does this plaform support to add inline column comments as postfix.
     *
     * @return bool
     */
    public function supportsInlineColumnComments()
    {
        return false;
    }

    /**
     * Does this platform support the propriortary synatx "COMMENT ON asset"
2448
     *
2449 2450 2451 2452 2453 2454 2455
     * @return bool
     */
    public function supportsCommentOnStatement()
    {
        return false;
    }

2456
    public function getIdentityColumnNullInsertSQL()
2457 2458 2459 2460
    {
        return "";
    }

2461 2462
    /**
     * Does this platform views ?
2463 2464
     *
     * @return boolean
2465 2466 2467 2468 2469 2470
     */
    public function supportsViews()
    {
        return true;
    }

2471
    /**
2472 2473
     * Gets the format string, as accepted by the date() function, that describes
     * the format of a stored datetime value of this platform.
2474
     *
2475
     * @return string The format string.
2476 2477 2478 2479 2480 2481
     */
    public function getDateTimeFormatString()
    {
        return 'Y-m-d H:i:s';
    }

2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492
    /**
     * Gets the format string, as accepted by the date() function, that describes
     * the format of a stored datetime with timezone value of this platform.
     *
     * @return string The format string.
     */
    public function getDateTimeTzFormatString()
    {
        return 'Y-m-d H:i:s';
    }

2493 2494 2495
    /**
     * Gets the format string, as accepted by the date() function, that describes
     * the format of a stored date value of this platform.
2496
     *
2497 2498
     * @return string The format string.
     */
2499 2500
    public function getDateFormatString()
    {
2501
        return 'Y-m-d';
2502
    }
2503

2504 2505 2506
    /**
     * Gets the format string, as accepted by the date() function, that describes
     * the format of a stored time value of this platform.
2507
     *
2508 2509
     * @return string The format string.
     */
2510 2511 2512 2513 2514
    public function getTimeFormatString()
    {
        return 'H:i:s';
    }

2515 2516
    /**
     * Modify limit query
2517
     *
2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530
     * @param string $query
     * @param int $limit
     * @param int $offset
     * @return string
     */
    final public function modifyLimitQuery($query, $limit, $offset = null)
    {
        if ( $limit !== null) {
            $limit = (int)$limit;
        }

        if ( $offset !== null) {
            $offset = (int)$offset;
2531 2532 2533 2534 2535 2536 2537

            if ($offset < 0) {
                throw new DBALException("LIMIT argument offset=$offset is not valid");
            }
            if ( $offset > 0 && ! $this->supportsLimitOffset()) {
                throw new DBALException(sprintf("Platform %s does not support offset values in limit queries.", $this->getName()));
            }
2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549
        }

        return $this->doModifyLimitQuery($query, $limit, $offset);
    }

    /**
     * @param string $query
     * @param int $limit
     * @param int $offset
     * @return string
     */
    protected function doModifyLimitQuery($query, $limit, $offset)
2550
    {
2551
        if ( $limit !== null) {
2552
            $query .= ' LIMIT ' . $limit;
2553 2554
        }

2555
        if ( $offset !== null) {
2556 2557 2558
            $query .= ' OFFSET ' . $offset;
        }

2559 2560
        return $query;
    }
2561

2562 2563 2564 2565 2566 2567 2568 2569 2570 2571
    /**
     * Does the database platform support offsets in modify limit clauses?
     *
     * @return bool
     */
    public function supportsLimitOffset()
    {
        return true;
    }

2572 2573
    /**
     * Gets the character casing of a column in an SQL result set of this platform.
2574
     *
2575 2576 2577
     * @param string $column The column name for which to get the correct character casing.
     * @return string The column name in the character casing used in SQL result sets.
     */
2578
    public function getSQLResultCasing($column)
2579 2580 2581
    {
        return $column;
    }
2582

2583 2584 2585
    /**
     * Makes any fixes to a name of a schema element (table, sequence, ...) that are required
     * by restrictions of the platform, like a maximum length.
2586
     *
2587
     * @param string $schemaElementName
2588 2589 2590 2591 2592 2593
     * @return string
     */
    public function fixSchemaElementName($schemaElementName)
    {
        return $schemaElementName;
    }
2594

2595 2596
    /**
     * Maximum length of any given databse identifier, like tables or column names.
2597
     *
2598 2599 2600 2601 2602 2603 2604
     * @return int
     */
    public function getMaxIdentifierLength()
    {
        return 63;
    }

2605 2606 2607
    /**
     * Get the insert sql for an empty insert statement
     *
2608 2609
     * @param string $tableName
     * @param string $identifierColumnName
2610 2611
     * @return string $sql
     */
2612
    public function getEmptyIdentityInsertSQL($tableName, $identifierColumnName)
2613 2614 2615
    {
        return 'INSERT INTO ' . $tableName . ' (' . $identifierColumnName . ') VALUES (null)';
    }
2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626

    /**
     * Generate a Truncate Table SQL statement for a given table.
     *
     * Cascade is not supported on many platforms but would optionally cascade the truncate by
     * following the foreign keys.
     *
     * @param  string $tableName
     * @param  bool $cascade
     * @return string
     */
2627
    public function getTruncateTableSQL($tableName, $cascade = false)
2628 2629 2630
    {
        return 'TRUNCATE '.$tableName;
    }
2631 2632 2633

    /**
     * This is for test reasons, many vendors have special requirements for dummy statements.
2634
     *
2635 2636 2637 2638 2639 2640
     * @return string
     */
    public function getDummySelectSQL()
    {
        return 'SELECT 1';
    }
2641 2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655 2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 2672 2673

    /**
     * Generate SQL to create a new savepoint
     *
     * @param string $savepoint
     * @return string
     */
    public function createSavePoint($savepoint)
    {
        return 'SAVEPOINT ' . $savepoint;
    }

    /**
     * Generate SQL to release a savepoint
     *
     * @param string $savepoint
     * @return string
     */
    public function releaseSavePoint($savepoint)
    {
        return 'RELEASE SAVEPOINT ' . $savepoint;
    }

    /**
     * Generate SQL to rollback a savepoint
     *
     * @param string $savepoint
     * @return string
     */
    public function rollbackSavePoint($savepoint)
    {
        return 'ROLLBACK TO SAVEPOINT ' . $savepoint;
    }
2674 2675 2676

    /**
     * Return the keyword list instance of this platform.
2677
     *
2678
     * Throws exception if no keyword list is specified.
2679
     *
2680 2681 2682 2683 2684 2685 2686
     * @throws DBALException
     * @return KeywordList
     */
    final public function getReservedKeywordsList()
    {
        $class = $this->getReservedKeywordsClass();
        $keywords = new $class;
2687
        if ( ! $keywords instanceof \Doctrine\DBAL\Platforms\Keywords\KeywordList) {
2688 2689 2690 2691
            throw DBALException::notSupported(__METHOD__);
        }
        return $keywords;
    }
2692

2693 2694
    /**
     * The class name of the reserved keywords list.
2695
     *
2696 2697 2698 2699 2700 2701
     * @return string
     */
    protected function getReservedKeywordsClass()
    {
        throw DBALException::notSupported(__METHOD__);
    }
2702
}