<!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>Compiling shared PECL extensions with the pecl command</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="install.pecl.windows.html">Installing a PHP extension on Windows</a></div>
<div class="next" style="text-align: right; float: right;"><a href="install.pecl.phpize.html">Compiling shared PECL extensions with phpize</a></div>
<div class="up"><a href="install.pecl.html">Installation of PECL extensions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="install.pecl.pear" class="sect1">
<h2 class="title">Compiling shared PECL extensions with the pecl command</h2>
<p class="simpara">
PECL makes it easy to create shared PHP extensions. Using the
<a href="http://pear.php.net/manual/en/guide.users.commandline.cli.php" class="link external">» pecl command</a>, do the following:
</p>
<p class="para">
<div class="example-contents screen"><br />
$ pecl install extname<br />
</div>
</p>
<p class="simpara">
This will download the source for <em class="emphasis">extname</em>,
compile, and install <var class="filename">extname.so</var> into your <a href="ini.core.html#ini.extension-dir" class="link">extension_dir</a>.
<var class="filename">extname.so</var> may then be loaded via <var class="filename">php.ini</var>
</p>
<p class="simpara">
By default, the <em>pecl</em> command will not install
packages that are marked with the <em>alpha</em> or
<em>beta</em> state. If no <em>stable</em> packages
are available, you may install a <em>beta</em> package using the
following command:
</p>
<p class="para">
<div class="example-contents screen"><br />
$ pecl install extname-beta<br />
</div>
</p>
<p class="para">
You may also install a specific version using this variant:
</p>
<p class="para">
<div class="example-contents screen"><br />
$ pecl install extname-0.1<br />
</div>
</p>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
After enabling the extension in <var class="filename">php.ini</var>, restarting the web service is
required for the changes to be picked up.
</p>
</p></blockquote>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="install.pecl.windows.html">Installing a PHP extension on Windows</a></div>
<div class="next" style="text-align: right; float: right;"><a href="install.pecl.phpize.html">Compiling shared PECL extensions with phpize</a></div>
<div class="up"><a href="install.pecl.html">Installation of PECL extensions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
