dbal

This release fixes some issues around LIMIT/OFFSET handling in DB2, OracleDB, SQL Server:

• Allowing LIMIT/OFFSET modification without LIMIT on OracleDB
• Allowing LIMIT/OFFSET modification with OFFSET = 0 on DB2
• Avoiding an accidental infinite loop in LIMIT/OFFSET modification on SQL Server

Total issues resolved: 4

• 2408: Hotfix 2313 infinite loop
• 2463: IBM_DB2 platform doesn't handle offset without limit
• 2509: Oracle platform ignores OFFSET in case if LIMIT is not specified
• 2602: Backport #2408

This release fixes some OracleDB and PostgreSQL specific issues.

• Introspecting table columns on OracleDB when using a non-default schema caused SQL error ORA-01427
• SQL parameter expansion was broken when using the ARRAY[] expression on PostgreSQL

Total issues resolved: 9

• 2496: Fix parameter list expansion inside PostgreSQL arrays
• 2515: PHP Warning when listing table columns in Oracle
• 2516: #2515 fix schema listing when having identical tables in databases
• 2517: ORA-01427 when listing table columns
• 2518: Fixed ORA-01427 when listing columns
• 2522: OraclePlatform - ORA-01427: single-row subquery returns more than one row
• 2549: Oracle column metadata import fix
• 2584: Doctrine:Schema:Validate leeds to ORA-01427(single-row subquery returns more than one row)
• 2585: OraclePlatform : Add an owner condition to the list table column comment subquery

Total issues resolved: 1

• 2569: Allow doctrine/common 2.7

Total issues resolved: 40

• 842: Fixed incorrect handling of single quotes in SQL-Strings
• 856: MySQL getListTableForeignKeysSQL: use current database if null passed
• 861: Check for foreign table name on removed tables foreign key
• 862: Quote table and constraint names in drop foreign key / drop constraint SQL
• 863: Strip leading slash of databasename from URL
• 925: Fixing the command when option is CURRENT_SCHEMA
• 1054: DBAL-1114: Problem with drop database on PostgreSQL
• 1106: DBAL-1164: Creating SQLite Connections via a URL Does Not Work
• 1151: DBAL-1205: getPlaceholderPositions finds placeholders which are actually no placeholder if string contains single quotes
• 1183: DBAL-1234: Additional slash in dbname when providing settings as URL without scheme
• 2182: DBAL-939: schema update doesnt detect boolean type correctly
• 2261: OCI8 - bindValue overwrite previous values
• 2262: Issue #2261 - OCI8 Driver PHP 7 - Fix bindValue overwriting other params.
• 2267: Pass "path" to pdo-sqlite drivers from DriverManager instead of "dbname"
• 2270: SqlitePlatform does not escape table name on truncate
• 2275: Quote reserved keywords in TRUNCATE TABLE SQL
• 2277: [DBAL-939] Fix reverse engineering boolean type columns on DB2
• 2279: Stop using template1 as default database for postgres drivers
• 2286: Fix list foreign keys SQL database parameter evaluation
• 2287: Fix parsing schemeless connection URLs
• 2288: Preserve quotation of old column name in ColumnDiff
• 2291: The QueryBuilder::getSQLForSelect() always appends a FROM clause for select queries
• 2292: Do not generate FROM clause in QueryBuilder if no tables specified
• 2302: when use \Doctrine\DBAL\Schema\Comparator to compare two table schema, has a problem
• 2303: Fix another primary key alteration with autoincrement column case on MySQL
• 2310: [DB2] Move row number to the end of the field list in query limit/offset modification
• 2318: [Oracle] Fix list table columns when using external or OS authentication with Oracle
• 2384: Fluent methods in QueryBuilder are now documented as returning $this
• 2386: Fix oci driver bindValue overwrite with php7
• 2390: Catch Throwable in Connection::transactional()
• 2403: fix grammar in DBALException messages
• 2428: Modify Limit Query on SQLServer2012 with newline before ORDER BY
• 2434: Keep references to bound parameter values in oci8 driver
• 2436: MySqlPlatform::getListTableColumnsSQL() is not escaping names
• 2440: No parameters passed to logger when executing statement using bindParam
• 2442: Escape identifiers in metadata SQL properly when used as string literal
• 2443: Track the Values & Types Passed to Statement::bindParam
• 2484: Allow usage of symfony/console ^3.0 in dev dependencies
• 2497: ResultStatement::fetch() returns null instead of false with mysqli
• 2500: Making sure that fetch returns false if nothing is found

Total issues resolved: 7

• 1069: DBAL-1128: [GH-782] Fix: SQLite offset with no limit support
• 1074: DBAL-1132: [GH-786] Fix removing autoincrement column from a primary key
• 1079: DBAL-1137: Infinite recursion on non-unique table/join alias in QueryBuilder
• 1124: DBAL-1181: [GH-822] Fix for bad profiling data, showing an indefinitely long query
• 1129: DBAL-1186: [GH-826] fix incorrect ordering of columns in clustered indexes on sql server
• 1141: DBAL-1197: [GH-835] backport bugfix to avoid fatal error in array_merge during generating the table creation SQL
• 1162: DBAL-1215: [GH-844] template1 as default database for PostgreSQL

Total issues resolved: 3

• 2249: Compatibility mis-match? PGSQL_ATTR_DISABLE_PREPARES in v2.5.2 (in a PHP 5.6.16 envt)
• 2272: [DBAL-1779] Fix string column type declarations with whitespace on SQLite
• 2273: Fix usage of PDO::PGSQL_ATTR_DISABLE_PREPARES for edge case pdo_pgsql setups

Total issues resolved: 2

• 818: Rebuild SQLServerPlatform::doModifyLimitQuery again to use a CTE
• 2268: #2260 - loosening doctrine/common requirement: allowing 2.6.x

Total issues resolved: 24

Total issues resolved: 9

Total issues resolved: 24

We are happy to announce the immediate availability of Doctrine DBAL 2.5.0 Stable. This release is a landmark in making DBAL more consistent and stable than it ever was.

Starting with 2.5 DBAL will have a new release-master, Steve Müller. Steve has been working on DBAL for the last two years and contributed many of the big features that make up this fantastic release. He will replace Benjamin Eberlei who was the release master since version 2.0.

You can install DBAL through Composer:

{
    "require": {
        "doctrine/dbal": "2.5.0"
    }
}

This version is mostly backwards compatible with only some minor breaks, when using PDO IBM, creating a custom platform or using non-default DateTime formats. You can see the breaks in the UPGRADE.md file. DBAL 2.5 is also compatible with ORM 2.4, there is no need to wait for ORM 2.5 to be released.

The following list contains the major new features of DBAL:

• Support for SAP Sybase SQL Anywhere versions 10, 11, 12 and 16 (DBAL-475)
• Support for auto-commit=NO on all drivers and platforms. (DBAL-81)
• Refactor exceptions to use common error-codes and exception classes that derive from Doctrine\DBAL\DBALException. (DBAL-407)
• Add support to retry connections with Doctrine\DBAL\Connection#ping() method. (DBAL-275)
• Add INSERT support to QueryBuilder (DBAL-320)
• Add Binary type for VARBINARY support (DBAL-714)
• Add charset and SSL connection support to PostgreSQL (DBAL-567, DBAL-702)
• Add options support for Myqli (DBAL-643)
• Add support for using database uris with the url parameter in DriverManager::getConnection() which supports several forms used by PaaS providers out of the box (DBAL-1050).
• Auto detection of platform to use based on database (DBAL-757)
• Improved SQL Server LIMIT emulation support. (Multiple tickets)
• Improvements to HHVM Support (no full support yet)

See all the changes for the 2.5.0 Release on Jira, an amazing total of 316 issues:

• DBAL 2.5.0

If you find any problems or backwards compatbililty breaks with this release please report them on JIRA or open up Pull Requests on Github.

Total issues resolved: 12

• DBAL-760 - Don't return warnings as errors in sqlsrv driver #490
• DBAL-766 - PostgreSQL: Fix statement for getTableWhereClause method #492
• DBAL-759 - Fix driver error while introspecting sequences in SQL Server 2012 #489
• DDC-2883 - DBAL-766 - PostgreSQL: Fix statement for getTableWhereClause method #492
• DBAL-787 - Fix modifying limit/offset for statements with subqueries on SQL Server #512
• DBAL-792 - Fix sqlite autoincrement detection #515
• #625 - Fix pg boolean conversion
• DBAL-950 - Backport #625 - pgsql boolean conversion
• DBAL-951 - Remove duplicate suggest section in composer.json #641
• DBAL-963 - Add close() method in MasterSlaveConnection.php #652
• DBAL-976 - Fix evaluation of NOLOCK table hint on SQL Server #663
• DBAL-1006 - DBAL-717 - DBAL-335 - Fix bug in MasterSlaveConnection with keepSlave option and switch back after transaction #690

[DBAL-340] - [GH-196] Fixed mini-typo
[DBAL-344] - [GH-200] params not passed from execute to logger
[DBAL-350] - [GH-205] Added exit code for dbal:reserved-words command
[DBAL-355] - [GH-208] Optimize autoload prefix in composer.json
[DBAL-356] - [GH-209] Added query micro-optimization
[DBAL-366] - [GH-218] [MySQL] Fixed bug with comments not adding quotes for tables
[DBAL-370] - [GH-220] Added support for alter table, foreign keys and autoincrement detection to Sqlite platform and schema
[DBAL-381] - [GH-227] MySql TEXT and BLOB type declarations
[DBAL-383] - [GH-228] fixed typo for enabling DEFERRED support
[DBAL-396] - [GH-236] DBAL-200 Missing docs for 1 parameter in Connection::update
[DBAL-417] - [GH-250] Lightweight export as of doctrine/doctrine2#543
[DBAL-431] - [GH-261] Fix OFFSET without LIMIT cause MySQL syntax error.
[DBAL-432] - [GH-262] Add Symfony Console dependency to composer.json
[DBAL-435] - [GH-264] Allow passing empty arrays as parameters
[DBAL-438] - [GH-266] Removed outdated methods in DatabasePlatformMock.
[DBAL-439] - [GH-267] Add SQLServerPlatform supports schemas
[DBAL-440] - [GH-268] Remove deprecated getShowDatabasesSQL() from Platforms
[DBAL-442] - Break the query building with multiple from parts
[DBAL-445] - [GH-271] added the possibility to use column names as keys for the types in Connection::insert()
[DBAL-447] - [GH-272] Refactor SQL Server keyword dictionaries and MsSQL leftovers
[DBAL-455] - [GH-278] OraclePlatform sequence naming for primary keys
[DBAL-459] - [GH-282] Add column collation support for SQL Server
[DBAL-460] - [GH-283] Fix SchemaManagerFunctionalTestCase composite foreign keys test
[DBAL-462] - [GH-284] Correcting code example
[DBAL-473] - [GH-292] Add length in the OCI8 bindParam
[DBAL-476] - [GH-294] Allow removing column comment on some platforms
[DBAL-478] - [GH-295] Fix ModifyLimitQueryTest
[DBAL-484] - [GH-298] Fix SQL Server default constraints
[DBAL-485] - [GH-299] Fix list SQL Server composite foreign keys
[DBAL-486] - [GH-300] Improve list SQL Server table indexes
[DBAL-494] - [GH-304] Fix for DBAL-442
[DBAL-497] - SQLServerPlatform modifies limit query incorrectly when column names start with "from"
[DBAL-498] - [GH-306] [DBAL-497] Fixed SQL Server platform replacing 'FROM' in column names during limit
[DBAL-499] - [GH-307] Postgres fix for a possible unavailable dbname
[DBAL-500] - [GH-308] added index flags to schema table
[DBAL-506] - [GH-312] [DBAL-264] Support for UIDs in PostgreSQL
[DBAL-508] - MySqlSchemaManager accessing undefined index tableColumn[comment]
[DBAL-511] - Schema\ColumnDiff incorrect with default varchar value and postgresql
[DBAL-520] - [GH-319] Delete unnecessary "use PDO" statement
[DBAL-522] - BC break : executeQuery with an array containing null value(s).
[DBAL-530] - sqlite: foreignKey - definition wrong when tables has databasename as prefix
[DBAL-533] - [GH-327] #DDC-2313: QueryBuilder Deep Cloning
[DBAL-539] - [GH-332] [DDC-2470] Use column name instead of alias to modify order by clause
[DBAL-549] - [GH-339] Removed an unused method in AbstractPlatform.
[DBAL-568] - [GH-348] Portability wrapper _defaultFetchMode
[DBAL-583] - [GH-360] Don't add 'NOT NULL' to the 'ALTER TABLE' when that hasn't changed
Improvement
[DBAL-331] - [GH-192] ExpressionBuilder in and notIn methods
[DBAL-403] - [GH-240] Fix for DBAL-209