svn: /phpdoc/en/trunk/reference/mysqlnd_ms/ changes.xml setup.xml
| From: | Philip Olson | Date: | Thu, 14 Mar 2013 19:21:08 +0000 |
| Subject: | svn: /phpdoc/en/trunk/reference/mysqlnd_ms/ changes.xml setup.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-11105@lists.php.net to get a copy of this message | ||
philip Thu, 14 Mar 2013 19:21:08 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=329787
Log:
Slight update to wording
Changed paths:
U phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml
U phpdoc/en/trunk/reference/mysqlnd_ms/setup.xml
Modified: phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml 2013-03-14 15:31:49 UTC (rev 329786)
+++ phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml 2013-03-14 19:21:08 UTC (rev 329787)
@@ -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>
Modified: phpdoc/en/trunk/reference/mysqlnd_ms/setup.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlnd_ms/setup.xml 2013-03-14 15:31:49 UTC (rev 329786)
+++ phpdoc/en/trunk/reference/mysqlnd_ms/setup.xml 2013-03-14 19:21:08 UTC (rev 329787)
@@ -2300,11 +2300,11 @@
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.