(No version information available, might only be in Git)
sqlsrv_connect — Открывает соединение с базой данных Microsoft SQL Server
$serverName
, array $connectionInfo
= ?): resourceОткрывает соединение с базой данных Microsoft SQL Server. По умолчанию попытка подключения выполняется с использованием проверки подлинности Windows. Чтобы подключиться с использованием проверки подлинности SQL Server, включите "UID" и "PWD" в массив параметров подключения.
serverName
Имя сервера, к которому устанавливается соединение. Чтобы подключиться к определённому экземпляру, после имени сервера укажите обратную косую черту и имя экземпляра (например, serverName\sqlexpress).
connectionInfo
Ассоциативный массив, определяющий параметры подключения к серверу. Если значения для ключей UID и PWD не указаны, будет предпринята попытка подключения с использованием проверки подлинности Windows. Полный список поддерживаемых ключей смотрите в разделе » Параметры подключения SQLSRV.
Ресурс подключения. Если соединение не может быть открыто, возвращается false
.
Пример #1 Подключение с использованием проверки подлинности Windows.
<?php
$serverName = "serverName\\sqlexpress"; //serverName\instanceName
// Поскольку UID и PWD не указаны в массиве $connectionInfo,
// будет предпринята попытка подключения с использованием проверки подлинности Windows.
$connectionInfo = array( "Database"=>"dbName");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn ) {
echo "Соединение установлено.<br />";
}else{
echo "Соединение не установлено.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>
Пример #2 Подключение с использованием имени пользователя и пароля.
<?php
$serverName = "serverName\\sqlexpress"; //serverName\instanceName
$connectionInfo = array( "Database"=>"dbName", "UID"=>"userName", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn ) {
echo "Соединение установлено.<br />";
}else{
echo "Соединение не установлено.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>
Пример #3 Подключение с использованием порта.
<?php
$serverName = "serverName\\sqlexpress, 1542"; //serverName\instanceName, portNumber (по умолчанию 1433)
$connectionInfo = array( "Database"=>"dbName", "UID"=>"userName", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn ) {
echo "Соединение установлено.<br />";
}else{
echo "Соединение не установлено.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>
По умолчанию sqlsrv_connect() использует пул соединений для повышения производительности соединения.
Чтобы отключить пул соединений (т.е. принудительно устанавливать новое соединение при каждом вызове),
установите для параметра "ConnectionPooling" в массиве $connectionOptions значение 0 (или false
).
Для получения дополнительной информации смотрите раздел » Пул соединений SQLSRV.
У модуля SQLSRV нет специальной функции для изменения базы данных после подключения. Целевая база данных указывается в массиве $connectionOptions, который передаётся в sqlsrv_connect. Чтобы изменить базу данных при открытом соединении, выполните следующий запрос "USE dbName" (например, sqlsrv_query($conn, "USE dbName")).