<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>Installation</title> </head> <body><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="pcre.requirements.html">Requirements</a></div> <div class="next" style="text-align: right; float: right;"><a href="pcre.configuration.html">Runtime Configuration</a></div> <div class="up"><a href="pcre.setup.html">Installing/Configuring</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div><hr /><div id="pcre.installation" class="section"> <h2 class="title">Installation</h2> <p class="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 <strong class="option configure">--with-pcre-regex=DIR</strong> configuration option where <em>DIR</em> is the location of PCRE's include and library files. It is recommended to use PCRE 8.10 or newer for PHP 5.6 and 7.0. </p> <p class="para"> As of PHP 7.0.0 PCRE's just-in-time compilation is supported by default, which can be disabled with the <strong class="option configure">--without-pcre-jit</strong> configuration option as of PHP 7.0.12. </p> <p class="simpara">The Windows version of PHP has built-in support for this extension. You do not need to load any additional extensions in order to use these functions.</p> <blockquote class="note"><p><strong class="note">Note</strong>: <p class="para"> Before PHP 5.3.0, this extension could be disabled by passing in the <strong class="option configure">--without-pcre-regex</strong> configuration option. </p> </p></blockquote> <p class="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 <a href="http://www.pcre.org/original/changelog.txt" class="link external">» PCRE library changelog</a> and also the following bundled PCRE history: </p> <p class="para"> <table class="doctable table"> <caption><strong>Upgrade history of the bundled PCRE library</strong></caption> <thead> <tr> <th>PHP Version</th> <th>Updated PCRE Version</th> <th>Notes</th> </tr> </thead> <tbody class="tbody"> <tr> <td>7.0.3 / 5.6.18 / 5.5.32</td> <td>8.38</td> <td>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</td> </tr> <tr> <td>7.0.0 / 5.6.9 / 5.5.26 / 5.4.41</td> <td>8.37</td> <td>See CVE-2015-2325, CVE-2015-2326</td> </tr> <tr> <td>5.6.0 / 5.5.10</td> <td>8.34</td> <td class="empty"> </td> </tr> <tr> <td>5.5.0 / 5.4.14 / 5.3.24</td> <td>8.32</td> <td class="empty"> </td> </tr> <tr> <td>5.4.9 / 5.3.19</td> <td>8.31</td> <td class="empty"> </td> </tr> <tr> <td>5.3.7</td> <td>8.12</td> <td class="empty"> </td> </tr> <tr> <td>5.3.6</td> <td>8.11</td> <td class="empty"> </td> </tr> <tr> <td>5.3.4</td> <td>8.10</td> <td class="empty"> </td> </tr> <tr> <td>5.3.3 / 5.2.14</td> <td>8.02</td> <td class="empty"> </td> </tr> <tr> <td>5.3.2</td> <td>8.00</td> <td class="empty"> </td> </tr> <tr> <td>5.3.0 / 5.2.13</td> <td>7.9</td> <td class="empty"> </td> </tr> <tr> <td>5.2.7</td> <td>7.8</td> <td class="empty"> </td> </tr> <tr> <td>5.2.6</td> <td>7.6</td> <td class="empty"> </td> </tr> <tr> <td>5.2.5</td> <td>7.3</td> <td class="empty"> </td> </tr> <tr> <td>5.2.4</td> <td>7.2</td> <td class="empty"> </td> </tr> <tr> <td>5.2.2</td> <td>7.0</td> <td class="empty"> </td> </tr> <tr> <td>5.2.0</td> <td>6.7</td> <td class="empty"> </td> </tr> <tr> <td>5.1.3</td> <td>6.6</td> <td class="empty"> </td> </tr> <tr> <td>5.1.0</td> <td>6.2</td> <td class="empty"> </td> </tr> <tr> <td>5.0.5</td> <td>5.0</td> <td class="empty"> </td> </tr> <tr> <td>5.0.0</td> <td>4.5</td> <td class="empty"> </td> </tr> <tr> <td>4.4.7</td> <td>7.7</td> <td class="empty"> </td> </tr> </tbody> </table> </p> </div><hr /><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="pcre.requirements.html">Requirements</a></div> <div class="next" style="text-align: right; float: right;"><a href="pcre.configuration.html">Runtime Configuration</a></div> <div class="up"><a href="pcre.setup.html">Installing/Configuring</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div></body></html>