svn: /phpdoc/en/trunk/reference/pdo/ configure.xml

bjori Mon, 03 Aug 2009 11:41:53 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=286728 Log: - Installing PDO from PECL is in no way the recommended way. - Recommend statically building PDO - Fixes PECL bug#16758 Bug: http://pecl.php.net/bugs/16758 (unknown) Changed paths: U phpdoc/en/trunk/reference/pdo/configure.xml Modified: phpdoc/en/trunk/reference/pdo/configure.xml =================================================================== --- phpdoc/en/trunk/reference/pdo/configure.xml 2009-08-03 11:34:56 UTC (rev 286727) +++ phpdoc/en/trunk/reference/pdo/configure.xml 2009-08-03 11:41:53 UTC (rev 286728) @@ -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 @@ </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 @@ <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>