sqlsrv_connect

Artículo
06/02/2023

Crea un recurso de conexión y abre una conexión. De forma predeterminada, se intentará realizar la conexión mediante la autenticación de Windows.

Sintaxis

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

Parámetros

$serverName: una cadena que especifica el nombre del servidor con el que se está estableciendo una conexión. Se puede incluir un nombre de instancia (por ejemplo, "miServidor\nombreDeInstancia") o el número de puerto (por ejemplo, "miServidor, 1521") como parte de esta cadena. Para obtener una descripción completa de las opciones disponibles en este parámetro, vea la palabra clave Server en la sección Palabras clave de la cadena de conexión del controlador ODBC del artículo Usar palabras clave de cadena de conexión con SQL Server Native Client.

A partir de la versión 3.0 de los Controladores de Microsoft para PHP para SQL Server, también puede especificar una instancia de LocalDB con "(localdb)\instancename". Para más información, consulte Compatibilidad con LOcalDB.

También, a partir de la versión 3.0 de los Controladores de Microsoft para PHP para SQL Server, puede especificar un nombre de red virtual para conectarse a un grupo de disponibilidad Always On. Para más información sobre la compatibilidad con controladores de Microsoft para PHP en SQL Server para grupos de disponibilidad AlwaysOn, consulte Compatibilidad con alta disponibilidad y recuperación ante desastres.

$connectionInfo (opcional): una matriz asociativa que contiene atributos de conexión (por ejemplo, array("Database" => "AdventureWorks")). Consulte Connection Options para obtener una lista de las claves admitidas para la matriz.

Valor devuelto

Un recurso de conexión PHP. Si no se crea y abre correctamente una conexión, se devuelve False .

Observaciones

Si los valores de las claves de UID y PWD no se especifican en el parámetro opcional $connectionInfo , se tratará de realizar la conexión usando la autenticación de Windows. Para más información sobre la conexión al servidor, consulte Procedimiento: Conexión mediante la autenticación de Windows y Procedimiento: Conexión mediante la autenticación de SQL Server.

Ejemplo

En el ejemplo siguiente se crea y abre una conexión mediante la autenticación de Windows. En el ejemplo se da por hecho que SQL Server y la base de datos de AdventureWorks están instalados en el equipo local. Los resultados se agregan a la consola cuando se ejecuta el ejemplo en la línea de comandos.

<?php  
/*  
Connect to the local server using Windows Authentication and specify  
the AdventureWorks database as the database in use. To connect using  
SQL Server Authentication, set values for the "UID" and "PWD"  
 attributes in the $connectionInfo parameter. For example:  
$connectionInfo = array("UID" => $uid, "PWD" => $pwd, "Database"=>"AdventureWorks");  
*/  
$serverName = "(local)";  
$connectionInfo = array( "Database"=>"AdventureWorks");  
$conn = sqlsrv_connect( $serverName, $connectionInfo);  
  
if( $conn )  
{  
     echo "Connection established.\n";  
}  
else  
{  
     echo "Connection could not be established.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
//-----------------------------------------------  
// Perform operations with connection.  
//-----------------------------------------------  
  
/* Close the connection. */  
sqlsrv_close( $conn);  
?>

Consulte también

Referencia de API del controlador SQLSRV

Conexión al servidor

Sobre los ejemplos de código de la documentación

Compartir a través de