Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Cria um recurso de ligação e abre uma ligação. Por defeito, a ligação é tentada usando a Autenticação do Windows.
Sintaxe
sqlsrv_connect( string $serverName [, array $connectionInfo])
Parameters
$serverName: Uma cadeia que especifica o nome do servidor ao qual está a ser estabelecida uma ligação. Um nome de instância (por exemplo, <server>\instanceName) ou número de porta (por exemplo, <server>, 1521) pode ser incluído como parte desta cadeia. Para uma descrição completa das opções disponíveis para este parâmetro, veja a palavra-chave Servidor na secção ODBC Driver Connection String Keywords de Using Connection String Keywords with SQL Native Client.
A partir da versão 3.0 dos Microsoft Drivers for PHP for SQL Server, também pode especificar uma instância de LocalDB com "(localdb)\instancename". Para mais informações, consulte Suporte ao LocalDB.
Também a partir da versão 3.0 dos Microsoft Drivers for PHP for SQL Server, pode especificar um nome de rede virtual para se ligar a um grupo de disponibilidade Always On. Para mais informações sobre os Microsoft Drivers for PHP para suporte ao SQL Server para grupos de disponibilidade Always On, consulte Suporte para Alta Disponibilidade, Recuperação de Desastres.
$connectionInfo [OPCIONAL]: Um array associativo que contém atributos de ligação (por exemplo, array("Database" => "AdventureWorks")). Consulte Opções de Ligação para uma lista das chaves suportadas para o array.
Valor de retorno
Um recurso de ligação a PHP. Se uma ligação não puder ser criada e aberta com sucesso, a falsa é devolvida.
Observações
Se os valores das chaves UID e PWD não forem especificados no parâmetro opcional $connectionInfo, a ligação será tentada usando Windows Autenticação. Para mais informações sobre ligação ao servidor, veja Como: Ligar Usando Autenticação Windows e Como: Ligar Usando Autenticação SQL Server.
Exemplo
O exemplo seguinte cria e abre uma ligação usando a Autenticação Windows. O exemplo assume que o SQL Server e a base de dados AdventureWorks estão instalados no computador local. Toda a saída é escrita para a consola quando o exemplo é executado a partir da linha 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);
?>