Skip to content

Commit fd412eb

Browse files
committed
minor #19187 Document requirements for DoctrineDbalAdapter (derrabus)
This PR was merged into the 7.0 branch. Discussion ---------- Document requirements for DoctrineDbalAdapter Follows symfony/symfony#52720. I've added a block that documents the compatibility with various database engines. * MySQL 5.7 is the oldest release supported by DBAL 3. * MariaDB 10.2 is the oldest release supported by DBAL 3. * The `MERGE` statement that the adapter uses requires Oracle 10g or newer. * SQL Server 2012 is the oldest release supported by DBAL 3. * The `INSERT OR REPLACE` statement that we use on SQLite requires PHP to be linked against libsqlite 3.24 or newer. * The `ON CONFLICT` clause that we use on Postgres was introduced with version 9.5. Commits ------- 4127633 Document requirements for DoctrineDbalAdapter
2 parents b7795d5 + 4127633 commit fd412eb

File tree

1 file changed

+18
-1
lines changed

1 file changed

+18
-1
lines changed

components/cache/adapters/doctrine_dbal_adapter.rst

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,5 +39,22 @@ optional arguments::
3939
necessary to detect the database engine and version without opening the
4040
connection.
4141

42+
The adapter uses SQL syntax that is optimized for database server that it is connected to.
43+
The following database servers are known to be compatible:
44+
45+
* MySQL 5.7 and newer
46+
* MariaDB 10.2 and newer
47+
* Oracle 10g and newer
48+
* SQL Server 2012 and newer
49+
* SQLite 3.24 or later
50+
* PostgreSQL 9.5 or later
51+
52+
.. note::
53+
54+
Newer releases of Doctrine DBAL might increase these minimal versions. Please check
55+
the manual page on `Doctrine DBAL Platforms`_ if your database server is compatible
56+
with the installed Doctrine DBAL version.
57+
4258
.. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
43-
.. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
59+
.. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/configuration.html#connecting-using-a-url
60+
.. _`Doctrine DBAL Platforms`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/platforms.html

0 commit comments

Comments
 (0)