php-doc-en/reference/pdo/configure.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<section xml:id="pdo.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;
 <procedure xml:id='pdo.install.unix51up'>
  <title>PHP 5.1 and up on Unix systems</title>
  <step>
   <para>
    If you're running a PHP 5.1 release, PDO and <link
    linkend="ref.pdo-sqlite">PDO_SQLITE</link> is included in the distribution;
    it will be automatically enabled when you run configure.  It is
    recommended that you build PDO as a shared extension, as this will allow
    you to take advantage of updates that are made available via PECL.  The
    recommended configure line for building PHP with PDO support should
    enable zlib support (for the pecl installer) as well.  You may also need
    to enable the PDO driver for your database of choice; consult the
    documentation for  <link linkend="pdo.drivers">database-specific
    PDO drivers</link> to find out more about that, but note that if you
    build PDO as a shared extension, you must build the PDO drivers as
    shared extensions.
    SQLite extension depends on PDO so if PDO is built as a shared extension,
    SQLite needs to be built the same way.
    <screen>
<![CDATA[
./configure --with-zlib --enable-pdo=shared --with-pdo-sqlite=shared --with-sqlite=shared
]]>
    </screen>
   </para>
  </step>
  <step>
   <para>
    After installing PDO as a shared module, you must edit your php.ini file
    so that the PDO extension will be loaded automatically when PHP runs.
    You will also need to enable any database specific drivers there too;
    make sure that they are listed after the pdo.so line, as PDO must be
    initialized before the database-specific extensions can be loaded.
    If you built PDO and the database-specific extensions statically, you
    can skip this step.
    <screen>
<![CDATA[
extension=pdo.so
]]>
    </screen>
   </para>
  </step>
  <step>
   <para>
    Having PDO as a shared module will allow you to run <command>pecl
    upgrade pdo</command> as new versions of PDO are published, without
    forcing you to rebuild the whole of PHP.  Note that if you do this, you
    also need to upgrade your database specific PDO drivers at the same
    time.
   </para>
  </step>
 </procedure>
 <procedure xml:id='pdo.install.pecl'>
  <title>PHP 5.0.0 and up on Unix systems</title>
  <step>
   <para>
    PDO is available as a PECL extension from
    <link xlink:href='&url.pecl.package;pdo'>&url.pecl.package;pdo</link>.
    Installation can be performed via the <command>pecl</command> tool; this
    is enabled by default when you configure PHP.  You should ensure that
    PHP was configured --with-zlib in order for
    <command>pecl</command> to be able to handle the compressed package
    files.
   </para>
  </step>
  <step>
   <para>
    Run the following command to download, build, and install the
    latest stable version of PDO:
    <screen>
<![CDATA[
pecl install pdo
]]>
    </screen>
   </para>
  </step>
  <step>
   <para>
    The <command>pecl</command> command automatically installs the
    PDO module into your PHP extensions directory. To enable the
    PDO extension on Linux or Unix operating systems, you must add
    the following line to &php.ini;:
    <screen>
<![CDATA[
extension=pdo.so
]]>
    </screen>
   </para>
   <para>
    For more information about building PECL packages, consult the
    <link linkend="install.pecl">PECL installation</link> section of the manual.
   </para>
  </step>
 </procedure>
 <procedure xml:id='pdo.install.win32php51'>
  <title>Windows users running PHP 5.1.0 and up</title>
  <step>
   <para>
    PDO and all the major drivers ship with PHP as shared extensions, and
    simply need to be activated by editing the &php.ini; file:
    <screen>
<![CDATA[
extension=php_pdo.dll
]]>
    </screen>
   </para>
  </step>
  <step>
   <para>
    Next, choose the other database-specific DLL files and either use 
    <function>dl</function> to load them at runtime, or enable them in
    &php.ini; below <filename>php_pdo.dll</filename>. For example:
    <screen>
<![CDATA[
extension=php_pdo.dll
extension=php_pdo_firebird.dll
extension=php_pdo_informix.dll
extension=php_pdo_mssql.dll
extension=php_pdo_mysql.dll
extension=php_pdo_oci.dll
extension=php_pdo_oci8.dll
extension=php_pdo_odbc.dll
extension=php_pdo_pgsql.dll
extension=php_pdo_sqlite.dll  
]]>
    </screen>
   </para>
   <para>
    These DLLs should exist in the system's 
    <link linkend="ini.extension-dir">extension_dir</link>.
    Note that <link linkend="ref.pdo-informix">PDO_INFORMIX</link>
    is only available as a PECL extension.
   </para>
  </step>
 </procedure>
</section>


<!-- 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
-->