Oracle 5.0 Reference Manual page 2604

Mysqlnd replication and load balancing plugin (mysqlnd_ms)
Library Notes
call
Called by the following user API calls: mysql_select_db,
select_db
mysql_list_tables, mysql_db_query, mysql_list_fields,
mysqli_select_db. Note, that SQL
Called by the following user API calls: mysql_set_charset.
set_charset()
mysqli_set_charset. Note, that SQL
Called by the following user API calls: mysqli_multi_query,
set_server_option()
mysqli_real_query, mysqli_query, mysql_query.
Called by the following user API calls: mysqli_options,
set_client_option()
mysqli_ssl_set, mysqli_connect, mysql_connect,
mysql_pconnect.
Called by the following user API calls: mysqli_autocommit,
set_autocommit()
PDO::setAttribute(PDO::ATTR_AUTOCOMMIT).
Called by the following user API calls: mysqli_ssl_set.
ssl_set()
Broadcasting and lazy connections
The plugin does not proxy or "remember" all settings to apply them on connections opened in the
future. This is important to remember, if using
which are not opened before the client sends the first connection. Use of lazy connections is the default
plugin action.
The following connection library calls each changed state, and their execution is recorded for later use
when lazy connections are opened. This helps ensure that the connection state of all connections in
the connection pool are comparable.
Library Notes
call
User, password and database recorded for future use.
change_user()
Database recorded for future use.
select_db
Calls
set_charset() set_client_option(MYSQL_SET_CHARSET_NAME,
on lazy connection to ensure
charset)
opening the lazy connection.
Adds
set_autocommit() SET AUTOCOMMIT=0|1
connection using
"SET AUTOCOMMIT=...%quot;).
Connection state
The connection state is not only changed by API calls. Thus, even if PECL
mysqlnd_ms monitors all API calls, the application must still be aware.
Ultimately, it is the applications responsibility to maintain the connection state, if
needed.
Charsets and string escaping
Due to the use of lazy connections, which are a default, it can happen that an application tries to
escape a string for use within SQL statements before a connection has been established. In this case
string escaping is not possible. The string escape function does not know what charset to use before a
connection has been established.
To overcome the problem a new configuration setting
version 1.4.0.
USE
lazy connections. Lazy connections are connections
to the list of init commands of a lazy
set_client_option(MYSQL_INIT_COMMAND,
2584
is not monitored.
is not monitored.
SET NAMES
will be used upon
charset
has been introduced in
server_charset
Version
Since 1.0.0.
Since 1.0.0.
Since 1.0.0.
Since 1.0.0.
Since 1.0.0. PHP
>= 5.4.0.
Since 1.1.0.
Version
Since 1.1.0.
Since 1.1.0.
Since 1.1.0.
Since 1.1.0. PHP
>= 5.4.0.