README

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

Why?

PARSEC is MariaDB’s modern, secure authentication plugin based on elliptic-curve signatures and PBKDF2 key derivation. When your PHP connector supports it, it replaces older SHA-1–based password methods with stronger, public-key–style authentication.

Features

• Drop-in authentication plugin for mysqlnd.
• Supports MariaDB servers configured with the parsec authentication plugin.

Requirements

• PHP 8.1 or newer with mysqlnd.
• libsodium development libraries.
• openssl development libraries.
• MariaDB server configured with parsec authentication plugin. (version 11.8 or newer)

Installation

Normal installation

mysqlnd_parsec 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_parsec plugin. On Windows you need to enable the plugin in your php.init file:

extension=mysqlnd_parsec

Building from source

If you cloned the repository or want to build manually:

phpize
./configure
make
sudo make install