sqlsrv_connect
(No version information available, might only be in Git)
sqlsrv_connect — Открывает соединение с базой данных Microsoft SQL Server
Описание
sqlsrv_connect(string $serverName
, array $connectionInfo
= ?): resource
Список параметров
-
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")).
Смотрите также
- sqlsrv_close() - Закрывает открытое соединение и освобождает ресурсы, связанные с этим соединением
- sqlsrv_errors() - Возвращает информацию об ошибке и предупреждении последней выполненной операции SQLSRV
- sqlsrv_query() - Подготавливает и выполняет запрос