cvs: phpdoc /en/reference/pdo configure.xml reference.xml

vrana Wed Apr 26 12:20:23 2006 UTC Added files: /phpdoc/en/reference/pdo configure.xml Modified files: /phpdoc/en/reference/pdo reference.xml Log: Separate installation

http://cvs.php.net/viewcvs.cgi/phpdoc/en/reference/pdo/reference.xml?r1=1.51&r2=1.52&diff_format=u Index: phpdoc/en/reference/pdo/reference.xml diff -u phpdoc/en/reference/pdo/reference.xml:1.51 phpdoc/en/reference/pdo/reference.xml:1.52 --- phpdoc/en/reference/pdo/reference.xml:1.51 Fri Apr 14 09:15:53 2006 +++ phpdoc/en/reference/pdo/reference.xml Wed Apr 26 12:20:23 2006 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.51 $ --> +<!-- $Revision: 1.52 $ --> <!-- Purpose: database.abstract --> <!-- Membership: pecl, bundled --> @@ -33,140 +33,8 @@ run with earlier versions of PHP. </para> </section> - <section id="pdo.installation"> - &reftitle.install; - <procedure 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 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 pear 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. - <screen> -<![CDATA[ - ./configure --with-zlib --enable-pdo=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>pear - 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 id='pdo.install.pecl'> - <title>PHP 5.0 and up on Unix systems</title> - <step> - <para> - PDO is available as a PECL extension from - <ulink url='&url.pecl.package;pdo'>&url.pecl.package;pdo</ulink>. - Installation can be performed via the <command>pear</command> tool; this - is enabled by default when you configure PHP. You should ensure that - PHP was configured --with-zlib in order for - <command>pear</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[ -pear install pdo -]]> - </screen> - </para> - </step> - <step> - <para> - The <command>pear</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 id='pdo.install.win32php51'> - <title>Windows users running PHP 5.1 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> + + &reference.pdo.configure; &reference.pdo.ini; http://cvs.php.net/viewcvs.cgi/phpdoc/en/reference/pdo/configure.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/pdo/configure.xml +++ phpdoc/en/reference/pdo/configure.xml <section id="pdo.installation"> &reftitle.install; <procedure 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 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 pear 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. <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 extension=pdo_sqlite.so extension=sqlite.so ]]> </screen> </para> </step> <step> <para> Having PDO as a shared module will allow you to run <command>pear 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 id='pdo.install.pecl'> <title>PHP 5.0 and up on Unix systems</title> <step> <para> PDO is available as a PECL extension from <ulink url='&url.pecl.package;pdo'>&url.pecl.package;pdo</ulink>. Installation can be performed via the <command>pear</command> tool; this is enabled by default when you configure PHP. You should ensure that PHP was configured --with-zlib in order for <command>pear</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[ pear install pdo ]]> </screen> </para> </step> <step> <para> The <command>pear</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 id='pdo.install.win32php51'> <title>Windows users running PHP 5.1 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>