dbs Mon Sep 26 17:15:29 2005 EDT
Added files:
/phpdoc/en/reference/pdo_odbc configure.xml
Modified files:
/phpdoc/en/reference/pdo_odbc reference.xml
Log:
Add configuration stubs for PDO_ODBC (UNIX only to begin with).
http://cvs.php.net/diff.php/phpdoc/en/reference/pdo_odbc/reference.xml?r1=1.7&r2=1.8&ty=u
Index: phpdoc/en/reference/pdo_odbc/reference.xml
diff -u phpdoc/en/reference/pdo_odbc/reference.xml:1.7
phpdoc/en/reference/pdo_odbc/reference.xml:1.8
--- phpdoc/en/reference/pdo_odbc/reference.xml:1.7 Mon Sep 19 10:23:10 2005
+++ phpdoc/en/reference/pdo_odbc/reference.xml Mon Sep 26 17:15:29 2005
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
<!-- Purpose: database.vendors -->
<!-- Membership: bundled, external, pecl -->
@@ -11,11 +11,40 @@
<section id="pdo-odbc.intro">
&reftitle.intro;
<para>
- &warn.experimental;
PDO_ODBC is a driver that implements the <link linkend="ref.pdo">PHP Data
Objects (PDO) interface</link>
to enable access from PHP to databases through ODBC drivers or through the
- IBM DB2 Call Level Interface (DB2 CLI) library.
+ IBM DB2 Call Level Interface (DB2 CLI) library. PDO_ODBC currently
supports
+ three different "flavours" of database drivers:
+ <variablelist>
+ <varlistentry>
+ <term>ibm-db2</term>
+ <listitem>
+ <para>
+ Supports access to IBM DB2 Universal Database, Cloudscape, and Apache
+ Derby servers through the free DB2 client.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>unixODBC</term>
+ <listitem>
+ <para>
+ Supports access to database servers through the unixODBC driver
+ manager and the database's own ODBC drivers.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>generic</term>
+ <listitem>
+ <para>
+ Offers a compile option for ODBC driver managers that are not
+ explicitly supported by PDO_ODBC.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
<para>
On Windows, PDO_ODBC is built into the PHP core by default. It is linked
@@ -24,6 +53,10 @@
connecting to Microsoft SQL Server databases.
</para>
</section>
+
+ <!-- Information found in configure.xml -->
+ &reference.pdo-odbc.configure;
+ <!-- Information found in ini.xml -->
&reference.pdo-odbc.ini;
</partintro>
http://cvs.php.net/co.php/phpdoc/en/reference/pdo_odbc/configure.xml?r=1.1&p=1
Index: phpdoc/en/reference/pdo_odbc/configure.xml
+++ phpdoc/en/reference/pdo_odbc/configure.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<section id="ref.pdo-odbc.installation">
&reftitle.install;
<procedure id="ref.pdo-odbc.install.unix">
<title>PDO_ODBC on UNIX systems</title>
<step>
<para>
As of PHP 5.1, PDO_ODBC is included in the PHP source. You can compile the
PDO_ODBC extension as either a static or shared module using the following
<command>configure</command> commands.
<variablelist>
<varlistentry>
<term>ibm_db2</term>
<listitem>
<para>
<screen><![CDATA[../configure
--enable-pdo_odbc=ibm-db2,/opt/IBM/db2/V8.1/
]]></screen>
To build PDO_ODBC with the ibm-db2 flavour, you have to have
previously installed the DB2 application development headers on the
same machine on which you are compiling PDO_ODBC. The DB2 application
development headers are an installable option in the DB2 servers, and
are also available as part of the DB2 Application Development Client
freely available for download from the IBM DB2 Universal Database
<ulink url="&url.ibm.db2.client;">support site</ulink>.
</para>
<para>
If you do not supply a location for the DB2 libraries and headers to
the <command>configure</command> command, PDO_ODBC defaults to
<filename class="directory">/home/db2inst1/sqllib</filename>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>unixODBC</term>
<listitem>
<para>
<screen><![CDATA[../configure --enable-pdo_odbc=unixODBC,/usr/local
]]></screen>
If you do not supply a location for the unixODBC libraries and
headers to the <command>configure</command> command, PDO_ODBC
defaults to <filename class="directory">/usr/local</filename>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>generic</term>
<listitem>
<screen><![CDATA[../configure
--enable-pdo_odbc=generic,/usr/local,libname,ldflags,cflags
]]></screen>
</listitem>
</varlistentry>
</variablelist>
</para>
</step>
</procedure>
</section>
