(No hay información de versión disponible, podría estar únicamente en SVN)
sqlsrv_connect — Abre una conexión a una base de datos Microsoft SQL Server
$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.
serverNameEl 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).
connectionInfoUn 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.
Un recurso de conexión. Si no se puede abrir la conexión, se retorna el valor FALSE .
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));
}
?>
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")).