Slight update to wording

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@329787 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Philip Olson 2013-03-14 19:21:08 +00:00
parent 0761e9d5e4
commit 581263ee45
2 changed files with 24 additions and 23 deletions

View file

@ -135,44 +135,45 @@
</listitem>
<listitem>
<para>
Improved transaction boundaries detection with PHP 5.5.0 or newer and
As of PHP 5.5.0, improved support for transaction boundaries detection was added for
<literal>mysqli</literal>. The <literal>mysqli</literal> extension has been
modified to use new C API calls of the <literal>mysqlnd</literal>
library to begin, commit and rollback a transaction or savepoint.
If <link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness"><literal>trx_stickiness</literal></link>
is used to enable transaction aware load balancing, not only the
<function>mysqli_autocommit</function> call will be monitored by the plugin
but also <function>mysqli_begin</function>, <function>mysqli_commit</function>
and <function>mysqli_rollback</function>. All SQL features to control
modified to use the new C API calls of the <literal>mysqlnd</literal>
library to begin, commit, and rollback a transaction or savepoint.
If <link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness">trx_stickiness</link>
is used to enable transaction aware load balancing, the <function>mysqli_begin</function>,
<function>mysqli_commit</function> and <function>mysqli_rollback</function> functions
will now be monitered by the plugin, to go along with the <function>mysqli_autocommit</function>
function that was already supported. All SQL features to control
transactions are also available through the improved <literal>mysqli</literal>
transaction control related functions. Thus, there is no need to
transaction control related functions. This means that it is not required to
issue SQL statements instead of using API calls. Applications
using the appropriate API calls only, can be load balanced by PECL/mysqlnd_ms
in a completely transaction aware way.
using the appropriate API calls can be load balanced by PECL/mysqlnd_ms
in a completely transaction-aware way.
</para>
<para>
Please note, <literal>PDO_MySQL</literal> has not been updated
yet to utilize the new mysqlnd API calls. Thus, transaction boundary
detection with <literal>PDO_MySQL</literal> continues to be limited to
the monitoring of <function>PDO::setAttribute(PDO::ATTR_AUTOCOMMIT, ...)</function>.
the monitoring by passing in <constant>PDO::ATTR_AUTOCOMMIT</constant> to
<methodname>PDO::setAttribute</methodname>.
</para>
</listitem>
<listitem>
<listitem>
<para>
Introduced <literal>trx_stickiness=on</literal>. This
<link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness"><literal>trx_stickiness</literal></link>
<link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness">trx_stickiness</link>
option differs from <literal>trx_stickiness=master</literal> as it
tries to execute a read only transaction on a slave, if
tries to execute a read-only transaction on a slave, if
quality of service (consistency level) allows the use of a slave.
Read only transactions have been introduced in MySQL 5.6. They
Read-only transactions were introduced in MySQL 5.6, and they
offer performance gains.
</para>
</listitem>
<listitem>
<para>
Query cache support considered beta if used with <literal>mysqli</literal>
Query cache support is considered beta if used with the <literal>mysqli</literal>
API. It should work fine with primary copy based clusters. For all other
APIs, the feature continues to be called experimental.
APIs, this feature continues to be called experimental.
</para>
</listitem>
<listitem>

View file

@ -2300,11 +2300,11 @@ $mysqli->set_charset("latin1");
by SQL statements such as <literal>SET AUTOCOMMIT=0</literal> or <literal>BEGIN</literal>.
</para>
<para>
Since PHP 5.5.0 the mysqlnd library features additional C API calls to
control transactions. The level of control matches the one offer by SQL
statement. The <literal>mysqli</literal> API has been modified to use
those calls. Since version 1.5.0, PECL/mysqlnd_ms can monitor not only
<function>mysqli_autocommit</function> but also <function>mysqli_begin</function>,
As of PHP 5.5.0, the mysqlnd library features additional C API calls to
control transactions. The level of control matches the one offered by SQL
statements. The <literal>mysqli</literal> API has been modified to use
these calls. Since version 1.5.0, PECL/mysqlnd_ms can monitor not only
<function>mysqli_autocommit</function>, but also <function>mysqli_begin</function>,
<function>mysqli_commit</function> and <function>mysqli_rollback</function> to
detect transaction boundaries and stop load balancing for the duration of
a transaction.