Skip to content

fix(admin): replace removed PHP ext/mysql INI example #15719

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
whoalin1 wants to merge 1 commit into
base: master
Choose a base branch
from
Open

fix(admin): replace removed PHP ext/mysql INI example #15719

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 20 additions & 19 deletions admin_manual/configuration_database/linux_database_configuration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,32 +98,33 @@ Your :file:`/etc/mysql/my.cnf` could look like this:

Please refer to the `page in the MySQL manual <https://mariadb.com/kb/en/library/set-transaction/#read-committed>`_.

* That you have installed and enabled the pdo_mysql extension in PHP
* That you have installed and enabled the **pdo_mysql** (and **mysqlnd**) extensions in PHP

* That the **mysql.default_socket** points to the correct socket (if the database runs on the same server as Nextcloud).
* That **pdo_mysql.default_socket** points to the correct socket when the database runs on the same server as Nextcloud (optional; omit to use the PHP build default).

.. note:: MariaDB is backwards compatible with MySQL. All instructions work for both. You will not need to replace mysql with anything.

The PHP configuration in :file:`/etc/php7/conf.d/mysql.ini` could look like this:
The PHP MySQL extensions Nextcloud uses are **mysqlnd** (network driver) and
**pdo_mysql**. The old ``ext/mysql`` / ``[mysql]`` INI section was removed in
PHP 7.0 and must not appear in modern configs.

Example drop-ins (paths vary by distro; often under
:file:`/etc/php/*/mods-available/` or :file:`/etc/php/*/conf.d/`):

::

# configuration for PHP MySQL module
extension=pdo_mysql.so

[mysql]
mysql.allow_local_infile=On
mysql.allow_persistent=On
mysql.cache_size=2000
mysql.max_persistent=-1
mysql.max_links=-1
mysql.default_port=
mysql.default_socket=/var/lib/mysql/mysql.sock # Debian squeeze: /var/run/mysqld/mysqld.sock
mysql.default_host=
mysql.default_user=
mysql.default_password=
mysql.connect_timeout=60
mysql.trace_mode=Off
; mysqlnd (priority typically 10)
; https://www.php.net/manual/en/mysqlnd.config.php
extension=mysqlnd

; pdo_mysql (priority typically 20)
; https://www.php.net/manual/en/ref.pdo-mysql.php
extension=pdo_mysql
; optional: default Unix socket when connecting to localhost
; pdo_mysql.default_socket=/run/mysqld/mysqld.sock

Tune ``mysqlnd.*`` / ``pdo_mysql.*`` only if needed; see the PHP manual pages
above. Confirm the modules are loaded with ``php -m | grep -E 'mysqlnd|pdo_mysql'``.

Now you need to create a database user and the database itself by using the
MySQL command line interface. The database tables will be created by Nextcloud
Expand Down
Loading