php-doc-en/appendices/migration73/deprecated.xml

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

<sect1 xml:id="migration73.deprecated">
 <title>Deprecated Features</title>

 <sect2 xml:id="migration73.deprecated.core">
  <title>PHP Core</title>

  <sect3 xml:id="migration73.deprecated.core.ci-constant">
   <title>Case-Insensitive Constants</title>

   <para>
    The declaration of case-insensitive constants has been deprecated. Passing
    &true; as the third argument to <function>define</function> will now generate a
    deprecation warning. The use of case-insensitive constants with a case that
    differs from the declaration is also deprecated.
   </para>
  </sect3>

  <sect3 xml:id="migration73.deprecated.core.assert">
   <title>Namespaced assert()</title>

   <para>
    Declaring a function called <literal>assert()</literal> inside a namespace is
    deprecated. The <function>assert</function> function is subject to special
    handling by the engine, which may lead to inconsistent behavior when defining
    a namespaced function with the same name.
   </para>
  </sect3>

  <sect3 xml:id="migration73.deprecated.core.string-search">
   <title>Searching Strings for non-string Needle</title>

   <para>
    Passing a non-string needle to string search functions is deprecated. In the
    future the needle will be interpreted as a string instead of an ASCII
    codepoint. Depending on the intended behavior, you should either explicitly
    cast the needle to string or perform an explicit call to
    <function>chr</function>. The following functions are affected:
    <itemizedlist>
     <listitem>
      <simpara><function>strpos</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>strrpos</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>stripos</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>strripos</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>strstr</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>strchr</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>strrchr</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>stristr</function></simpara>
     </listitem>
    </itemizedlist>
   </para>
  </sect3>

  <sect3 xml:id="migration73.deprecated.core.strip-tags-streaming">
   <title>Strip-Tags Streaming</title>

   <para>
    The <function>fgetss</function> function and the <link
    linkend="filters.string">string.strip_tags stream filter</link> have been
    deprecated. This also affects the
    <methodname>SplFileObject::fgetss</methodname>
    method and <function>gzgetss</function> function.
   </para>
  </sect3>

 </sect2>

 <sect2 xml:id="migration73.deprecated.filter">
  <title>Data Filtering</title>

  <para>
   The explicit usage of the constants
   <constant>FILTER_FLAG_SCHEME_REQUIRED</constant> and
   <constant>FILTER_FLAG_HOST_REQUIRED</constant> is now deprecated; both are
   implied for <constant>FILTER_VALIDATE_URL</constant> anyway.
  </para>
 </sect2>

 <sect2 xml:id="migration73.deprecated.image">
  <title>Image Processing and GD</title>

  <para>
   <function>image2wbmp</function> has been deprecated.
  </para>
 </sect2>

 <sect2 xml:id="migration72.deprecated.intl">
  <title>Internationalization Functions</title>

  <para>
   Usage of the <constant>Normalizer::NONE</constant> form throws a deprecation
   warning, if PHP is linked with ICU ≥ 56.
  </para>
 </sect2>

 <sect2 xml:id="migration73.deprecated.mbstring">
  <title>Multibyte String</title>

  <para>
   The following undocumented <literal>mbereg_*()</literal> aliases have been
   deprecated. Use the corresponding <literal>mb_ereg_*()</literal> variants
   instead.
   <itemizedlist>
    <listitem>
     <simpara><function>mbregex_encoding</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mberegi</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_replace</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mberegi_replace</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbsplit</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_match</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_search</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_search_pos</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_search_regs</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_search_init</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_search_getregs</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_search_getpos</function></simpara> 
    </listitem>
    <listitem>
     <simpara><function>mbereg_search_setpos</function></simpara> 
    </listitem>
   </itemizedlist>
  </para>
 </sect2>

 <sect2 xml:id="migration73.deprecated.pdo-odbc">
  <title>ODBC and DB2 Functions (PDO_ODBC)</title>

  <para>
   The <link
   linkend="ini.pdo-odbc.db2-instance-name">pdo_odbc.db2_instance_name</link>
   ini setting has been formally deprecated. It is deprecated in the
   documentation as of PHP 5.1.1.
  </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
-->