<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="pcre.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;
 <para>
  The PCRE extension is a core PHP extension, so it is always enabled.
  By default, this extension is compiled using the bundled PCRE
  library. Alternatively, an external PCRE library can be used by
  passing in the <option role="configure">--with-pcre-regex=DIR</option>
  configuration option where <literal>DIR</literal> is the location of
  PCRE's include and library files. It is recommended to use PCRE 8.10 or newer;
  as of PHP 7.3.0, PCRE2 is required.
 </para>
 <para>
  PCRE's just-in-time compilation is supported by default, which
  can be disabled with the <option role="configure">--without-pcre-jit</option>
  configuration option as of PHP 7.0.12.
 </para>
 &windows.builtin;
 <para>
  PCRE is an active project and as it changes so does the PHP
  functionality that relies upon it. It is possible that certain parts
  of the PHP documentation is outdated, in that it may not cover the
  newest features that PCRE provides. For a list of changes, see the
  <link xlink:href="&url.pcre.changelog;">PCRE library changelog</link>
  and also the following bundled PCRE history:
 </para>
 <para>
  <table>
   <title>Upgrade history of the bundled PCRE library</title>
   <tgroup cols="3">
    <thead>
     <row>
      <entry>PHP &Version;</entry>
      <entry>Updated PCRE &Version;</entry>
      <entry>Notes</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.2.0</entry>
      <entry>10.40</entry>
      <entry></entry>
     </row>
     <row>
      <entry>8.1.0</entry>
      <entry>10.39</entry>
      <entry></entry>
     </row>
     <row>
      <entry>7.4.12, 8.0.0</entry>
      <entry>10.35</entry>
      <entry></entry>
     </row>
     <row>
      <entry>7.4.6</entry>
      <entry>10.34</entry>
      <entry></entry>
     </row>
     <row>
      <entry>7.4.0</entry>
      <entry>10.33</entry>
      <entry></entry>
     </row>
     <row>
      <entry>7.3.0</entry>
      <entry>10.32</entry>
      <entry></entry>
     </row>
     <row>
      <entry>7.2.0</entry>
      <entry>8.41</entry>
      <entry></entry>
     </row>
     <row>
      <entry>7.0.3</entry>
      <entry>8.38</entry>
      <entry>See CVE-2015-8383, CVE-2015-8386, CVE-2015-8387, CVE-2015-8389, CVE-2015-8390, CVE-2015-8391, CVE-2015-8393, CVE-2015-8394</entry>
     </row>
     <row>
      <entry>7.0.0</entry>
      <entry>8.37</entry>
      <entry>See CVE-2015-2325, CVE-2015-2326</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
</section>

<!-- 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
-->

