sqlsrv_connect

Статья
06/02/2023

Создает ресурс подключения и открывает соединение. По умолчанию выполняется попытка установки соединения с использованием проверки подлинности Windows.

Синтаксис

  
sqlsrv_connect( string $serverName [, array $connectionInfo])

Параметры

$serverName: строка, указывающая имя сервера, с которым устанавливается соединение. В состав этой строки можно включить имя экземпляра (например, "мой_сервер\имя_экземпляра") или номер порта (например, "мой_сервер, 1521"). Полное описание значений, доступных для этого параметра, см. в разделе "Ключевые слова в строке подключения драйвера ODBC" статьи Использование ключевых слов строки подключения с SQL Native Client.

Начиная с версии 3.0 Драйверы Microsoft SQL Server для PHP, можно также указать экземпляр 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 .

Remarks

Если значения для ключей UID и PWD не указаны в необязательном параметре $connectionInfo , предпринимается попытка установки соединения с использованием проверки подлинности Windows. Дополнительные сведения о подключении к серверу см. в статьях Практическое руководство. Подключение с использованием проверки подлинности Windows и Практическое руководство. Подключение с использованием проверки подлинности SQL Server.

Пример

Следующий пример создает и открывает соединение с использованием проверки подлинности 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);  
?>

См. также:

Справочник по API для драйвера SQLSRV

Подключение к серверу

Информация о примерах кода в документации

Share via