-
Notifications
You must be signed in to change notification settings - Fork 72
/
reference.xml
177 lines (170 loc) · 7.32 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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4157259e8920fb618d5d23cb214950893d1c8931 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="ref.pdo-odbc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundledexternal" ?>
<title>Функции ODBC и DB2 (PDO_ODBC)</title>
<titleabbrev>ODBC и DB2 (PDO)</titleabbrev>
<partintro>
<section xml:id="pdo-odbc.intro">
&reftitle.intro;
<para>
PDO_ODBC — драйвер, который реализует <link linkend="intro.pdo">интерфейс PHP
Data Objects (PDO)</link> для доступа из PHP к базам данных через драйверы ODBC или
через библиотеку IBM DB2 Call Level Interface (DB2 CLI). Драйвер PDO_ODBC
поддерживает три «оттенка» драйверов баз данных:
<variablelist>
<varlistentry>
<term>ibm-db2</term>
<listitem>
<para>
Драйвер поддерживает доступ к серверам IBM DB2 Universal Database, Cloudscape и Apache
Derby через свободный клиент DB2 express-C.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>unixODBC</term>
<listitem>
<para>
Драйвер поддерживает доступ к базам данных через менеджер драйверов unixODBC
и собственные ODBC-драйверы баз данных.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>generic</term>
<listitem>
<para>
Драйвер предлагает ODBC опцию компиляции для менеджеров драйверов, которые
PDO_ODBC не поддерживает явно.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
В операционной системе Windows библиотеку <filename>php_pdo_odbc.dll</filename> включают как
модуль в файле &php.ini;. Библиотека связана с диспетчером драйверов Windows ODBC Driver Manager,
поэтому PHP доступны подключения к любой базе данных, которую занесли в каталог
как системное имя источника данных System DSN.
</para>
</section>
<!-- Information found in configure.xml -->
&reference.pdo-odbc.configure;
<!-- Information found in constants.xml -->
&reference.pdo-odbc.constants;
<!-- Information found in ini.xml -->
&reference.pdo-odbc.ini;
</partintro>
<refentry xml:id="ref.pdo-odbc.connection">
<refnamediv>
<refname>PDO_ODBC DSN</refname>
<refpurpose>Соединение с базами данных ODBC или DB2</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>
Имя источника данных (Data Source Name, DSN) драйвера PDO_ODBC состоит из следующих
элементов:
<variablelist>
<varlistentry>
<term>Префикс DSN</term>
<listitem>
<para>
Запись вида <userinput>odbc:</userinput> — префикс DSN. При подключении к базе,
которую указали в каталоге менеджера драйверов ODBC или каталоге DB2, можно
добавить имя из этого каталога к DSN.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>DSN</term>
<listitem>
<para>
Имя базы данных как указано в каталоге менеджера драйверов ODBC или
в каталоге DB2. Также можно указать полную строку соединения ODBC,
как описано по ссылке <link xlink:href="&url.connectionstrings;">&url.connectionstrings;</link>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>UID</literal></term>
<listitem>
<para>
Имя пользователя для соединения. Если имя пользователя указывают в DSN-строке,
модуль PDO будет игнорировать имя, которое задали аргументом в конструкторе PDO.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>PWD</literal></term>
<listitem>
<para>
Пароль пользователя для соединения. Если пароль пользователя указывают в DSN-строке,
модуль PDO будет игнорировать пароль, который задали аргументом в конструкторе PDO.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример PDO_ODBC DSN (менеджер драйверов ODBC)</title>
<para>
Следующий пример показывает DSN-имя драйвера PDO_ODBC для соединения
с базой данных, которая определена в диспетчере драйверов ODBC как testdb:
</para>
<programlisting><![CDATA[
odbc:testdb
]]>
</programlisting>
</example>
<example>
<title>Пример DSN-имени драйвера PDO_ODBC (некаталогизированное соединение IBM DB2)</title>
<para>
Следующий пример показывает синтаксис полного DSN-имени драйвера PDO_ODBC для соединения
с базой данных IBM DB2 с именем <userinput>SAMPLE</userinput>:
</para>
<programlisting><![CDATA[
odbc:DRIVER={IBM DB2 ODBC DRIVER};HOSTNAME=localhost;PORT=50000;DATABASE=SAMPLE;PROTOCOL=TCPIP;UID=db2inst1;PWD=ibmdb2;
]]>
</programlisting>
</example>
<example>
<title>Пример DSN-имени драйвера PDO_ODBC (некаталогизированное соединение Microsoft Access)</title>
<para>
Следующий пример показывает синтаксис полного DSN-имени драйвера PDO_ODBC для соединения
с базой Microsoft Access, которая хранится в файле <userinput>C:\db.mdb</userinput>:
</para>
<programlisting><![CDATA[
odbc:Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\\db.mdb;Uid=Admin
]]>
</programlisting>
</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
-->