<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<sect1 xml:id="migration72.new-features" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>New features</title>

 <sect2 xml:id="migration72.new-features.object-type">
  <title>New object type</title>

  <para>
   A new type, <type>object</type>, has been introduced that can be used for
   (contravariant) parameter typing and (covariant) return typing of any
   objects.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

function test(object $obj) : object
{
    return new SplQueue();
}

test(new stdClass());
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration72.new-features.ext-loading-by-name">
  <title>Extension loading by name</title>

  <para>
   Shared extensions no longer require their file extension
   (<literal>.so</literal> for Unix or <literal>.dll</literal> for Windows) to
   be specified. This is enabled in the php.ini file, as well as in the
   <function>dl</function> function.
  </para>
 </sect2>

 <sect2 xml:id="migration72.new-features.abstract-method-overriding">
  <title>Abstract method overriding</title>

  <para>
   Abstract methods can now be overridden when an abstract class extends
   another abstract class.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

abstract class A
{
    abstract function test(string $s);
}
abstract class B extends A
{
    // overridden - still maintaining contravariance for parameters and covariance for return
    abstract function test($s) : int;
}
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration72.new-features.sodium">
  <title><link linkend="book.sodium">Sodium</link> is now a core extension</title>

  <para>
   The modern Sodium cryptography library has now become a core extension in PHP.
  </para>
  <para>
   For a complete function reference, see the <link linkend="book.sodium">Sodium</link>
   chapter.
  </para>
 </sect2>

 <sect2 xml:id="migration72.new-features.pws-hashing-with-argon2">
  <title>Password hashing with Argon2</title>

  <para>
   Argon2 has been added to the <link linkend="book.password">password hashing API</link>, 
   where the following constants have been exposed:
  </para>

  <itemizedlist>
   <listitem>
    <simpara>
     <constant>PASSWORD_ARGON2I</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>PASSWORD_ARGON2_DEFAULT_THREADS</constant>
    </simpara>
   </listitem>
  </itemizedlist>
 </sect2>

 <sect2 xml:id="migration72.new-features.pdo-extended-str-types">
  <title>Extended string types for <link linkend="book.pdo">PDO</link></title>

  <para>
   PDO's string type has been extended to support the national character type
   when emulating prepares. This has been done with the following constants:
  </para>

  <itemizedlist>
   <listitem>
    <simpara>
     <constant>PDO::PARAM_STR_NATL</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>PDO::PARAM_STR_CHAR</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>PDO::ATTR_DEFAULT_STR_PARAM</constant>
    </simpara>
   </listitem>
  </itemizedlist>

  <para>
   These constants are utilised by bitwise <literal>OR</literal>'ing them with
   <constant>PDO::PARAM_STR</constant>:
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

$db->quote('über', PDO::PARAM_STR | PDO::PARAM_STR_NATL);
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration72.new-features.additional-emulated-prepares-debugging-info">
  <title>Additional emulated prepares debugging information for <link linkend="book.pdo">PDO</link></title>

  <para>
   The <function>PDOStatement::debugDumpParams</function> method has been
   updated to include the SQL being sent to the DB, where the full, raw query
   (including the replaced placeholders with their bounded values) will be
   shown. This has been added to aid with debugging emulated prepares (and so
   it will only be available when emulated prepares are turned on).
  </para>
 </sect2>

 <sect2 xml:id="migration72.new-features.extended-ops-in-ldap">
  <title>Support for extended operations in <link linkend="book.ldap">LDAP</link></title>

  <para>
   Support for EXOP has been added to the LDAP extension. This has been done by
   exposing the following functions and constants:
  </para>

  <itemizedlist>
   <listitem>
    <simpara>
     <function>ldap_parse_exop</function>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <function>ldap_exop</function>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <function>ldap_exop_passwd</function>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <function>ldap_exop_whoami</function>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>LDAP_EXOP_START_TLS</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>LDAP_EXOP_MODIFY_PASSWD</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>LDAP_EXOP_REFRESH</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>LDAP_EXOP_WHO_AM_I</constant>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>LDAP_EXOP_TURN</constant>
    </simpara>
   </listitem>
  </itemizedlist>
 </sect2>

 <sect2 xml:id="migration72.new-features.addr-info-in-sockets">
  <title>Address Information additions to the <link linkend="book.sockets">Sockets</link> extension</title>

  <para>
   The sockets extension now has the ability to lookup address information, as
   well as connect to it, bind to it, and explain it. The following four
   functions have been added for this:
  </para>

  <itemizedlist>
   <listitem>
    <simpara>
     <function>socket_addrinfo_lookup</function>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <function>socket_addrinfo_connect</function>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <function>socket_addrinfo_bind</function>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <function>socket_addrinfo_explain</function>
    </simpara>
   </listitem>
  </itemizedlist>
 </sect2>

 <sect2 xml:id="migration72.new-features.param-type-widening">
  <title>Parameter type widening</title>

  <para>
   Parameter types from overridden methods and from interface implementations
   may now be omitted. This is still in compliance with LSP, since parameters
   types are contravariant.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

interface A
{
    public function Test(array $input);
}

class B implements A
{
    public function Test($input){} // type omitted for $input
}
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration72.new-features.trailing-comma-in-grouped-namespaces">
  <title>Allow a trailing comma for grouped namespaces</title>

  <para>
   A trailing comma can now be added to the group-use syntax introduced in
   PHP 7.0.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

use Foo\Bar\{
    Foo,
    Bar,
    Baz,
};
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration72.new-features.proc_nice-windows-support">
  <title><function>proc_nice</function> support on Windows</title>

  <para>
   The <function>proc_nice</function> function is now supported on Windows.
  </para>
 </sect2>

 <sect2 xml:id="migration72.new-features.pack-unpack-endian-support">
  <title><function>pack</function> and <function>unpack</function> endian support</title>

  <para>
   The <function>pack</function> and <function>unpack</function> functions now
   support float and double in both little and big endian.
  </para>
 </sect2>

 <sect2 xml:id="migration72.new-features.exif-features">
  <title>Enhancements to the <link linkend="book.exif">EXIF</link> extension</title>

  <para>
   The EXIF extension has been updated to support a much larger range of formats. This 
   means that their format specific tags are now properly translated when parsing images 
   with the <function>exif_read_data</function> function. The following new formats are 
   now supported:
  </para>

  <itemizedlist>
   <listitem>
    <simpara>
     Samsung
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     DJI
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Panasonic
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Sony
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Pentax
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Minolta
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Sigma/Foveon
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     AGFA
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Kyocera
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Ricoh
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Epson
    </simpara>
   </listitem>
  </itemizedlist>

  <para>
   The EXIF functions <function>exif_read_data</function> and <function>exif_thumbnail</function> 
   now support passing streams as their first argument.
  </para>
 </sect2>

 <sect2 xml:id="migration72.new-features.pcre">
  <title>New features in <link linkend="book.pcre">PCRE</link></title>

  <itemizedlist>
   <listitem>
    <simpara>
     The <literal>J</literal> modifier for setting PCRE_DUPNAMES has been added.
    </simpara>
   </listitem>
  </itemizedlist>
 </sect2>

 <sect2 xml:id="migration72.new-features.sqlite3">
  <title><link linkend="book.sqlite3">SQLite3</link> allows writing BLOBs</title>

  <para>
   <methodname>SQLite3::openBlob</methodname> now allows to open BLOB fields in
   write mode; formerly only read mode was supported.
  </para>
 </sect2>

 <sect2 xml:id="migration72.new-features.oci8">
  <title><link linkend="book.oci8">Oracle OCI8</link> Transparent Application Failover Callbacks</title>

  <para>
   Support for <link linkend="oci8.taf">Oracle Database Transparent Application Failover (TAF) callbacks</link>
   has been added. TAF allows PHP OCI8 applications to
   automatically reconnect to a preconfigured database when a connection
   is broken.  The new TAF callback support allows PHP applications to
   monitor and control reconnection during failover. 
  </para>
 </sect2>

 <sect2 xml:id="migration72.new-features.zip">
  <title>Enhancements to the <link linkend="book.zip">ZIP</link> extension</title>

  <para>
   Read and write support for encrypted archives has been added (requires libzip 1.2.0).
  </para>
  <para>
   The <classname>ZipArchive</classname> class now implements the <interfacename>Countable</interfacename> 
   interface.
  </para>
  <para>
   The <literal>zip://</literal> stream now accepts a <literal>'password'</literal> context option.
  </para>
 </sect2>

</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->