sqlsrv_connect

  • 아티클

PHP 드라이버 다운로드

연결 리소스를 만들고 연결을 엽니다. 기본적으로 Windows 인증을 사용하여 연결을 시도합니다.

구문

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

매개 변수

$serverName: 연결이 설정되는 서버의 이름을 지정하는 문자열입니다. 인스턴스 이름(예: "myServer\instanceName") 또는 포트 번호(예: "myServer 1521")가 이 문자열의 일부로 포함될 수 있습니다. 이 매개 변수에 사용할 수 있는 옵션에 대한 자세한 내용은 SQL Native Client에서 연결 문자열 키워드 사용의 ODBC 드라이버 연결 문자열 키워드 섹션에서 서버 키워드를 참조하세요.

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 [선택 사항]: 연결 특성을 포함하는 결합형 배열(예: 배열("Database"=> "AdventureWorks"))입니다. 배열에 대해 지원되는 키 목록은 Connection Options 을 참조하세요.

Return Value

PHP 연결 리소스입니다. 연결을 만들 수 없고 열 수 없으면 false 가 반환됩니다.

설명

UID 및 PWD 키에 대한 값이 선택적 $connectionInfo 매개 변수에 지정되지 않은 경우 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 참조

서버에 연결

설명서의 코드 예제 정보