The mysqlnd replication and load balancing plugin (mysqlnd_ms) adds easy to use MySQL replication support to all PHP MySQL extensions that use mysqlnd.
As of version PHP 5.3.3 the MySQL native driver for PHP (mysqlnd) features an internal plugin C API. C plugins, such as the replication and load balancing plugin, can extend the functionality of mysqlnd.
The MySQL native driver for PHP is a C library that ships together with PHP as of PHP 5.3.0. It serves as a drop-in replacement for the MySQL Client Library (libmysql/libmysqlclient). Using mysqlnd has several advantages: no extra downloads are required because it's bundled with PHP, it's under the PHP license, there is lower memory consumption in certain cases, and it contains new functionality such as asynchronous queries.
Mysqlnd plugins like mysqlnd_ms operate, for the most part, transparently from a user perspective. The replication and load balancing plugin supports all PHP applications, and all MySQL PHP extensions. It does not change existing APIs. Therefore, it can easily be used with existing PHP applications.
Note:
The mysqlnd replication and load balancing plugin is a beta plugin, and is not feature complete.
The key features of PECL/mysqlnd_ms are as follows.
Transparent and therefore easy to use.
Supports all of the PHP MySQL extensions.
SSL support.
A consistent API.
Little to no application changes required, dependent on the required usage scenario.
Lazy connections: connections to master and slave servers are not opened before a SQL statement is executed.
Optional: automatic use of master after the first write in a web request, to lower the possible impact of replication lag.
Featured read-write split strategies
Automatic detection of SELECT.
Supports SQL hints to overrule automatism.
User-defined.
Can be disabled for, for example, when using synchronous clusters such as MySQL Cluster.
Featured load balancing strategies
Round Robin: choose a different slave in round-robin fashion for every slave request.
Random: choose a random slave for every slave request.
Random once (sticky): choose a random slave once to run all slave requests for the duration of a web request.
User-defined. The application can register callbacks with mysqlnd_ms.
PHP 5.4.0 or newer: transaction aware when using API calls only to control transactions.
Global transaction ID
Client-side emulation. Makes manual master server failover and slave promotion easier with asynchronous clusters, such as MySQL Replication.
Support for built-in global transaction identifier feature of MySQL 5.6.5-m8 or newer.
Supports using transaction ids to identify up-to-date asynchronous slaves for reading when session consistency is required.
Service and consistency levels
Applications can request eventual, session and strong consistency service levels for connections. Appropriate cluster nodes will be searched automatically.
Eventual consistent MySQL Replication slave accesses can be replaced with fast local cache accesses transparently to reduce server load.
The plugin does not support MySQL replication setups with more than one master server. The experimental configuration setting mysqlnd_ms.multi_master was introduced in version 1.1.0-beta, to help find ways to remove this limitation and to enable the use of synchronous clusters, such as MySQL Cluster.
The built-in read/write-split mechanism is very basic. Every query which starts with SELECT is considered a read request to be sent to a MySQL slave server. All other queries (such as SHOW statements) are considered as write requests that are sent to the MySQL master server. The build-in behavior can be overruled using SQL hints, or a user-defined callback function.
The read/write splitter is not aware of multi-statements. Multi-statements are considered as one statement. The decision of where to run the statement will be based on the beginning of the statement string. For example, if using mysqli_multi_query() to execute the multi-statement SELECT id FROM test ; INSERT INTO test(id) VALUES (1), the statement will be redirected to a slave server because it begins with SELECT. The INSERT statement, which is also part of the multi-statement, will not be redirected to a master server.
Prior to version 1.1.0-beta, the plugin did not support native prepared statements. Please note that PDO_MySQL uses client-side prepared statement emulation by default. Client-side emulated prepared statements are fully supported by any version of the replication and load balancing plugin because the emulation is not using native prepared statements. If you are using PHP based database abstraction, please consult the vendor manual to learn if a client-side prepared statement emulation is used.
Note:
Applications must be aware of the consequences of connection switches that are performed for load balancing purposes. Please check the documentation on connection pooling and switching, transaction handling, failover load balancing and read-write splitting.
The shortcut mysqlnd_ms stands for mysqlnd master slave plugin. The name was chosen for a quick-and-dirty proof-of-concept. In the beginning the developers did not expect to continue using the code base.