Share via

sqlsrv_connect

  • 项目

下载 PHP 驱动程序

创建一个连接资源，并打开该连接。 默认情况下，使用 Windows 身份验证尝试连接。

语法

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

参数

$serverName：指定建立连接的服务器名称的字符串。 实例名称（例如“myServer\instanceName”）或端口号（例如“myServer, 1521”）可以包括为此字符串的一部分。 有关可用于此参数的选项的完整介绍，请参阅结合使用连接字符串关键字与 SQL Native Client 的 ODBC 驱动程序连接字符串关键字部分中的 Server 关键字。

从 Microsoft Drivers for PHP for SQL Server的版本 3.0 开始，你还可以指定带有 "(localdb)\instancename"的 LocalDB 实例。 有关详细信息，请参阅支持 LocalDB。

同样从 Microsoft Drivers for PHP for SQL Server的版本 3.0 开始，你还可以指定要连接到 Always On 可用性组的虚拟网络名称。 有关 Always On 可用性组的 Microsoft Drivers for PHP for SQL Server 支持的详细信息，请参阅高可用性、灾难恢复的支持。

$connectionInfo [可选]：包含连接属性的关联数组（例如，array ("Database" => "AdventureWorks")）。 有关数组的受支持密钥的列表，请参阅 Connection Options 。

返回值

PHP 连接资源。 如果无法成功创建和打开连接，则返回 false 。

备注

如果在可选的 $connectionInfo 参数中没有指定 UID 和 PWD 的值，将尝试使用 Windows 身份验证进行此连接。 有关连接到服务器的详细信息，请参阅如何：使用 Windows 身份验证进行连接和如何：使用 SQL Server 身份验证进行连接。

示例

以下示例使用 Windows 身份验证创建和打开连接。 该示例假定已在本地计算机上安装了 SQL Server 和 AdventureWorks 数据库。 从命令行运行该示例时，所有输出都将写入控制台。

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

另请参阅

SQLSRV 驱动程序 API 参考

连接到服务器

文档中相关的代码示例