reference.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f43157bcb645cbd16083ce6b408649dcafa5a209 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<reference xmlns="http://docbook.org/ns/docbook" xml:id="ref.pdo-sqlsrv">
 <?phpdoc extension-membership="pecl" ?>
 <title>PDO_SQLSRV: драйвер модуля PDO для СУБД Microsoft SQL Server</title>
 <titleabbrev>PDO-драйвер СУБД MS SQL Server</titleabbrev>
 <partintro>

  <section xml:id="pdo-sqlsrv.intro">
   &reftitle.intro;
   <simpara>
    PDO_SQLSRV — драйвер, через который PHP получает доступ к базам данных
    MS SQL Server (начиная с версии SQL Server 2005) и SQL Azure.
    Для этого драйвер реализует интерфейс модуля <link linkend="intro.pdo">PDO</link>.
   </simpara>
  </section>
  &reference.pdo-sqlsrv.configure;
  &reference.pdo-sqlsrv.constants;
 </partintro>

 <refentry xml:id="ref.pdo-sqlsrv.connection">
  <refnamediv>
   <refname>DSN-строка подключения через драйвер PDO_SQLSRV</refname>
   <refpurpose>Подключение к базам данных MS SQL Server и SQL Azure</refpurpose>
  </refnamediv>

  <refsect1 role="description">
   &reftitle.description;
   <para>
    DSN-строка подключения (англ. сокр.: Data Source Name — имя и��точника данных)
    для драйвера PDO_SQLSRV состоит из следующих элементов:
    <variablelist>
     <varlistentry>
      <term>DSN-префикс</term>
      <listitem>
       <para>
        DSN-префикс — строка <userinput>sqlsrv:</userinput>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>APP</literal></term>
      <listitem>
       <simpara>
        Имя приложения для трассировки.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>ConnectionPooling</literal></term>
      <listitem>
       <simpara>
        Определяет, назначается ли соединение из пула соединений:
        1 или &true;, если да, 0 или &false;, если нет.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>Database</literal></term>
      <listitem>
       <simpara>
        Название базы данных.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>Encrypt</literal></term>
      <listitem>
       <simpara>
        Определяет, шифруются ли соединение с SQL Server:
        1 или &true;, если да, 0 или &false;, если нет.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>Failover_Partner</literal></term>
      <listitem>
       <simpara>
        Определяет сервер и экземпляр зеркала базы данных (если включили и настроили)
        при недоступности первичного сервера.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>LoginTimeout</literal></term>
      <listitem>
       <simpara>
        Время ожидания подключения в секундах.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>MultipleActiveResultSets</literal></term>
      <listitem>
       <simpara>
        Отключает или явно включает режим MARS (англ. сокр.: Multiple Active Result Sets),
        который поддерживает множественные активные результирующие наборы.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>QuotedId</literal></term>
      <listitem>
       <simpara>
        Определяет, применять ли к идентификаторам в кавычках
        правила стандарта SQL-92: 1 или &true;, или применять устаревшие
        правила стандарта Transact-SQL: 0 или &false;.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>Server</literal></term>
      <listitem>
       <simpara>
        Имя сервера базы данных.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>TraceFile</literal></term>
      <listitem>
       <simpara>
        Путь до файла для данных трассировки.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>TraceOn</literal></term>
      <listitem>
       <simpara>
        Определяет, включается ли для соединения, которое устанавливает драйвер,
        функция ODBC-трассировки: 1 или &true;, если да, 0 или &false;, если нет.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>TransactionIsolation</literal></term>
      <listitem>
       <simpara>
        Уровень изоляции транзакций. Опция принимает следующие значения:
        PDO::SQLSRV_TXN_READ_UNCOMMITTED, PDO::SQLSRV_TXN_READ_COMMITTED,
        PDO::SQLSRV_TXN_REPEATABLE_READ, PDO::SQLSRV_TXN_SNAPSHOT
        и PDO::SQLSRV_TXN_SERIALIZABLE.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>TrustServerCertificate</literal></term>
      <listitem>
       <simpara>
        Определяет, должен ли клиент доверять или отклонять
        самоподписанный сертификат сервера: 1 или &true;, если да,
        0 или &false;, если нет.
       </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>WSID</literal></term>
      <listitem>
       <simpara>
        Имя компьютера для трассировки.
       </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>

  <refsect1 role="examples">
   &reftitle.examples;
   <example>
    <title>Примеры DSN-строки подключения через драйвер PDO_SQLSRV</title>
    <para>
     Следующий пример показывает, как подключаться к конкретной базе данных MS SQL Server:
     <programlisting>
<![CDATA[
$c = new PDO("sqlsrv:Server=localhost;Database=testdb", "UserName", "Password");
]]>
     </programlisting>
    </para>
    <para>
     Следующий пример показывает, как подключаться к базе данных MS SQL Server
     на конкретном порте:
     <programlisting>
<![CDATA[
$c = new PDO("sqlsrv:Server=localhost,1521;Database=testdb", "UserName", "Password");
]]>
     </programlisting>
    </para>
    <para>
     Следующий пример показывает, как подключаться к базе данных SQL Azure с идентификатором
     сервера 12345abcde. Примечание: при соединении к БД SQL Azure через модуль PDO
     имя пользователя будет равно UserName@12345abcde (UserName@ServerId).
     <programlisting>
<![CDATA[
$c = new PDO("sqlsrv:Server=12345abcde.database.windows.net;Database=testdb", "UserName@12345abcde", "Password");
]]>
     </programlisting>
    </para>
   </example>
  </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
-->