윈도우 10 IIS 환경에서 PHP 8.5에 pdo_sqlsrv (MS SQL Server용 PDO 확장)를 설치하고 연동

자료 기본정보

> 설명

윈도우 10 IIS 환경에서 PHP 8.5에 pdo_sqlsrv (MS SQL Server용 PDO 확장)를 설치하고 연동하려면, Microsoft 공식 드라이버 DLL 파일을 다운로드하여 PHP 확장 폴더에 넣고 php.ini 파일을 수정해야 합니다.

구체적인 설치 및 설정 방법은 다음과 같습니다.

1단계: Microsoft ODBC Driver 설치 (필수 선행 조건)

pdo_sqlsrv 드라이버는 내부적으로 Microsoft ODBC 드라이버를 통해 SQL Server와 통신합니다.

1. Microsoft ODBC Driver 다운로드 페이지에서 ODBC Driver 17 또는 18 for SQL Server (x64) 설치 파일을 다운로드하여 실행합니다.

2. 기본 설정으로 안내에 따라 설치를 완료합니다.

2단계: PHP 8.5용 pdo_sqlsrv 드라이버 파일 다운로드

1. Microsoft Drivers for PHP for SQL Server GitHub Releases 또는 공식 다운로드 페이지에 접속합니다.

2. 최신 버전(예: v5.13 이상)의 Windows용 패키지를 다운로드한 후 압축을 끕니다.

3. 압축 해제된 파일 중 현재 사용 중인 환경에 맞는 파일을 찾습니다.

   • PHP 버전: 8.5

   • 아키텍처 및 스레드 안전성: IIS 환경(Non-Thread Safe, NTS)을 사용 중이므로 ts가 아닌 nts 파일 (예: 64비트 윈도우 기준 php_pdo_sqlsrv_85_nts.dll)

3단계: DLL 파일을 PHP 확장 폴더로 복사

1. 다운로드한 파일 중 php_pdo_sqlsrv_85_nts.dll (필요시 일반 php_sqlsrv_85_nts.dll도 함께) 파일을 복사합니다.

2. PHP 8.5가 설치된 경로의 ext 폴더 안에 붙여넣습니다.

   • 예시 경로: C:PHPext

4단계: php.ini 설정 변경

1. PHP 설정 파일인 C:PHPphp.ini 파일을 메모장이나 텍스트 편집기로 엽니다.

2. 파일 안에서 extension= 목록이 있는 곳을 찾아 아래의 코드를 추가하거나 주석을 해제합니다.

   Ini, TOML

   extension=pdo_sqlsrv
   extension=sqlsrv
   
   

   • 참고: 파일명을 직접 적을 때는 확장자(.dll)를 제외하고 위처럼 적거나, 정확한 파일명(extension=php_pdo_sqlsrv_85_nts.dll)으로 명시해도 됩니다.

5단계: IIS 재시작 및 연동 확인

1. 설정을 저장한 후, 시작 메뉴에서 cmd 또는 PowerShell을 관리자 권한으로 실행합니다.

2. 아래 명령어를 입력하여 IIS를 재시작합니다.

   DOS

   iisreset
   
   

3. 이전에 생성해 둔 info.php (http://localhost/info.php) 페이지를 브라우저로 다시 접속합니다.

4. 페이지 내에서 pdo_sqlsrv 항목과 sqlsrv 섹션이 정상적으로 활성화되어 출력되는지 확인합니다.