svn: /phpdoc/en/trunk/reference/mysqlnd_ms/ changes.xml
| From: | Ulf Wendel | Date: | Thu, 22 Sep 2011 16:45:12 +0000 |
| Subject: | svn: /phpdoc/en/trunk/reference/mysqlnd_ms/ changes.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-8847@lists.php.net to get a copy of this message | ||
uw Thu, 22 Sep 2011 16:45:12 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=317158
Log:
Upgrade note for 1.1.0, mysqlnd_ms_set_user_pick_server() will be gone
Changed paths:
U phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml
Modified: phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml 2011-09-22 16:21:02 UTC (rev 317157)
+++ phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml 2011-09-22 16:45:12 UTC (rev 317158)
@@ -44,9 +44,19 @@
Freature changes
<itemizedlist>
<listitem>
- <simpara>
+ <para>
Introduction of (chainable) filter concept
- </simpara>
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ BC break: <function>mysqlnd_ms_set_user_pick_server</function>
+ has been removed.
+ The <literal>user</literal> filter has been introduced to replace it.
+ The filter offers almost the same functionality, see below for details.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
</listitem>
<listitem>
<simpara>
@@ -80,6 +90,21 @@
</listitem>
</itemizedlist>
</para>
+ <para>
+ Users of the function <function>mysqlnd_ms_set_user_pick_server</function> need to
+ update their code. The function has been removed in favour of a
+ new <literal>user</literal> filter. You can no longer set a callback function
+ using <function>mysqlnd_ms_set_user_pick_server</function> at runtime but have to
+ configure it in the plugins configuration file. The <literal>user</literal>
+ filter will pass the same arguments to the callback as before.
+ Therefore, you can continue to use the same procedural function as a callback.callback
+ It is no longer possibe to use static class methods or class methods of
+ an object instance as a callback. Trying to do so, will make any function
+ executing a statement handled by the plugin
+ emit a <constant>E_RECOVERABLE_ERROR</constant> level error like
+ <literal>(mysqlnd_ms) Specified callback (picker) is not a valid
callback</literal>.
+ Please, note that this may halt your application.
+ </para>
</section>
<section xml:id="mysqlnd-ms.changes_one_o">