nx6/mariadb11-compatibility

Magento 2 module that teaches the core database version check to recognise MariaDB 11.x (and MariaDB 10.2-10.11, MySQL 8, MySQL 5.7) as supported, silencing the false "unsupported database" warning.

v0.1.0 2026-08-30 18:44 UTC

Requires

• php: ^8.3
• magento/framework: >=103.0

MIT

• Martin

• database
• mysql
• magento
• compatibility
• mariadb
• magento2
• magento-module
• mariadb-11

Published on Packagist.org on 2026-08-30 19:11 UTC

README

Magento 2 module that widens the list of database version patterns the core recognises as supported, via Magento\Framework\DB\Adapter\SqlVersionProvider.

Out of the box Magento's version check does not recognise MariaDB 11.x, so a perfectly healthy MariaDB 11 server trips the "This Magento installation is running on an unsupported database" warning in the admin and in bin/magento setup:db:status. This module patches the accepted patterns (through di.xml only — no core files touched, no plugin, no DB writes) to add:

• MySQL 8.x
• MySQL 5.7.x
• MariaDB 10.2 – 10.11
• MariaDB 11.x

Package	nx6/mariadb11-compatibility
Module	Nx6_DbCompatibility
Version	0.1.0

Installation

composer require nx6/mariadb11-compatibility
bin/magento module:enable Nx6_DbCompatibility
bin/magento setup:upgrade
bin/magento setup:di:compile        # production mode only
bin/magento cache:flush

How it works

The module declares a single di.xml argument override that appends the extra version regexes to SqlVersionProvider::$supportedVersionPatterns:

<type name="Magento\Framework\DB\Adapter\SqlVersionProvider">
    <arguments>
        <argument name="supportedVersionPatterns" xsi:type="array">
            <item name="MySQL-8" xsi:type="string">^8\.0\.</item>
            <item name="MySQL-5.7" xsi:type="string">^5\.7\.</item>
            <item name="MariaDB-(10.2-10.11)" xsi:type="string">^10\.([2-9]|10|11)\.</item>
            <item name="MariaDB-11" xsi:type="string">^11\.</item>
        </argument>
    </arguments>
</type>

SqlVersionProvider only checks whether the running server's version string matches one of the patterns; nothing else in Magento changes behaviour based on it, so this is purely cosmetic — it does not alter query building, migrations, or schema handling.

Compatibility

Magento 2.4.x, PHP 8.3+. Effective for any MariaDB 10.2–11.x or MySQL 5.7/8.0 server that Magento would otherwise flag.

Structure

.
├── etc/
│   ├── di.xml        # Registers the supported DB version patterns
│   └── module.xml
├── registration.php
├── composer.json
├── LICENSE
└── README.md

License

MIT — see LICENSE.