archived-doc-ru/reference/pdo_odbc/reference.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c39225b6dd23f358824f44f5b8c733517b11830b 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>PDO_ODBC: драйвер модуля PDO для СУБД ODBC и DB2</title>
 <titleabbrev>PDO-драйвер СУБД ODBC и DB2</titleabbrev>
 <partintro>

  <section xml:id="ref.pdo-odbc.intro">
   &reftitle.intro;
   <para>
    PDO_ODBC — драйвер, через который PHP получает доступ к базам данных,
    совместимым с драйверами ODBC (англ. сокр.: Open Database Connectivity) или библиотекой
    IBM DB2 Call Level Interface (DB2 CLI).
    Для этого драйвер реализует интерфейс модуля <link linkend="intro.pdo">PDO</link>.
    Драйвер 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>DSN-строка подключения через драйвер PDO_ODBC</refname>
   <refpurpose>Соединение с базами данных ODBC или DB2</refpurpose>
  </refnamediv>

  <refsect1 role="description">
   &reftitle.description;
   <para>
    DSN-строка подключения (англ. сокр.: Data Source Name — имя источника данных)
    через драйвер PDO_ODBC состоит из следующих элементов:
    <variablelist>
     <varlistentry>
      <term>DSN-префикс</term>
      <listitem>
       <para>
        DSN-префикс — строка <userinput>odbc:</userinput>. При подключении к базе данных,
        которую указали в каталоге менеджера 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>
        Имя пользователя для соединения. Модуль PDO проигнорирует значение,
        которое передали как аргумент конструктора, если указать имя пользователя в DSN-имени.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>PWD</literal></term>
      <listitem>
       <para>
        Пароль пользователя для соединения. Модуль PDO проигнорирует значение,
        которое передали как аргумент конструктора, если задать пароль в DSN-имени.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>

  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.4.0</entry>
       <entry>
        При передаче пустой строки (<type>string</type>) в качестве аргумента password в конструкторе PDO,
        <literal>pwd</literal> не передавался в создаваемую строку подключения,
        такое поведение было изменено и теперь значение передается в качестве пустой строки.
        Передача &null; в качестве аргумента password в конструкторе PDO приводит к тому же поведению, что и раньше.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
        Изменено поведение, чтобы игнорировать аргумент имени пользователя и аргумент пароля в конструкторе PDO отдельно,
        когда DSN содержит <literal>uid</literal> или <literal>pwd</literal>.
        Ранее, если в DSN был передан только <literal>uid</literal> или <literal>pwd</literal>,
        аргумент имени пользователя и аргумент пароля в конструкторе PDO игнорировались.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </refsect1>

  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
     <title>Пример DSN-строки подключения через драйвер PDO_ODBC для диспетчера 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
-->