svn: /phpdoc/en/trunk/reference/mysqlnd_ms/ changes.xml setup.xml

From: 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.

« previous php.doc.cvs (#11105) next »