sqlsrv_connect

(사용 가능한 버전 정보가 없으며 Git에만 있을 수 있음)

sqlsrv_connect — Microsoft SQL Server 데이터베이스에 대한 연결을 엽니다.

sqlsrv_connect(string $serverName, array $connectionInfo = ?): resource

Microsoft SQL Server 데이터베이스에 대한 연결을 엽니다. 기본적으로 Windows 인증을 사용하여 연결을 시도합니다. SQL Server 인증을 사용하여 연결하려면 연결 옵션 배열에 "UID" 및 "PWD"를 포함합니다.


매개변수

serverName
연결이 설정된 서버의 이름입니다. 특정 인스턴스에 연결하려면 서버 이름 뒤에 백슬래시와 인스턴스 이름(예: serverName\sqlexpress)을 붙입니다.
connectionInfo
서버에 연결하기 위한 옵션을 지정하는 연관 배열입니다. UID 및 PWD 키 값을 지정하지 않으면 Windows 인증을 사용하여 연결을 시도합니다. 지원되는 키의 전체 목록은 » SQLSRV 연결 옵션을 참조하세요.

반환 값

연결 리소스입니다. 연결을 성공적으로 열 수 없으면 false가 반환됩니다.


Examples

예제 #1 Windows 인증을 사용하여 연결합니다.

                  
<?php
$serverName = "serverName\\sqlexpress"; //serverName\instanceName

// Since UID and PWD are not specified in the $connectionInfo array,
// The connection will be attempted using Windows Authentication.
$connectionInfo = array( "Database"=>"dbName");
$conn = sqlsrv_connect( $serverName, $connectionInfo);

if( $conn ) {
     echo "Connection established.<br />";
}else{
     echo "Connection could not be established.<br />";
     die( print_r( sqlsrv_errors(), true));
}
?>
                  
                

예제 #2 사용자 이름과 암호를 지정하여 연결합니다.

                  
<?php
$serverName = "serverName\\sqlexpress"; //serverName\instanceName
$connectionInfo = array( "Database"=>"dbName", "UID"=>"userName", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);

if( $conn ) {
     echo "Connection established.<br />";
}else{
     echo "Connection could not be established.<br />";
     die( print_r( sqlsrv_errors(), true));
}
?>
                  
                

예제 #3 지정된 포트에 연결합니다.

                  
<?php
$serverName = "serverName\\sqlexpress, 1542"; //serverName\instanceName, portNumber (default is 1433)
$connectionInfo = array( "Database"=>"dbName", "UID"=>"userName", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);

if( $conn ) {
     echo "Connection established.<br />";
}else{
     echo "Connection could not be established.<br />";
     die( print_r( sqlsrv_errors(), true));
}
?>
                  
                

메모

기본적으로 sqlsrv_connect()는 연결 풀링을 사용하여 연결 성능을 향상시킵니다. 연결 풀링을 끄려면(즉, 호출할 때마다 새 연결을 강제 실행) $connectionOptions 배열의 "ConnectionPooling" 옵션을 0(또는 false)으로 설정합니다. 자세한 내용은 » SQLSRV 연결 풀링을 참조하세요.

SQLSRV 확장에는 연결된 데이터베이스를 변경하기 위한 전용 함수가 없습니다. 대상 데이터베이스는 sqlsrv_connect에 전달되는 $connectionOptions 배열에 지정됩니다. 열린 연결에서 데이터베이스를 변경하려면 다음 쿼리 "USE dbName"(예: sqlsrv_query($conn, "USE dbName"))을 실행합니다.


기타

  • sqlsrv_close() - 열려 있는 연결을 닫고 연결과 관련된 리소스를 해제합니다.
  • sqlsrv_errors() - 마지막으로 수행된 SQLSRV 작업에 대한 오류 및 경고 정보를 반환합니다.
  • sqlsrv_query() - 쿼리 준비 및 실행