From 1572155523cd98c31eb00b46d525b8bc590d6f06 Mon Sep 17 00:00:00 2001
From: Hannes Magnusson <bjori@php.net>
Date: Wed, 24 Jun 2009 21:20:25 +0000
Subject: [PATCH] Sync with php-src

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@282734 c90b9560-bf6c-de11-be94-00142212c4b1
---
 appendices/migration53.xml | 204 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 200 insertions(+), 4 deletions(-)

diff --git a/appendices/migration53.xml b/appendices/migration53.xml
index 8387507f75..16b5865776 100644
--- a/appendices/migration53.xml
+++ b/appendices/migration53.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.16 $ -->
+<!-- $Revision: 1.17 $ -->
 <appendix xml:id="migration53" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Migrating from PHP 5.2.x to PHP 5.3.x</title>
  <para>
@@ -64,6 +64,12 @@
      cache by default.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     <function>realpath</function> is no longer system dependent and works the
+     same on all platforms.
+    </simpara>
+   </listitem>
    <listitem>
     <simpara>
      <function>call_user_func</function> and family now propagates <literal>$this</literal> 
@@ -117,6 +123,12 @@
      should always be public and can no longer be static. Method signatures are enforced.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     The <link linkend="language.oop5.overloading.methods">__call</link>
+     magic method now gets invoked on private/protected method access.
+    </simpara>
+   </listitem>
   </itemizedlist>
   <para>
    The following keywords are now reserved and may not be used 
@@ -205,6 +217,12 @@
      now have a shorthand operator <literal>?:</literal>.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     The HTTP stream wrapper now considers all status codes from 200 to 399 to
+     be successful.
+    </simpara>
+   </listitem>
   </itemizedlist>
  </section>
 
@@ -360,6 +378,9 @@
 
  <section xml:id="migration53.sapi">
   <title>Changes in SAPI modules</title>
+  <para>
+   A new SAPI is now available called litespeed.
+  </para>
   <para>
    FastCGI is now always enabled and can not be disabled. See <literal>sapi/cgi/CHANGES</literal>
    for more details.
@@ -469,6 +490,21 @@
      <function>magic_quotes_runtime</function>
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     <function>session_register</function>
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <function>session_unregister</function>
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <function>session_is_registered</function>
+    </simpara>
+   </listitem>
    <listitem>
     <simpara>
      <function>set_socket_blocking</function>
@@ -562,13 +598,33 @@
      <function>strstr</function> and <function>stristr</function> 
      - Added <parameter>before_needle</parameter>.
     </simpara>
+   </listitem>
+   <listitem>
     <simpara>
-     And <function>fopen</function> got a new mode option
+      - <function>fopen</function> got a new mode option
      (<literal>n</literal>), which passes will pass
      <constant>O_NONBLOCK</constant> to the underlaying
      <literal>syscall()</literal> call.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     The <function>dl</function> function is now disabled by default,
+     and only available under the cli, cgi and the embed SAPIs.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     Changed <function>opendir</function>, <function>dir</function> and
+     <function>scandir</function> to use default context when no context
+     argument is passed.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <function>mail</function> now supports logging of mail sent.
+    </simpara>
+   </listitem>
   </itemizedlist>
 
   <para><link linkend="book.json">json</link>:</para>
@@ -578,6 +634,8 @@
      <function>json_encode</function>
      - Added <parameter>options</parameter>.
     </simpara>
+   </listitem>
+   <listitem>
     <simpara>
      <function>json_decode</function>
      - Added <parameter>depth</parameter>.
@@ -585,6 +643,29 @@
    </listitem>
   </itemizedlist>
 
+  <para><link linkend="book.stream">Stream</link>:</para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <function>stream_select</function>,
+     <function>stream_set_blocking</function>,
+     <function>stream_set_timeout</function> and
+     <function>stream_set_write_buffer</function> now work with user-space
+     stream wrappers.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+
+  <para><link linkend="book.sybase">sybase_ct</link>:</para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <function>sybase_connect</function>
+     - Added <parameter>new</parameter>.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+
   <para>
    New parameters to methods in PHP 5.3.0.
   </para>
@@ -675,7 +756,7 @@
    <listitem>
     <simpara>
      <function>gethostname</function>
-     - Gets the standard host name for the local machine.
+     - Gets the current host name for the local machine.
     </simpara>
    </listitem>
    <listitem>
@@ -722,6 +803,24 @@
      - Tells whether the stream supports locking.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     <function>stream_context_get_params</function>
+     - Retrieve parameters from context.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <function>streamWrapper::stream_cast</function>
+     - Retrieve the underlaying resource.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <function>streamWrapper::stream_set_option</function>
+     - Change stream options
+    </simpara>
+   </listitem>
   </itemizedlist>
 
   <para><link linkend="book.datetime">Date/Time</link>:</para>
@@ -922,6 +1021,12 @@
      - Check whether a message queue exists.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     <function>shm_has_var</function>
+     - Checks whether a specific exists.
+    </simpara>
+   </listitem>
   </itemizedlist>
  </section>
 
@@ -955,6 +1060,11 @@
      dechunk
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     The bz2.decompress filter now supports concatenation
+    </simpara>
+   </listitem>
   </itemizedlist>
  </section>
 
@@ -1031,6 +1141,16 @@
    </listitem>
   </itemizedlist>
 
+  <para><link linkend="book.dom">DOM</link>:</para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <function>DOMNode::getLineNo</function>
+     - Get line number of parsed node.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+
   <para><link linkend="ref.pdo-firebird">PDO_FIREBIRD</link>:</para>
   <itemizedlist>
    <listitem>
@@ -1087,6 +1207,22 @@
    </listitem>
   </itemizedlist>
 
+  <para><link linkend="book.spl">SPL</link>:</para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <function>SplObjectStorage::addAll</function>
+     - Add all elements from another SplObjectStorage object.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <function>SplObjectStorage::removeAll</function>
+     - Remove all elements from another SplObjectStorage object.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+
   <para><link linkend="book.xsl">XSL</link>:</para>
   <itemizedlist>
    <listitem>
@@ -1104,6 +1240,12 @@
    The following are new extensions added (by default) as of PHP 5.3.0:
   </para>
   <itemizedlist>
+   <listitem>
+    <simpara>
+     <link linkend="book.enchant">Enchant</link>
+     - Abstraction layer ontop of spell libraries
+    </simpara>
+   </listitem>
    <listitem>
     <simpara>
      <link linkend="book.fileinfo">Fileinfo</link>
@@ -1191,6 +1333,15 @@
      instead, which still is in the PHP Core.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     <link linkend="book.mhash">mhash</link>
+     - Discontinued, use <link linkend="book.hash">hash</link> 
+     instead. <link linkend="book.hash">hash</link> has full mhash
+     compatibility so all existing applications using the old functions still
+     work.
+    </simpara>
+   </listitem>
   </itemizedlist>
  </section>
 
@@ -1228,10 +1379,28 @@
      - The TZ environment variable is no longer used to guess the timezone
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     <link linkend="book.curl">cURL</link>
+     - cURL now supports SSH
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <link linkend="book.network">Network</link>
+     - now contains an extra "entries" indice, containing the TXT elements
+    </simpara>
+   </listitem>
    <listitem>
     <simpara>
      <link linkend="book.hash">Hash</link>
-     - The SHA-224 hash algorithm is now supported.
+     - The SHA-224 and salsa hash algorithms are now supported.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <link linkend="book.mbstring">mbstring</link>
+     - Now supports CP850 encoding.
     </simpara>
    </listitem>
    <listitem>
@@ -1260,6 +1429,12 @@
      unless <literal>"/tmp"</literal> is explicitly added to the list of allowed paths.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     <link linkend="book.soap">SOAP</link>
+     Now supports sending user supplied HTTP headers.
+    </simpara>
+   </listitem>
   </itemizedlist>
  </section>
 
@@ -1407,6 +1582,11 @@
      <constant>INI_SCANNER_RAW</constant>
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     <constant>PHP_MAXPATHLEN</constant>
+    </simpara>
+   </listitem>
    <listitem>
     <simpara>
      <constant>PHP_WINDOWS_NT_DOMAIN_CONTROLLER</constant>
@@ -1545,6 +1725,15 @@
    </listitem>
   </itemizedlist>
 
+  <para><link linkend="book.libxml">libxml</link>:</para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <constant>LIBXML_LOADED_VERSION </constant>
+    </simpara>
+   </listitem>
+  </itemizedlist>
+
   <para><link linkend="book.pcre">PCRE</link>:</para>
   <itemizedlist>
    <listitem>
@@ -1918,10 +2107,17 @@
   <para>
    <function>session_start</function> now returns &false; when the session startup fails.
   </para>
+  <para>
+   <function>property_exists</function> now checks the existence of a property independent of
+   accessibility (like <function>method_exists</function>).
+  </para>
   <para>
    <link linkend="wrappers">Stream wrappers</link> can now be used by 
    <link linkend="ini.include-path">include_path</link>.
   </para>
+  <para>The <parameter>initial</parameter> parameter for
+   <function>array_reduce</function> can now be of any type.
+  </para>
   <para>
    The <link linkend="ref.dir">directory functions</link> <function>opendir</function>, 
    <function>scandir</function> and <function>dir</function> now use the default