From 468080ae0a7d16b9a80ed784c362eaf0114eb937 Mon Sep 17 00:00:00 2001 From: Wez Furlong Date: Fri, 9 Sep 2005 03:00:46 +0000 Subject: [PATCH] revise install instructions git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@195552 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/pdo/reference.xml | 184 +++++++++++++++++------------------- 1 file changed, 85 insertions(+), 99 deletions(-) diff --git a/reference/pdo/reference.xml b/reference/pdo/reference.xml index a81ab216b1..433a6fcb06 100644 --- a/reference/pdo/reference.xml +++ b/reference/pdo/reference.xml @@ -1,5 +1,5 @@ - + @@ -21,59 +21,101 @@ itself; you must use a database-specific PDO driver to access a database server. + + PDO ships with PHP 5.1, and is available as a PECL extension for PHP 5.0; + PDO requires the new OO features in the core of PHP 5, and so will not + run with earlier versions of PHP. +
&reftitle.install; - - - - Windows - - Follow the same steps to install and enable the PDO drivers of your - choice. + + + Having PDO as a shared module will allow you to run pear + 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 and up on Unix systems + + PDO is available as a PECL extension from + &url.pecl.package;pdo. + Installation can be performed via the pear tool; this + is enabled by default when you configure PHP. You should ensure that + PHP was configured --with-zlib in order for + pear to be able to handle the compressed package + files. + + + Run the following command to download, build, and install the + latest stable version of PDO: + + + + + + If PDO is still in beta (and at the time of writing, it is), you will + need to tell the pear tool that it's ok to fetch the beta package. + Instead of running the command above, run the following: + + + + + + The pear 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;: + + + + + + + Windows users running PHP 5.1 and up - Windows users can download the extension DLL php_pdo.dll - as part of the PECL collection binaries from - &url.php.downloads; or a more - recent version from a PHP 5 PECL - Snapshot. - - - - - To enable the PDO extension on Windows operating systems, you must - add the following line to &php.ini;: + PDO and all the major drivers ship with PHP as shared extensions, and + simply need to be activated by editing the &php.ini; file: - - Linux and UNIX - - Due to a bug in the pear installer you should install - the PDO package manually using the following steps: - - - Follow the same steps to install and enable the PDO drivers of your - choice. E.g. for MySQL driver, replace PDO with PDO_MYSQL in the - following instructions. - - - Download the PDO package to your local machine: - - - - - - - - Determine your PHP bin directory. If your - PHP 5 CLI binary lives at /usr/local/php5/bin/php - then the bin dir is /usr/local/php5/bin. - - - - - Set your path so that your PHP bin directory - is at the front: - - - - - - - - Manually build and install the PDO extension: - -> /usr/local/php5/lib/php.ini -]]> - - - -
&reference.pdo.ini;