sqlsrv_connect
Создает ресурс подключения и открывает соединение. По умолчанию выполняется попытка установки соединения с использованием проверки подлинности Windows.
Синтаксис
sqlsrv_connect( string $serverName [, array $connectionInfo])
Параметры
$serverName: строка, указывающая имя сервера, с которым устанавливается соединение. В состав этой строки можно включить имя экземпляра (например, "мой_сервер\имя_экземпляра") или номер порта (например, "мой_сервер, 1521"). Полное описание значений, доступных для этого параметра, см. в разделе "Ключевые слова в строке подключения драйвера ODBC" статьи Использование ключевых слов строки подключения с SQL Native Client.
Начиная с версии 3.0 драйверов Майкрософт для PHP для SQL Server, можно также указать экземпляр LocalDB с "(localdb)\instancename". Дополнительные сведения о поддержке LocalDB см. в этой статье.
Кроме того, начиная с версии 3.0 Драйверы Microsoft SQL Server для PHP, можно указать имя виртуальной сети для подключения к группе доступности AlwaysOn. Дополнительные сведения о поддержке групп доступности Always On в драйверах PHP Microsoft для SQL Server см. в статье Поддержка высокого уровня доступности и аварийного восстановления.
$connectionInfo (необязательно): ассоциативный массив, содержащий атрибуты соединения (например, array("Database" => "AdventureWorks")). Список поддерживаемых ключей для массива см. в статье Connection Options .
Возвращаемое значение
Ресурс подключения PHP. Если не удается успешно создать и открыть соединение, возвращается значение false .
Замечания
Если значения для ключей UID и PWD не указаны в необязательном параметре $connectionInfo , предпринимается попытка установки соединения с использованием проверки подлинности Windows. Дополнительные сведения о подключении к серверу см. в статьях How to: Connect Using Windows Authentication и How to: Connect Using SQL Server Authentication.
Пример
Следующий пример создает и открывает соединение с использованием проверки подлинности Windows. В примере предполагается, что SQL Server и базы данных AdventureWorks установлены на локальном компьютере. При выполнении примера из командной строки все выходные данные выводятся в консоль.
<?php
/*
Connect to the local server using Windows Authentication and specify
the AdventureWorks database as the database in use. To connect using
SQL Server Authentication, set values for the "UID" and "PWD"
attributes in the $connectionInfo parameter. For example:
$connectionInfo = array("UID" => $uid, "PWD" => $pwd, "Database"=>"AdventureWorks");
*/
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn )
{
echo "Connection established.\n";
}
else
{
echo "Connection could not be established.\n";
die( print_r( sqlsrv_errors(), true));
}
//-----------------------------------------------
// Perform operations with connection.
//-----------------------------------------------
/* Close the connection. */
sqlsrv_close( $conn);
?>