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() - 쿼리 준비 및 실행