sqlsrv_connect
(No version information available, might only be in Git)
sqlsrv_connect — Abre una conexión a una base de datos Microsoft SQL Server
Descripción
sqlsrv_connect(string $serverName
, array $connectionInfo
= ?): resource
Parámetros
-
serverName
-
El nombre del servidor en el que se ha establecido una conexión. Para conectar
a una instancia específica, poner una barra invertida después del nombre de servidor
e indicar el nombre de la instancia (e.g. NombreServidor\sqlexpress).
-
connectionInfo
-
Un array asociativo que especifica las opciones de conexión al servidor.
Si no se ha especificado ningún valor para el UID y PWD, la conexión
se intentará utilizando la autenticación Windows. Para una lista completa de claves
soportadas, ver » Opciones de Conexión SQLSRV.
Valores devueltos
Un recurso de conexión. Si no se puede abrir la conexión, se retorna el valor false
.
Ejemplos
Ejemplo #1 Conectar utilizando autenticación Windows.
<?php
$serverName = "serverName\sqlexpress"; //serverName\instanceName
// Puesto que no se han especificado UID ni PWD en el array $connectionInfo,
// La conexión se intentará utilizando la autenticación Windows.
$connectionInfo = array( "Database"=>"dbName");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn ) {
echo "Conexión establecida.<br />";
}else{
echo "Conexión no se pudo establecer.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>
Ejemplo #2 Conectar especificando nombre de usuario y contraseña.
<?php
$serverName = "serverName\sqlexpress"; //serverName\instanceName
$connectionInfo = array( "Database"=>"dbName", "UID"=>"userName", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn ) {
echo "Conexión establecida.<br />";
}else{
echo "Conexión no se pudo establecer.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>
Ejemplo #3 Conectar a un puerto específico.
<?php
$serverName = "serverName\sqlexpress, 1542"; //serverName\instanceName, portNumber (por defecto es 1433)
$connectionInfo = array( "Database"=>"dbName", "UID"=>"userName", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn ) {
echo "Conexión establecida.<br />";
}else{
echo "Conexión no se pudo establecer.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>
Notas
Por defecto, la función sqlsrv_connect() utiliza la conexión mediante agrupación para
mejorar el funcionamiento de la conexión. Para desconectar el funcionamiento en modo grupo (p.ej. forzar una nueva conexión
en cada llamada), configurar la opción "ConnectionPooling" en el
array $connectionOptions a 0 (o false
). Para más información, ver
» Cola de conexión SQLSRV.
La extensión SQLSRV no tiene una función específica para cambiar a que base de datos
se está conectado. La base de datos objetivo se especifica en el array
de opciones $connectionOptions que se pasa a sqlsrv_connect. Para cambiar la
base de datos en una conexión ya abierta, ejecutar la siguiente sentencia sql "USE dbName"
(p.ej. sqlsrv_query($conn, "USE dbName")).
Ver también
- sqlsrv_close() - Cierra una conexión abierta y libera los recursos asociados a la conexión
- sqlsrv_errors() - Devuelve información de errores y alertas (warnings) de la última operación SQLSRV realizada
- sqlsrv_query() - Prepares and executes a query