From 039e08fc0bf73de46ae5701a2081d72ed3e1db1b Mon Sep 17 00:00:00 2001 From: Hannes Magnusson Date: Mon, 3 Aug 2009 11:41:53 +0000 Subject: [PATCH] - 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 | 87 +++++-------------------------------- 1 file changed, 12 insertions(+), 75 deletions(-) diff --git a/reference/pdo/configure.xml b/reference/pdo/configure.xml index 7d80a692ed..b6efe35890 100644 --- a/reference/pdo/configure.xml +++ b/reference/pdo/configure.xml @@ -3,34 +3,24 @@
&reftitle.install; - PHP 5.1 and up on Unix systems + Installing PDO on Unix systems - If you're running a PHP 5.1 release, PDO and PDO_SQLITE 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 PDO_SQLITE 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 database-specific - PDO drivers 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. - - - + documentation for + database-specific PDO drivers + to find out more about that. + Note: When building PDO as a shared extension (not + recommended) then all PDO drivers must + and loaded after PDO itself. - 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 - - - Having PDO as a shared module will allow you to run pecl - upgrade pdo 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. - - - - - PHP 5.0.0 and up on Unix systems - - - PDO is available as a PECL extension from - &url.pecl.package;pdo. - Installation can be performed via the pecl tool; this - is enabled by default when you configure PHP. You should ensure that - PHP was configured --with-zlib in order for - pecl to be able to handle the compressed package - files. - - - - - Run the following command to download, build, and install the - latest stable version of PDO: - - - - - - - - The pecl 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;: - - - - - - For more information about building PECL packages, consult the - PECL installation section of the manual. - - - Windows users running PHP 5.1.0 and up + Windows users PDO and all the major drivers ship with PHP as shared extensions, and @@ -131,8 +70,6 @@ extension=php_pdo_sqlite.dll These DLLs should exist in the system's extension_dir. - Note that PDO_INFORMIX - is only available as a PECL extension.