mirror of
https://github.com/macintoshplus/doc-en.git
synced 2026-03-29 12:22:18 +02:00
067bdb4bf9
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@175396 c90b9560-bf6c-de11-be94-00142212c4b1
456 lines
15 KiB
XML
456 lines
15 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision: 1.7 $ -->
|
|
<sect1 id="install.windows.extensions">
|
|
<title>Installation of extensions on Windows</title>
|
|
<para>
|
|
After installing PHP and a webserver 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>
|
|
<note>
|
|
<para>
|
|
In PHP 4.3.1 BCMath, Calendar, COM, Ctype, FTP, MySQL, ODBC, Overload,
|
|
PCRE, Session, Tokenizer, WDDX, XML and Zlib support is
|
|
<emphasis>built in</emphasis>. You don't need to load any additional
|
|
extensions in order to use these functions. See your distributions
|
|
<filename>README.txt</filename> or <filename>install.txt</filename>
|
|
or <link linkend ="install.windows.extensions.overview">this table</link>
|
|
for a list of built in modules.
|
|
</para>
|
|
</note>
|
|
|
|
<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. Please do not
|
|
forget the last backslash. 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 ; form the extension you want to load.
|
|
<example>
|
|
<title>Enable <link linkend="ref.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>
|
|
</itemizedlist>
|
|
<note>
|
|
<simpara>
|
|
If you are running a server module version of PHP
|
|
remember to restart your webserver 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 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="ref.bzip2">bzip2</link> compression functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_calendar.dll</entry>
|
|
<entry><link linkend="ref.calendar">Calendar</link> conversion functions</entry>
|
|
<entry>Built in since PHP 4.0.3</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_cpdf.dll</entry>
|
|
<entry><link linkend="ref.cpdf">ClibPDF</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_crack.dll</entry>
|
|
<entry><link linkend="ref.crack">Crack</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_ctype.dll</entry>
|
|
<entry><link linkend="ref.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="ref.curl">CURL</link>, Client URL library functions</entry>
|
|
<entry>Requires: <filename>libeay32.dll</filename>,
|
|
<filename>ssleay32.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_cybercash.dll</entry>
|
|
<entry><link linkend="ref.cybercash">Cybercash</link> payment functions</entry>
|
|
<entry>PHP <= 4.2.0</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_db.dll</entry>
|
|
<entry><link linkend="ref.dbm">DBM</link> functions</entry>
|
|
<entry>Deprecated. Use DBA instead (<filename>php_dba.dll</filename>)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_dba.dll</entry>
|
|
<entry><link linkend="ref.dba">DBA</link>: DataBase (dbm-style)
|
|
Abstraction layer functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_dbase.dll</entry>
|
|
<entry><link linkend="ref.dbase">dBase</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_dbx.dll</entry>
|
|
<entry><link linkend="ref.dbx">dbx</link> functions</entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_domxml.dll</entry>
|
|
<entry><link linkend="ref.domxml">DOM XML</link> functions</entry>
|
|
<entry>
|
|
PHP <= 4.2.0 requires: <filename>libxml2.dll</filename> (bundled)
|
|
PHP >= 4.3.0 requires: <filename>iconv.dll</filename> (bundled)
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_dotnet.dll</entry>
|
|
<entry><link linkend="ref.dotnet">.NET</link> functions</entry>
|
|
<entry>PHP <= 4.1.1</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_exif.dll</entry>
|
|
<entry><link linkend="ref.exif">EXIF</link> functions</entry>
|
|
<entry>
|
|
<link linkend="ref.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="ref.fbsql">FrontBase</link> functions</entry>
|
|
<entry>PHP <= 4.2.0</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_fdf.dll</entry>
|
|
<entry><link linkend="ref.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="ref.filepro">filePro</link> functions</entry>
|
|
<entry>Read-only access</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_ftp.dll</entry>
|
|
<entry><link linkend="ref.ftp">FTP</link> functions</entry>
|
|
<entry>Built-in since PHP 4.0.3</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_gd.dll</entry>
|
|
<entry><link linkend="ref.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="ref.image">GD</link> library image functions</entry>
|
|
<entry>GD2</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_gettext.dll</entry>
|
|
<entry><link linkend="ref.gettext">Gettext</link> functions</entry>
|
|
<entry>
|
|
PHP <= 4.2.0 requires <filename>gnu_gettext.dll</filename> (bundled),
|
|
PHP >= 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="ref.hw">HyperWave</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_iconv.dll</entry>
|
|
<entry><link linkend="ref.iconv">ICONV</link> characterset conversion</entry>
|
|
<entry>Requires: <filename>iconv-1.3.dll</filename> (bundled),
|
|
PHP >=4.2.1 <filename>iconv.dll</filename></entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_ifx.dll</entry>
|
|
<entry><link linkend="ref.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="ref.imap">IMAP</link> POP3 and NNTP functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_ingres.dll</entry>
|
|
<entry><link linkend="ref.ingres">Ingres II</link> functions</entry>
|
|
<entry>Requires: Ingres II libraries</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_interbase.dll</entry>
|
|
<entry><link linkend="ref.ibase">InterBase</link> functions</entry>
|
|
<entry>Requires: <filename>gds32.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_java.dll</entry>
|
|
<entry><link linkend="ref.java">Java</link> functions</entry>
|
|
<entry>PHP <= 4.0.6 requires: <filename>jvm.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_ldap.dll</entry>
|
|
<entry><link linkend="ref.ldap">LDAP</link> functions</entry>
|
|
<entry>
|
|
PHP <= 4.2.0 requires <filename>libsasl.dll</filename> (bundled),
|
|
PHP >= 4.3.0 requires <filename>libeay32.dll</filename>,
|
|
<filename>ssleay32.dll</filename> (bundled)
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_mbstring.dll</entry>
|
|
<entry><link linkend="ref.mbstring">Multi-Byte String</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_mcrypt.dll</entry>
|
|
<entry><link linkend="ref.mcrypt">Mcrypt Encryption</link> functions</entry>
|
|
<entry>Requires: <filename>libmcrypt.dll</filename></entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_mhash.dll</entry>
|
|
<entry><link linkend="ref.mhash">Mhash</link> functions</entry>
|
|
<entry>PHP >= 4.3.0 requires: <filename>libmhash.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_mime_magic.dll</entry>
|
|
<entry><link linkend="ref.mime-magic">Mimetype</link> functions</entry>
|
|
<entry>Requires: <filename>magic.mime</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_ming.dll</entry>
|
|
<entry><link linkend="ref.ming">Ming</link> functions for Flash</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_msql.dll</entry>
|
|
<entry><link linkend="ref.msql">mSQL</link> functions</entry>
|
|
<entry>Requires: <filename>msql.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_mssql.dll</entry>
|
|
<entry><link linkend="ref.mssql">MSSQL</link> functions</entry>
|
|
<entry>Requires: <filename>ntwdblib.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_mysql.dll</entry>
|
|
<entry><link linkend="ref.mysql">MySQL</link> functions</entry>
|
|
<entry>PHP >= 5.0.0, requires <filename>libmysql.dll</filename>
|
|
(bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_mysqli.dll</entry>
|
|
<entry><link linkend="ref.mysqli">MySQLi</link> functions</entry>
|
|
<entry>PHP >= 5.0.0, requires <filename>libmysql.dll</filename>
|
|
(<filename>libmysqli.dll</filename> in PHP <= 5.0.2) (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_oci8.dll</entry>
|
|
<entry><link linkend="ref.oci8">Oracle 8</link> functions</entry>
|
|
<entry>Requires: Oracle 8.1+ client libraries</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_openssl.dll</entry>
|
|
<entry><link linkend="ref.openssl">OpenSSL</link> functions</entry>
|
|
<entry>Requires: <filename>libeay32.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_oracle.dll</entry>
|
|
<entry><link linkend="ref.oracle">Oracle</link> functions</entry>
|
|
<entry>Requires: Oracle 7 client libraries</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_overload.dll</entry>
|
|
<entry><link linkend="ref.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="ref.pdf">PDF</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_pgsql.dll</entry>
|
|
<entry><link linkend="ref.pgsql">PostgreSQL</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_printer.dll</entry>
|
|
<entry><link linkend="ref.printer">Printer</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_shmop.dll</entry>
|
|
<entry><link linkend="ref.shmop">Shared Memory</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_snmp.dll</entry>
|
|
<entry><link linkend="ref.snmp">SNMP</link> get and walk functions</entry>
|
|
<entry>NT only!</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_soap.dll</entry>
|
|
<entry><link linkend="ref.soap">SOAP</link> functions</entry>
|
|
<entry>PHP >= 5.0.0</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_sockets.dll</entry>
|
|
<entry><link linkend="ref.sockets">Socket</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_sybase_ct.dll</entry>
|
|
<entry><link linkend="ref.sybase">Sybase</link> functions</entry>
|
|
<entry>Requires: Sybase client libraries</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_tidy.dll</entry>
|
|
<entry><link linkend="ref.tidy">Tidy</link> functions</entry>
|
|
<entry>PHP >= 5.0.0</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_tokenizer.dll</entry>
|
|
<entry><link linkend="ref.tokenizer">Tokenizer</link> functions</entry>
|
|
<entry>Built in since PHP 4.3.0</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_w32api.dll</entry>
|
|
<entry><link linkend="ref.w32api">W32api</link> functions</entry>
|
|
<entry>None</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_xmlrpc.dll</entry>
|
|
<entry><link linkend="ref.xmlrpc">XML-RPC</link> functions</entry>
|
|
<entry>PHP >= 4.2.1 requires: <filename>iconv.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_xslt.dll</entry>
|
|
<entry><link linkend="ref.xslt">XSLT</link> functions</entry>
|
|
<entry>
|
|
PHP <= 4.2.0 requires <filename>sablot.dll</filename>,
|
|
<filename>expat.dll</filename> (bundled). PHP >= 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="ref.yaz">YAZ</link> functions</entry>
|
|
<entry>Requires: <filename>yaz.dll</filename> (bundled)</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_zip.dll</entry>
|
|
<entry><link linkend="ref.zip">Zip File</link> functions</entry>
|
|
<entry>Read only access</entry>
|
|
</row>
|
|
<row>
|
|
<entry>php_zlib.dll</entry>
|
|
<entry><link linkend="ref.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:"../../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
|
|
-->
|