<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/pdo.drivers.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-sqlsrv.php',
    1 => 'PDO-драйвер СУБД MS SQL Server',
    2 => 'PDO_SQLSRV: драйвер модуля PDO для СУБД Microsoft SQL Server',
  ),
  'up' => 
  array (
    0 => 'pdo.drivers.php',
    1 => 'Драйверы модуля PDO',
  ),
  'prev' => 
  array (
    0 => 'pdo-mysql.getwarningcount.php',
    1 => 'Pdo\\Mysql::getWarningCount',
  ),
  'next' => 
  array (
    0 => 'ref.pdo-sqlsrv.connection.php',
    1 => 'DSN-строка подключения через драйвер PDO_SQLSRV',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/pdo_sqlsrv/reference.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/ref.pdo-sqlsrv.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ref.pdo-sqlsrv" class="reference">
 
 <h1 class="title">PDO_SQLSRV: драйвер модуля PDO для СУБД Microsoft SQL Server</h1>
 
 <div class="partintro">

  <div class="section" id="pdo-sqlsrv.intro">
   <h2 class="title">Введение</h2>
   <p class="simpara">
    PDO_SQLSRV — драйвер, через который PHP получает доступ к базам данных
    MS SQL Server (начиная с версии SQL Server 2005) и SQL Azure.
    Для этого драйвер реализует интерфейс модуля <a href="book.pdo.php#intro.pdo" class="link">PDO</a>.
   </p>
  </div>
  


<div class="section" id="ref.pdo-sqlsrv.installation">
 <h2 class="title">Установка</h2>
 <p class="simpara">
  Последняя версия драйвера доступна для скачивания по ссылке:
  <a href="http://msdn.microsoft.com/en-us/sqlserver/ff657782.aspx" class="link external">&raquo;&nbsp;Загрузка SQLSRV</a>.
  Исходный код драйвера размещён в <a href="https://github.com/microsoft/msphpsql" class="link external">&raquo;&nbsp;публичном репозитории</a>.
 </p>
 <p class="simpara">
  За подробностями о системных требованиях обратитесь к разделу
  <a href="http://msdn.microsoft.com/en-us/library/cc296170.aspx" class="link external">&raquo;&nbsp;Системные требования SQLSRV</a>.
 </p>
 <p class="simpara">
  В Windows модуль PDO_SQLSRV включается путём загрузки и добавления необходимых DLL-файлов
  в каталог модулей PHP и добавления в файл <var class="filename">php.ini</var> записи, которая загрузит модуль.
 </p>
 <p class="simpara">
  В Linux и macOS модуль PDO_SQLSRV можно установить из библиотеки <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a>.
  Подробности смотрите в <a href="https://docs.microsoft.com/en-us/sql/connect/php/installation-tutorial-linux-mac" class="link external">&raquo;&nbsp;руководстве по установке</a>.
 </p>
</div>


  


<div class="section" id="pdo-sqlsrv.constants">
 <h2 class="title">Предопределённые константы</h2>
 <p class="simpara">Драйвер
определяет следующие константы и открывает доступ к ним только тогда, когда PHP собрали
с поддержкой этого модуля, или модуль динамически загрузили при выполнении кода.
Константы, которые зависят от драйвера, разрешается использовать только совместно с драйвером.
Атрибуты одного драйвера с другим драйвером ведут себя неожиданно. Чтобы проверить название
драйвера, которое содержит атрибут <strong><code><a href="pdo.constants.php#pdo.constants.attr-driver-name">PDO::ATTR_DRIVER_NAME</a></code></strong>, вызывают
метод <span class="function"><a href="pdo.getattribute.php" class="function">PDO::getAttribute()</a></span>, если код запускается с несколькими драйверами.</p>
 <dl>
  
   <dt id="pdo.constants.sqlsrv-txn-read-uncommitted">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-read-uncommitted">PDO::SQLSRV_TXN_READ_UNCOMMITTED</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Данная константа - допустимое значение для ключа TransactionIsolation SQLSRV DSN.
     Устанавливает уровень изоляции транзакций для соединения в значение Read Uncommitted.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-txn-read-committed">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-read-committed">PDO::SQLSRV_TXN_READ_COMMITTED</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Данная константа - допустимое значение для ключа TransactionIsolation SQLSRV DSN.
     Устанавливает уровень изоляции транзакций для соединения в значение Read Committed.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-txn-repeatable-read">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-repeatable-read">PDO::SQLSRV_TXN_REPEATABLE_READ</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Данная константа - допустимое значение для ключа TransactionIsolation SQLSRV DSN.
     Устанавливает уровень изоляции транзакций для соединения в значение Repeateable Read.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-txn-snapshot">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-snapshot">PDO::SQLSRV_TXN_SNAPSHOT</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Данная константа - допустимое значение для ключа TransactionIsolation SQLSRV DSN.
     Устанавливает уровень изоляции транзакций для соединения в значение Snapshot.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-txn-serializable">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-serializable">PDO::SQLSRV_TXN_SERIALIZABLE</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Данная константа - допустимое значение для ключа TransactionIsolation SQLSRV DSN.
     Устанавливает уровень изоляции транзакций для соединения в значение Serializable.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-encoding-binary">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-encoding-binary">PDO::SQLSRV_ENCODING_BINARY</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Определяет, что данные отправляются/получаются в виде потока байтов к/от сервера
     без выполнения преобразования кодировки или другого преобразования. Константа может
     быть передана в функции PDOStatement::setAttribute, PDO::prepare,
     PDOStatement::bindColumn и PDOStatement::bindParam.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-encoding-system">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-encoding-system">PDO::SQLSRV_ENCODING_SYSTEM</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Определяет, что данные отправляются/получаются к/от сервера в
     8ми-битной кодировке локали Windows, установленной в системе.
     Все мультибайтовые символы и символы, не преобразуемые в данную кодировку, заменяются
     символом вопроса (?). Константа может
     быть передана в функции PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare,
     PDOStatement::bindColumn и PDOStatement::bindParam.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-encoding-utf8">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-encoding-utf8">PDO::SQLSRV_ENCODING_UTF8</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Определяет, что данные отправляются/получаются к/от сервера в кодировке
     UTF-8. Константа может быть передана в функции
     PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare,
     PDOStatement::bindColumn и PDOStatement::bindParam.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-encoding-default">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-encoding-default">PDO::SQLSRV_ENCODING_DEFAULT</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Определяет, что данные отправляются/получаются к/от сервера согласно
     значению PDO::SQLSRV_ENCODING_SYSTEM, указанному при подключении. Для подключения
     может использоваться кодировка, указанная при подготовке выражения.
     Константа может быть передана в функции PDOStatement::setAttribute,
     PDO::setAttribute, PDO::prepare, PDOStatement::bindColumn и PDOStatement::bindParam.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-attr-query-timeout">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-attr-query-timeout">PDO::SQLSRV_ATTR_QUERY_TIMEOUT</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Неотрицательное целое число, отражающее время ожидания в секундах. Ноль (0) -
     это значение по умолчанию, означающее, что время ожидания не учитывается.
     Константа может быть передана в функции
     PDOStatement::setAttribute, PDO::setAttribute и PDO::prepare.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-attr-direct-query">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-attr-direct-query">PDO::SQLSRV_ATTR_DIRECT_QUERY</a></code></strong>
    (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Показывает, что запрос должен быть немедленно выполнен, без подготовки выражения.
     Константа может быть передана в функции PDO::setAttribute и PDO::prepare.
     За подробностями обратитесь к разделу документации
     <a href="http://msdn.microsoft.com/en-us/library/ff754356.aspx" class="link external">&raquo;&nbsp;Немедленное выполнение выражений и выполнение подготовленных выражений</a>.
    </span>
   </dd>
  
 </dl>
</div>


 </div>

 

<h2>Содержание</h2><ul class="chunklist chunklist_reference"><li><a href="ref.pdo-sqlsrv.connection.php">DSN-строка подключения через драйвер PDO_SQLSRV</a> — Подключение к базам данных MS SQL Server и SQL Azure</li></ul>
</div>
<?php manual_footer($setup); ?>