Compartilhar via


sqlsrv_connect

Baixar o driver PHP

Cria um recurso de conexão e abre uma conexão. Por padrão, a conexão será tentada usando a Autenticação do Windows.

Sintaxe

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

Parâmetros

$serverName: uma cadeia de caracteres especificando o nome do servidor com o qual uma conexão está sendo estabelecida. Um nome de instância (por exemplo, "meuServidor\NomedaInstância") ou número de porta (por exemplo, "meuServidor, 1521") pode ser incluído como parte da cadeia de caracteres. Para obter uma descrição completa das opções disponíveis para esse parâmetro, confira a palavra-chave Servidor na seção Palavras-chave da cadeia de conexão do Driver ODBC de Usando palavras-chave da cadeia de conexão com o SQL Server Native Client.

A partir da versão 3.0 dos Drivers da Microsoft para PHP para SQL Server, você também pode especificar uma instância LocalDB com "(localdb)\instancename". Para obter mais informações, confira Suporte para LocalDB.

Começando na versão 3.0 dos Drivers da Microsoft para PHP para SQL Server, também é possível especificar um nome de rede virtual para se conectar a um grupo de disponibilidade Always On. Para obter mais informações sobre o suporte para Drivers PHP do Microsoft SQL Server para grupos de disponibilidade AlwaysOn, confira Suporte para Alta Disponibilidade, Recuperação de Desastre.

$connectionInfo [OPCIONAL]: uma matriz associativa que contém atributos de conexão (por exemplo, matriz("Database" => "AdventureWorks")). Consulte Connection Options para obter uma lista das chaves com suporte para a matriz.

Valor retornado

Um recurso de conexão PHP. Se uma conexão não puder ser criada e aberta com êxito, false será retornado.

Comentários

Se os valores das chaves UID e PWD não forem especificadas no parâmetro $connectionInfo opcional, a conexão será tentada usando a Autenticação do Windows. Para obter mais informações sobre como se conectar ao servidor, confira Como conectar-se usando a Autenticação do Windows e Como conectar-se usando a Autenticação do SQL Server.

Exemplo

O exemplo a seguir cria e abre uma conexão usando a Autenticação do Windows. O exemplo supõe que o SQL Server e o banco de dados AdventureWorks estejam instalados no computador local. Toda a saída será gravada no console quando o exemplo for executado da linha de comando.

<?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 Também

Referência da API do driver SQLSRV

Conectando-se ao servidor

Sobre exemplos de código na documentação