minor #9547 Add a note about correct cfg value server_version for MariaDB (tristanbes)

javiereguiluz · javiereguiluz · commit cdf14607e176 · 2018-04-16T09:35:54.000+02:00
This PR was squashed before being merged into the 2.7 branch (closes #9547). Discussion ---------- Add a note about correct cfg value server_version for MariaDB Because when using a MariaDB database, you should prefix the `server_version` with `mariadb-`otherwise doctrine/dbal is not able to recognize it and use `MySQL57Platform` which results in: - possible bugs - endless schema diff generation Because this feature/bug is not documented, it is time to do it properly 📦 👍 * Discussion on doctrine/dbal#2985 (comment) * Also, why it should be prefixed when using `MariaDB`: https://github.com/doctrine/dbal/blob/f76bf5ef631cec551a86c2291fc749534febebf1/lib/Doctrine/DBAL/Driver/AbstractMySQLDriver.php#L135 Commits ------- e6a9c1d Add a note about correct cfg value server_version for MariaDB
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
@@ -363,7 +363,10 @@ The following block shows all possible configuration keys:
     to find your PostgreSQL version and ``mysql -V`` to get your MySQL
     version).
     
-    Always wrap the server version number with quotes to parse it as a string
+    If you are running a MariaDB database, you should prefix the ``server_version`` 
+    with ``mariadb-`` (e.g. ``server_version: mariadb-10.2.12``).
+    
+    Always wrap the server version number with quotes to parse it as a string
     instead of a float number. Otherwise, the floating-point representation
     issues can make your version be considered a different number (e.g. ``5.6``
     will be rounded as ``5.5999999999999996447286321199499070644378662109375``).
