<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.pdo-odbc.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-odbc.connection.php',
    1 => 'DSN-строка подключения через драйвер PDO_ODBC',
    2 => 'Соединение с базами данных ODBC или DB2',
  ),
  'up' => 
  array (
    0 => 'ref.pdo-odbc.php',
    1 => 'PDO-драйвер СУБД ODBC и DB2',
  ),
  'prev' => 
  array (
    0 => 'ref.pdo-odbc.php',
    1 => 'PDO-драйвер СУБД ODBC и DB2',
  ),
  'next' => 
  array (
    0 => 'class.pdo-odbc.php',
    1 => 'Pdo\\Odbc',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/pdo_odbc/reference.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ref.pdo-odbc.connection" class="refentry">
  <div class="refnamediv">
   <h1 class="refname">DSN-строка подключения через драйвер PDO_ODBC</h1>
   <p class="verinfo">(No version information available, might only be in Git)</p><p class="refpurpose"><span class="refname">DSN-строка подключения через драйвер PDO_ODBC</span> &mdash; <span class="dc-title">Соединение с базами данных ODBC или DB2</span></p>

  </div>

  <div class="refsect1 description" id="refsect1-ref.pdo-odbc.connection-description">
   <h3 class="title">Описание</h3>
   <p class="para">
    DSN-строка подключения (англ. сокр.: Data Source Name — имя источника данных)
    через драйвер PDO_ODBC состоит из следующих элементов:
    <dl>
     
      <dt>DSN-префикс</dt>
      <dd>
       <p class="para">
        DSN-префикс — строка <strong class="userinput"><code>odbc:</code></strong>. При подключении к базе данных,
        которую указали в каталоге менеджера ODBC-драйверов или в каталоге БД DB2,
        разрешается добавить к DSN-строке подключения имя из этого каталога.
       </p>
      </dd>
     
     
      <dt>DSN</dt>
      <dd>
       <p class="para">
        Имя базы данных, как каталогизировали в диспетчере ODBC-драйверов
        или каталоге DB2. Как альтернативу указывают полную строку подключения к БД ODBC,
        как описывает сайт <a href="http://www.connectionstrings.com/" class="link external">&raquo;&nbsp;http://www.connectionstrings.com/</a>.
       </p>
      </dd>
     
     
      <dt><code class="literal">UID</code></dt>
      <dd>
       <p class="para">
        Имя пользователя для соединения. Модуль PDO проигнорирует значение,
        которое передали как аргумент конструктора, если указать имя пользователя в DSN-имени.
       </p>
      </dd>
     
     
      <dt><code class="literal">PWD</code></dt>
      <dd>
       <p class="para">
        Пароль пользователя для соединения. Модуль PDO проигнорирует значение,
        которое передали как аргумент конструктора, если задать пароль в DSN-имени.
       </p>
      </dd>
     
    </dl>
   </p>
  </div>


  <div class="refsect1 changelog" id="refsect1-ref.pdo-odbc.connection-changelog">
   <h3 class="title">Список изменений</h3>
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Версия</th>
       <th>Описание</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>8.4.0</td>
       <td>
        При передаче пустой строки (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>) в качестве аргумента password в конструкторе PDO,
        <code class="literal">pwd</code> не передавался в создаваемую строку подключения,
        такое поведение было изменено и теперь значение передается в качестве пустой строки.
        Передача <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> в качестве аргумента password в конструкторе PDO приводит к тому же поведению, что и раньше.
       </td>
      </tr>

      <tr>
       <td>8.4.0</td>
       <td>
        Изменено поведение, чтобы игнорировать аргумент имени пользователя и аргумент пароля в конструкторе PDO отдельно,
        когда DSN содержит <code class="literal">uid</code> или <code class="literal">pwd</code>.
        Ранее, если в DSN был передан только <code class="literal">uid</code> или <code class="literal">pwd</code>,
        аргумент имени пользователя и аргумент пароля в конструкторе PDO игнорировались.
       </td>
      </tr>

     </tbody>
    
   </table>

  </div>


  <div class="refsect1 examples" id="refsect1-ref.pdo-odbc.connection-examples">
   <h3 class="title">Примеры</h3>
   <p class="para">
    <div class="example" id="example-1">
     <p><strong>Пример #1 Пример DSN-строки подключения через драйвер PDO_ODBC для диспетчера ODBC-драйверов</strong></p>
     <div class="example-contents"><p>
      Следующий пример показывает DSN-строку подключения через драйвер PDO_ODBC,
      чтобы установить соединение с базой данных, которую определили
      в диспетчере ODBC-драйверов как testdb:
     </p></div>
<div class="example-contents"><div class="cdata"><pre>
odbc:testdb
</pre></div>
      </div>

     </div>
     <div class="example" id="example-2">
      <p><strong>Пример #2 
       Пример DSN-строки подключения через драйвер PDO_ODBC
       для некаталогизированного соединения с БД IBM DB2
      </strong></p>
      <div class="example-contents"><p>
       Следующий пример показывает синтаксис полной DSN-строки подключения
       через драйвер PDO_ODBC для соединения с базой данных IBM DB2 с именем
       <strong class="userinput"><code>SAMPLE</code></strong>:
      </p></div>
<div class="example-contents"><div class="cdata"><pre>
odbc:DRIVER={IBM DB2 ODBC DRIVER};HOSTNAME=localhost;PORT=50000;DATABASE=SAMPLE;PROTOCOL=TCPIP;UID=db2inst1;PWD=ibmdb2;
</pre></div>
      </div>

     </div>
     <div class="example" id="example-3">
      <p><strong>Пример #3 
       Пример DSN-строки подключения через драйвер PDO_ODBC
       для некаталогизированного соединения с БД Microsoft Access
      </strong></p>
      <div class="example-contents"><p>
       Следующий пример показывает синтаксис полной DSN-строки подключения
       через драйвер PDO_ODBC для соединения с базой данных Microsoft Access,
       которая хранится в файле <strong class="userinput"><code>C:\db.mdb</code></strong>:
      </p></div>
<div class="example-contents"><div class="cdata"><pre>
odbc:Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\\db.mdb;Uid=Admin
</pre></div>
      </div>

     </div>

    </p>
   </div>

 </div><?php manual_footer($setup); ?>