1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139
|
<?xml version='1.0' encoding="utf-8"?>
<!-- $Revision: 297078 $ -->
<!-- Purpose: database.vendors -->
<!-- Membership: external, pecl -->
<reference xml:id="ref.pdo-informix" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Informix Functions (PDO_INFORMIX)</title>
<titleabbrev>Informix (PDO)</titleabbrev>
<partintro>
<section xml:id="pdo-informix.intro">
&reftitle.intro;
<para>
PDO_INFORMIX is a driver that implements the <link linkend="intro.pdo">PHP Data
Objects (PDO)</link> interface to enable access from PHP to Informix databases.
</para>
</section>
<!-- Information found in configure.xml -->
&reference.pdo-informix.configure;
<section xml:id="ref.pdo-informix.features.cursors">
<title>Scrollable cursors</title>
<para>
PDO_INFORMIX supports scrollable cursors; however, they are not enabled
by default. To enable scrollable cursor support, you must either set
<userinput>ENABLESCROLLABLECURSORS=1</userinput> in the corresponding ODBC
connection settings in <filename>odbc.ini</filename> or pass
the <userinput>EnableScrollableCursors=1</userinput> clause in the DSN
connection string.
</para>
</section>
</partintro>
<refentry xml:id="ref.pdo-informix.connection">
<refnamediv>
<refname>PDO_INFORMIX DSN</refname>
<refpurpose>Connecting to Informix databases</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>
The PDO_INFORMIX Data Source Name (DSN) is based on the Informix ODBC DSN
string. Details on configuring an Informix ODBC DSN are available from
the <link xlink:href="&url.informix.dsn;">Informix Dynamic Server Information
Center</link>. The major components of the PDO_INFORMIX DSN are:
<variablelist>
<varlistentry>
<term>DSN prefix</term>
<listitem>
<para>
The DSN prefix is <userinput>informix:</userinput>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>DSN</constant></term>
<listitem>
<para>
The DSN can be either a data source setup using
<filename>odbc.ini</filename> or a complete <link
xlink:href="&url.informix.connectionstring;">connection string</link>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>PDO_INFORMIX DSN example using <filename>odbc.ini</filename></title>
<para>
The following example shows a PDO_INFORMIX DSN for connecting to
an Informix database cataloged as Infdrv33 in
<filename>odbc.ini</filename>:
<programlisting><![CDATA[
$db = new PDO("informix:DSN=Infdrv33", "", "");
]]></programlisting>
<programlisting><![CDATA[
[ODBC Data Sources]
Infdrv33=INFORMIX 3.3 32-BIT
[Infdrv33]
Driver=/opt/informix/csdk_2.81.UC1G2/lib/cli/iclis09b.so
Description=INFORMIX 3.3 32-BIT
Database=common_db
LogonID=testuser
pwd=testpass
Servername=ids_server
DB_LOCALE=en_US.819
OPTIMIZEAUTOCOMMIT=1
ENABLESCROLLABLECURSORS=1
]]></programlisting>
</para>
</example>
<example>
<title>PDO_INFORMIX DSN example using a connection string</title>
<para>
The following example shows a PDO_INFORMIX DSN for connecting to
an Informix database named <userinput>common_db</userinput> using the
Informix connection string syntax.
<programlisting><![CDATA[
$db = new PDO("informix:host=host.domain.com; service=9800;
database=common_db; server=ids_server; protocol=onsoctcp;
EnableScrollableCursors=1", "testuser", "tespass");
]]>
</programlisting>
</para>
</example>
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
|