sqlsrv_connect

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

구문

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

매개 변수

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

$connectionInfo [옵션]: 연결 특성을 포함하는 결합형 array입니다(예: array("Database" => "AdventureWorks")). 다음 표에서는 지원되는 배열 키에 대해 설명합니다.

1. 설정된 연결에서 실행되는 모든 쿼리는 Database 특성에 지정된 데이터베이스에 대해 수행됩니다. 하지만 사용자가 적절한 권한을 가지고 있는 경우 정규화된 이름을 사용하여 다른 데이터베이스의 데이터에 액세스할 수 있습니다. 예를 들어, master 데이터베이스가 Database 연결 특성을 사용하여 설정되어 있는 경우 정규화된 이름을 사용하여 AdventureWorks.HumanResources.Employee 테이블에 액세스하는 Transact-SQL 쿼리를 실행할 수 있습니다.

2. Encryption을 설정하는 경우 데이터 암호화에 필요한 계산 오버헤드로 인해 일부 응용 프로그램의 성능에 영향을 미칠 수 있습니다.

3. SQL Server 인증으로 연결할 때 UID 및 PWD 특성이 모두 설정되어 있어야 합니다.

지원되는 키는 대부분 ODBC 연결 문자열 특성입니다. ODBC 연결 문자열에 대한 자세한 내용은 SQL Native Client에서 연결 문자열 키워드 사용(Using Connection String Keywords with SQL Native Client)을 참조하십시오.

반환 값

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)); 
*/
$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);
?>

참고 항목

개념

설명서에 포함된 코드 예제 정보

관련 자료

API 참조(SQL Server Driver for PHP)
서버에 연결