(No version information available, might only be in Git)
sqlsrv_connect — Establece una conexión con una base de datos Microsoft SQL Server
Establece una conexión con una base de datos Microsoft SQL Server. Por omisión, la conexión intenta utilizar la autenticación Windows. Para conectarse utilizando la autenticación SQL Server, se deben añadir los argumentos "UID" y "PWD" en el array de opciones de conexión.
serverNameconnectionInfo
Un recurso de conexión. Si la conexión no pudo ser abierta, se retornará false.
Ejemplo #1 Conexión utilizando la autenticación Windows.
<?php
$serverName = "serverName\\sqlexpress"; //serverName\instanceName
// Dado que UID y PWD no están especificados en el array $connectionInfo,
// la conexión intentará utilizar la autenticación Windows.
$connectionInfo = array( "Database"=>"dbName");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn ) {
echo "Conexión establecida.<br />";
}else{
echo "La conexión no pudo ser establecida.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>Ejemplo #2 Conexión especificando un nombre de usuario y una 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 "La conexión no pudo ser establecida.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>Ejemplo #3 Conexión a un puerto específico.
<?php
$serverName = "serverName\\sqlexpress, 1542"; //serverName\instanceName, portNumber (default is 1433)
$connectionInfo = array( "Database"=>"dbName", "UID"=>"userName", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn ) {
echo "Conexión establecida.<br />";
}else{
echo "La conexión no pudo ser establecida.<br />";
die( print_r( sqlsrv_errors(), true));
}
?>
Por omisión, la función sqlsrv_connect() utiliza la cola de conexiones
para aumentar el rendimiento. Para desactivar esta cola de conexiones
(i.e. y así, forzar una nueva conexión en cada llamada a la función), se debe definir
la opción "ConnectionPooling" en el array $connectionOptions a 0 (o false).
Para más información, consulte el capítulo sobre la
» cola de conexiones SQLSRV.
La extensión SQLSRV no tiene una función dedicada para modificar la base de datos a la que está conectada. La base de datos objetivo se especifica en el array $connectionOptions pasado a la función sqlsrv_connect. Para cambiar la base de datos en una conexión abierta, se debe ejecutar la siguiente consulta: "USE dbName" (i.e. sqlsrv_query($conn, "USE dbName")).