/
reference.xml
136 lines (127 loc) · 4.17 KB
/
reference.xml
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
<?xml version="1.0" encoding="utf-8"?>
<reference xml:id="ref.pdo-informix" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<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>DSN</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
-->