- Installing PDO from PECL is in no way the recommended way.

- Recommend statically building PDO
- Fixes PECL bug#16758



git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@286728 c90b9560-bf6c-de11-be94-00142212c4b1

reference/pdo/configure.xml

@@ -3,34 +3,24 @@
 <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>
+  <title>Installing PDO 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
+    PDO and the <link linkend="ref.pdo-sqlite">PDO_SQLITE</link> driver
+    is enabled by default as of PHP 5.1.0. You may 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>
+    documentation for
+    <link linkend="pdo.drivers">database-specific PDO drivers</link>
+    to find out more about that.
+    Note: When building PDO as a shared extension (<emphasis>not
+     recommended</emphasis>) then all PDO drivers <emphasis>must</emphasis>
+    and loaded <literal>after</literal> PDO itself.
    </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.
+    When installing PDO as a shared module, the php.ini file needs to be
+    updated 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.
@@ -43,60 +33,9 @@ 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>
+  <title>Windows users</title>
   <step>
    <para>
     PDO and all the major drivers ship with PHP as shared extensions, and
@@ -131,8 +70,6 @@ extension=php_pdo_sqlite.dll
    <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>