[MichaIng]

• The legacy mysql module has been removed with PHP 7.0.
• pdo_mysql is used, which extension=pdo_mysql.so even reflected, but the used config keys were for the mysql module, hence ineffective.
• pdo_mysql has only two keys, from which only pdo_mysql.default_socket is relevant: https://www.php.net/manual/en/ref.pdo-mysql.php#pdo-mysql.configuration
• The builtin pdo_mysql.default_socket is usually correct, and should only be adjusted if it does not work OOTB. That way, changed distro defaults won't beak the setup. E.g. Debian Forky will switch from /run/mysqld/mysqld.sock to /run/mariadbd/mysqld.sock, hence setting this explicilty will cause a distro upgrade to break things.
• ini sections in PHP config files generally serve visual structuring only, but are otherwise ignored. The more common ; for comments in PHP configs is used, otherwise the example is kept minimal, focusing on the added pdo_mysql.default_socket.
• The config file path has been made more generic. Debian has its own config structure, with phpenmod/phpdismod, which not all distros share. But a per-module config file somewhere below /etc/php is common. This has been aligned for the PostgreSQL module, too.
• The backwards-compatibility note has been moved below the config example, so that the pdo_mysql.default_socket sentence and related config example stay together.
• Could be split off into an own PR, but since I found the ini syntax highlighting to be wrong, since generic code blocks were used, I replaced them with explicit .. code-block:: <lang> blocks.

☑️ Resolves

• Somewhat related to [Bug]: Nextcloud 31 not working over database socket server#53173 and Socket syntax unclear for dbhost variable #11740.

🖼️ Screenshots

Before

After

✅ Checklist

• I have built the documentation locally and reviewed the output
• Screenshots are included for visual changes
• I have not moved or renamed pages (or added a redirect if I did)
• I have run codespell or similar and addressed any spelling issues

[github-actions]

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

• admin_manual/configuration_database/linux_database_configuration.rst

Last updated: Tue, 10 Nov 2026 15:23:14 GMT

[MichaIng]

I tried to replace the single line code and command blocks with .. code-block:: and .. code::, too. But this somehow does not work, even when using the exact same syntax and language tag (or none) that works on other pages. Not sure what is missing, but single-line PHP code and shell commands have hence been left alone.

[MichaIng]

Some more screenshots showing added syntax highlighting: