sqlsrv_connect
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);
?>