File: reference.xml

package info (click to toggle)
php-doc 20100521-2
  • links: PTS, VCS
  • area: main
  • in suites: squeeze, wheezy
  • size: 59,992 kB
  • ctags: 4,085
  • sloc: xml: 796,833; php: 21,338; cpp: 500; sh: 117; makefile: 58; awk: 28
file content (139 lines) | stat: -rw-r--r-- 4,346 bytes parent folder | download
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
-->