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

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

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