<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 $ -->
   <sect1 xml:id="install.windows.extensions" xmlns="http://docbook.org/ns/docbook">
    <title>Installation of extensions on Windows</title>
    <para>
     After installing PHP and a web server on Windows, you will probably want to
     install some extensions for added functionality. You can choose which
     extensions you would like to load when PHP starts by modifying your
     &php.ini;. You can also load a module dynamically in your script using
     <function>dl</function>.
    </para>
    <para>
     The DLLs for PHP extensions are prefixed with <literal>php_</literal>.
    </para>
    <para>
     Many extensions are <emphasis>built into</emphasis> the Windows version
     of PHP. This means additional DLL files, and the 
     <link linkend="ini.extension">extension</link> directive, are  
     <emphasis>not</emphasis> used to load these extensions. The Windows 
     <link linkend ="install.windows.extensions.overview">PHP Extensions</link>
     table lists extensions that require, or used to require, additional PHP 
     DLL files. Here's a list of built in extensions:
    </para>
    <para>
     In PHP 4 (updated PHP 4.3.11):
     <link linkend="book.bc">BCMath</link>,
     <link linkend="book.calendar">Caledar</link>,
     <link linkend="book.com">COM</link>,
     <link linkend="book.ctype">Ctype</link>,
     <link linkend="book.ftp">FTP</link>,
     <link linkend="book.mysql">MySQL</link>,
     <link linkend="book.uodbc">ODBC</link>,
     <link linkend="book.overload">Overload</link>,
     <link linkend="book.pcre">PCRE</link>,
     <link linkend="book.session">Session</link>,
     <link linkend="book.tokenizer">Tokenizer</link>,
     <link linkend="book.wddx">WDDX</link>,
     <link linkend="book.xml">XML</link>&listendand;
     <link linkend="book.zlib">Zlib</link>
    </para>
    <para>
     In PHP 5 (updated PHP 5.0.4), the following changes exist. Built in:
     <link linkend="book.dom">DOM</link>,
     <link linkend="book.libxml">LibXML</link>,
     <link linkend="book.iconv">Iconv</link>,
     <link linkend="book.simplexml">SimpleXML</link>,
     <link linkend="book.spl">SPL</link>&listendand;
     <link linkend="book.sqlite">SQLite</link>.
     And the following are no longer built in:
     <link linkend="book.mysql">MySQL</link> and 
     <link linkend="book.overload">Overload</link>.
    </para>
    <para>
     The default location PHP searches for extensions is
     <filename class="directory">C:\php4\extensions</filename> in PHP 4 and
     <filename class="directory">C:\php5</filename> in PHP 5. To change this
     setting to reflect your setup of PHP edit your &php.ini; file:
     <itemizedlist>
      <listitem>
       <para>
        You will need to change the
        <link linkend ="ini.extension-dir">extension_dir</link> setting to
        point to the directory where your extensions lives, or where you have
        placed your <filename>php_*.dll</filename> files. For example:
        <informalexample>
         <programlisting role="ini">
<![CDATA[
extension_dir = C:\php\extensions
]]>
         </programlisting>
        </informalexample>
       </para>
      </listitem>
     <listitem>
      <para>
       Enable the extension(s) in &php.ini; you want to use by uncommenting the
       <literal>extension=php_*.dll</literal> lines in &php.ini;. This is done
       by deleting the leading ; from the extension you want to load. 
       <example>
        <title>Enable <link linkend="book.bzip2">Bzip2</link> extension for PHP-Windows</title>
         <programlisting role="ini">
<![CDATA[
// change the following line from ...
;extension=php_bz2.dll

// ... to
extension=php_bz2.dll
]]>
         </programlisting>
        </example>      
       </para>
     </listitem>
      <listitem>
       <para>
        Some of the extensions need extra DLLs to work. Couple of them can be
        found in the distribution package, in the
        <filename class="directory">C:\php\dlls\</filename> folder in PHP 4 or
        in the main folder in PHP 5, but some, for example Oracle
        (<filename>php_oci8.dll</filename>) require DLLs which are not bundled
        with the distribution package. If you are installing PHP 4, copy the
        bundled DLLs from <filename class="directory">C:\php\dlls</filename>
        folder to the main <filename class="directory">C:\php</filename>
        folder. Don't forget to include <filename
         class="directory">C:\php</filename> in the system
        <varname>PATH</varname> (this process is explained in a separate <link
         linkend="faq.installation.addtopath">FAQ entry</link>).
       </para>
     </listitem>
     <listitem>
      <para>
       Some of these DLLs are not bundled with the PHP distribution. See each
       extensions documentation page for details. Also, read the manual 
       section titled <link linkend="install.pecl">Installation of PECL 
       extensions</link> for details on <acronym>PECL</acronym>. An 
       increasingly large number of PHP extensions are found in 
       <acronym>PECL</acronym>, and these extensions require a
       <link linkend="install.pecl.downloads">separate download</link>.
      </para>
     </listitem>
    </itemizedlist>
   <note>
    <simpara>
     If you are running a server module version of PHP
     remember to restart your web server to reflect your changes to &php.ini;.
    </simpara>
   </note>
   </para>

   <para>
    The following table describes some of the extensions available and required
    additional dlls.   
    <table xml:id="install.windows.extensions.overview">
     <title>PHP Extensions</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>Extension</entry>
        <entry>Description</entry>
        <entry>Notes</entry>
       </row>
      </thead>
      <tbody>
  <row>
   <entry>php_bz2.dll</entry>
   <entry><link linkend="book.bzip2">bzip2</link> compression functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_calendar.dll</entry>
   <entry><link linkend="book.calendar">Calendar</link> conversion functions</entry>
   <entry>Built in since PHP 4.0.3</entry>
  </row>
  <row>
   <entry>php_crack.dll</entry>
   <entry><link linkend="book.crack">Crack</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_ctype.dll</entry>
   <entry><link linkend="book.ctype">ctype</link> family functions</entry>
   <entry>Built in since PHP 4.3.0</entry>
  </row>
  <row>
   <entry>php_curl.dll</entry>
   <entry><link linkend="book.curl">CURL</link>, Client URL library functions</entry>
   <entry>Requires: <filename>libeay32.dll</filename>, 
   <filename>ssleay32.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_dba.dll</entry>
   <entry><link linkend="book.dba">DBA</link>: DataBase (dbm-style) 
   Abstraction layer functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_dbase.dll</entry>
   <entry><link linkend="book.dbase">dBase</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_dbx.dll</entry>
   <entry><link linkend="book.dbx">dbx</link> functions</entry>
   <entry></entry>
  </row>
  <row>
   <entry>php_domxml.dll</entry>
   <entry><link linkend="book.domxml">DOM XML</link> functions</entry>
   <entry>
    PHP &lt;= 4.2.0 requires: <filename>libxml2.dll</filename> (bundled)
    PHP &gt;= 4.3.0 requires: <filename>iconv.dll</filename> (bundled)
   </entry>
  </row>
  <row>
   <entry>php_dotnet.dll</entry>
   <entry><link linkend="book.dotnet">.NET</link> functions</entry>
   <entry>PHP &lt;= 4.1.1</entry>
  </row>
  <row>
   <entry>php_exif.dll</entry>
   <entry><link linkend="book.exif">EXIF</link> functions</entry>
   <entry>
    <link linkend="book.mbstring">php_mbstring.dll</link>. And, 
    <filename>php_exif.dll</filename> must be loaded <literal>after</literal> 
    <filename>php_mbstring.dll</filename> in &php.ini;.
   </entry>
  </row>
  <row>
   <entry>php_fbsql.dll</entry>
   <entry><link linkend="book.fbsql">FrontBase</link> functions</entry>
   <entry>PHP &lt;= 4.2.0</entry>
  </row>
  <row>
   <entry>php_fdf.dll</entry>
   <entry><link linkend="book.fdf">FDF</link>: Forms Data Format functions.</entry>
   <entry>Requires: <filename>fdftk.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_filepro.dll</entry>
   <entry><link linkend="book.filepro">filePro</link> functions</entry>
   <entry>Read-only access</entry>
  </row>
  <row>
   <entry>php_ftp.dll</entry>
   <entry><link linkend="book.ftp">FTP</link> functions</entry>
   <entry>Built-in since PHP 4.0.3</entry>
  </row>
  <row>
   <entry>php_gd.dll</entry>
   <entry><link linkend="book.image">GD</link> library image functions</entry>
   <entry>
    Removed in PHP 4.3.2.  Also note that truecolor functions are not
    available in GD1, instead, use <filename>php_gd2.dll</filename>.
   </entry> 
  </row>
  <row>
   <entry>php_gd2.dll</entry>
   <entry><link linkend="book.image">GD</link> library image functions</entry>
   <entry>GD2</entry>
  </row>
  <row>
   <entry>php_gettext.dll</entry>
   <entry><link linkend="book.gettext">Gettext</link> functions</entry>
   <entry>
    PHP &lt;= 4.2.0 requires <filename>gnu_gettext.dll</filename> (bundled), 
    PHP &gt;= 4.2.3 requires <filename>libintl-1.dll</filename>,
    <filename>iconv.dll</filename> (bundled).
   </entry>
  </row>
  <row>
   <entry>php_hyperwave.dll</entry>
   <entry><link linkend="book.hw">HyperWave</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_iconv.dll</entry>
   <entry><link linkend="book.iconv">ICONV</link> characterset conversion</entry>
   <entry>Requires: <filename>iconv-1.3.dll</filename> (bundled), 
   PHP &gt;=4.2.1 <filename>iconv.dll</filename></entry>
  </row>
  <row>
   <entry>php_ifx.dll</entry>
   <entry><link linkend="book.ifx">Informix</link> functions</entry>
   <entry>Requires: Informix libraries</entry>
  </row>
  <row>
   <entry>php_iisfunc.dll</entry>
   <entry>IIS management functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_imap.dll</entry>
   <entry><link linkend="book.imap">IMAP</link> POP3 and NNTP functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_ingres.dll</entry>
   <entry><link linkend="book.ingres">Ingres</link> functions</entry>
   <entry>Requires: Ingres libraries</entry>
  </row>
  <row>
   <entry>php_interbase.dll</entry>
   <entry><link linkend="book.ibase">InterBase</link> functions</entry>
   <entry>Requires: <filename>gds32.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_java.dll</entry>
   <entry><link linkend="book.java">Java</link> functions</entry>
   <entry>PHP &lt;= 4.0.6 requires: <filename>jvm.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_ldap.dll</entry>
   <entry><link linkend="book.ldap">LDAP</link> functions</entry>
   <entry>
    PHP &lt;= 4.2.0 requires <filename>libsasl.dll</filename> (bundled), 
    PHP &gt;= 4.3.0 requires <filename>libeay32.dll</filename>, 
    <filename>ssleay32.dll</filename> (bundled)
   </entry>
  </row>
  <row>
   <entry>php_mbstring.dll</entry>
   <entry><link linkend="book.mbstring">Multi-Byte String</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_mcrypt.dll</entry>
   <entry><link linkend="book.mcrypt">Mcrypt Encryption</link> functions</entry>
   <entry>Requires: <filename>libmcrypt.dll</filename></entry>
  </row>
  <row>
   <entry>php_mhash.dll</entry>
   <entry><link linkend="book.mhash">Mhash</link> functions</entry>
   <entry>PHP &gt;= 4.3.0 requires: <filename>libmhash.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_mime_magic.dll</entry>
   <entry><link linkend="book.mime-magic">Mimetype</link> functions</entry>
   <entry>Requires: <filename>magic.mime</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_ming.dll</entry>
   <entry><link linkend="book.ming">Ming</link> functions for Flash</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_msql.dll</entry>
   <entry><link linkend="book.msql">mSQL</link> functions</entry>
   <entry>Requires: <filename>msql.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_mssql.dll</entry>
   <entry><link linkend="book.mssql">MSSQL</link> functions</entry>
   <entry>Requires: <filename>ntwdblib.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_mysql.dll</entry>
   <entry><link linkend="book.mysql">MySQL</link> functions</entry>
   <entry>PHP &gt;= 5.0.0, requires <filename>libmysql.dll</filename>
    (bundled)</entry>
  </row>
  <row>
   <entry>php_mysqli.dll</entry>
   <entry><link linkend="book.mysqli">MySQLi</link> functions</entry>
   <entry>PHP &gt;= 5.0.0, requires <filename>libmysql.dll</filename>
    (<filename>libmysqli.dll</filename> in PHP &lt;= 5.0.2) (bundled)</entry>
  </row>
  <row>
   <entry>php_oci8.dll</entry>
   <entry><link linkend="book.oci8">Oracle 8</link> functions</entry>
   <entry>Requires: Oracle 8.1+ client libraries</entry>
  </row>
  <row>
   <entry>php_openssl.dll</entry>
   <entry><link linkend="book.openssl">OpenSSL</link> functions</entry>
   <entry>Requires: <filename>libeay32.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_overload.dll</entry>
   <entry><link linkend="book.overload">Object overloading</link> functions</entry>
   <entry>Built in since PHP 4.3.0</entry>
  </row>
  <row>
   <entry>php_pdf.dll</entry>
   <entry><link linkend="book.pdf">PDF</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_pgsql.dll</entry>
   <entry><link linkend="book.pgsql">PostgreSQL</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_printer.dll</entry>
   <entry><link linkend="book.printer">Printer</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_shmop.dll</entry>
   <entry><link linkend="book.shmop">Shared Memory</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_snmp.dll</entry>
   <entry><link linkend="book.snmp">SNMP</link> get and walk functions</entry>
   <entry>NT only!</entry>
  </row>
  <row>
   <entry>php_soap.dll</entry>
   <entry><link linkend="book.soap">SOAP</link> functions</entry>
   <entry>PHP &gt;= 5.0.0</entry>
  </row>
  <row>
   <entry>php_sockets.dll</entry>
   <entry><link linkend="book.sockets">Socket</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_sybase_ct.dll</entry>
   <entry><link linkend="book.sybase">Sybase</link> functions</entry>
   <entry>Requires: Sybase client libraries</entry>
  </row>
  <row>
   <entry>php_tidy.dll</entry>
   <entry><link linkend="book.tidy">Tidy</link> functions</entry>
   <entry>PHP &gt;= 5.0.0</entry>
  </row>
  <row>
   <entry>php_tokenizer.dll</entry>
   <entry><link linkend="book.tokenizer">Tokenizer</link> functions</entry>
   <entry>Built in since PHP 4.3.0</entry>
  </row>
  <row>
   <entry>php_w32api.dll</entry>
   <entry><link linkend="book.w32api">W32api</link> functions</entry>
   <entry>None</entry>
  </row>
  <row>
   <entry>php_xmlrpc.dll</entry>
   <entry><link linkend="book.xmlrpc">XML-RPC</link> functions</entry>
   <entry>PHP &gt;= 4.2.1 requires: <filename>iconv.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_xslt.dll</entry>
   <entry><link linkend="book.xslt">XSLT</link> functions</entry>
   <entry>
    PHP &lt;= 4.2.0 requires <filename>sablot.dll</filename>,
    <filename>expat.dll</filename> (bundled). PHP &gt;= 4.2.1 requires
    <filename>sablot.dll</filename>, <filename>expat.dll</filename>,
    <filename>iconv.dll</filename> (bundled).
   </entry>
  </row>
  <row>
   <entry>php_yaz.dll</entry>
   <entry><link linkend="book.yaz">YAZ</link> functions</entry>
   <entry>Requires: <filename>yaz.dll</filename> (bundled)</entry>
  </row>
  <row>
   <entry>php_zip.dll</entry>
   <entry><link linkend="book.zip">Zip File</link> functions</entry>
   <entry>Read only access</entry>
  </row>
  <row>
   <entry>php_zlib.dll</entry>
   <entry><link linkend="book.zlib">ZLib</link> compression functions</entry>
   <entry>Built in since PHP 4.3.0</entry>
  </row>
       </tbody>
      </tgroup>
     </table>
    </para>
   </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
-->