SQLSRV Funciones
PHP Manual

sqlsrv_connect

(No hay información de versión disponible, podría estar únicamente en SVN)

sqlsrv_connectAbre una conexión a una base de datos Microsoft SQL Server

Descripción

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

Abre una conexión a una base de datos Microsoft SQL Server. Por defecto, la conexión se intenta utilizando la autenticación Windows. Para conectar utilizando la autenticación SQL Server, incluir "UID" y "PWD" en el array de opciones de conexión.

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_rsqlsrv_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_rsqlsrv_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_rsqlsrv_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 Funciones
PHP Manual