<!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">
Beginning with PHP 4.2.0 these functions are enabled by default. You can
disable the pcre functions with
<strong class="option configure">--without-pcre-regex</strong>
. Use
<strong class="option configure">--with-pcre-regex=DIR</strong>
to specify DIR
where PCRE's include and library files are located, if not using bundled library.
For older versions you have to configure and compile PHP
with <strong class="option configure">--with-pcre-regex[=DIR]</strong>
in order
to use these functions.
</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">
As of PHP 5.3.0 this extension cannot be disabled and is therefore always
present.
</p>
<p class="para">
It is still possible to build against an external PCRE library by using
<strong class="option configure">--with-pcre-regex=DIR</strong>
</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/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>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</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</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.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>
