mariadb/mysqlnd_ed25519

MariaDB ed25519 authentication plugin for mysqlnd

1.0.1 2025-11-02 18:14 UTC

Requires

• php: >=8.1

BSD-3-Clause

• Georg Richter

Extension name: ext-mysqlnd_ed25519

Supports Zend Thread Safety (ZTS): ✅

Supports non-Thread Safe mode (NTS): ✅

Supported operating systems: no restrictions

Configure flags:

• --with-mysqlnd-ed25519 Enable MariaDB ed25519 authentication support for mysqlnd

README

A mysqlnd authentication plugin providing Ed25519-based authentication for PHP when connecting to MariaDB servers.

Why?

PHP currently connects to MariaDB servers using mysql_native_password, which relies on SHA1, a deprecated and insecure algorithm.

Ed25519 provides modern, secure, and fast public-key authentication, helping to eliminate SHA1 usage in your PHP–MariaDB connections.

Features

• Ed25519 authentication using libsodium.
• Drop-in authentication plugin for mysqlnd.
• Supports MariaDB servers configured with the ed25519 authentication plugin.

Requirements

• PHP 8.1 or newer with mysqlnd.
• libsodium development libraries.
• MariaDB server configured with ed25519 authentication plugin. (version 10.4.3 or newer)

Installation

Normal installation

mysqlnd_ed25519 is usually built and installed automatically when installed through PHP's pie installer.

On Posix systems the pie installer also adds a configuration entry for the mysqlnd_ed25519 plugin. On Windows you need to enable the plugin in your php.init file:

extension=mysqlnd_ed25519

Building from source

If you cloned the repository or want to build manually:

phpize
./configure
make
sudo make install