Upgrade note for 1.1.0, mysqlnd_ms_set_user_pick_server() will be gone

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@317158 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Ulf Wendel 2011-09-22 16:45:12 +00:00
parent f6b2438916
commit f491b6b95e

View file

@ -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">