다음을 통해 공유


Microsoft Drivers for PHP for SQL Server 로드

PHP 드라이버 다운로드

이 페이지에서는 MICROSOFT Drivers for PHP for SQL Server를 PHP 프로세스 공간에 로드하기 위한 지침을 제공합니다.

Microsoft Drivers for PHP for SQL Server GitHub 프로젝트 페이지에서 플랫폼에 대한 미리 빌드된 드라이버를 다운로드할 수 있습니다. 각 설치 패키지에는 스레드 및 비스레드 변형의 SQLSRV 및 PDO_SQLSRV 드라이버 파일이 포함되어 있습니다. Windows에서는 32비트 및 64비트 변형도 사용할 수 있습니다. 각 패키지에 포함된 드라이버 파일 목록을 보려면 Microsoft Drivers for PHP for SQL Server 시스템 요구 사항을 참조하세요. 드라이버 파일은 PHP 환경의 PHP 버전, 아키텍처 및 스레드 여부가 일치해야 합니다.

Linux 및 macOS에서는 설치 자습서의 설명과 같이 PECL을 사용하여 드라이버를 설치할 수도 있습니다.

PHP를 빌드할 때 또는 phpize를 사용하여 소스에서 드라이버를 빌드할 수도 있습니다. 소스에서 드라이버를 빌드하기로 선택한 경우, PHP를 빌드할 때 --enable-sqlsrv=static --with-pdo_sqlsrv=static 명령에 --enable-sqlsrv=static --with-pdo-sqlsrv=static(Linux 및 macOS) 또는 ./configure(Windows)을(를) 추가하여 공유 확장으로 빌드하는 대신 정적으로 PHP에 빌드하는 옵션이 있습니다. PHP 빌드 시스템 및 phpize에 대한 자세한 내용은 PHP 설명서를 참조하세요.

확장 디렉터리로 드라이버 파일 이동

드라이버 파일은 PHP 런타임에서 찾을 수 있는 디렉터리에 있어야 합니다. 드라이버 파일을 기본 PHP 확장 디렉터리에 배치하는 것이 가장 쉬운 방법입니다. 기본 디렉터리를 찾으려면 Windows에서는 php -i | sls extension_dir을(를) 실행하고 Linux/macOS에서는 php -i | grep extension_dir를 실행합니다. 기본 확장 디렉터리를 사용 중이지 않은 경우 extension_dir 옵션을 사용하여 PHP 구성 파일(php.ini)에 디렉터리를 지정합니다. 예를 들어 Windows의 경우 c:\php\ext 디렉터리에 드라이버 파일을 추가한 경우 다음 줄을 php.ini에 추가합니다.

extension_dir = "c:\PHP\ext"  

PHP 시작 시 드라이버 로드

PHP가 시작될 때 SQLSRV 드라이버를 로드하려면 먼저 드라이버 파일을 확장 디렉터리로 이동합니다. 그런 후 다음 단계를 수행합니다.

  1. SQLSRV 드라이버를 사용하도록 설정하려면 확장 섹션에 다음 줄을 추가하여 파일 이름을 적절하게 변경하여 php.ini를 수정합니다.

    Windows:

    extension=php_sqlsrv_82_ts.dll  
    

    Linux에서 배포용으로 미리 빌드된 이진 파일을 다운로드한 경우:

    extension=php_sqlsrv_82_nts.so  
    

    원본에서 또는 PECL을 사용하여 SQLSRV 이진 파일을 컴파일한 경우 대신 sqlsrv.so로 이름이 지정됩니다.

    extension=sqlsrv.so
    
  2. PDO_SQLSRV 드라이버를 사용하도록 설정하려면 기본 제공 확장 또는 동적으로 로드되는 확장으로 PHP 데이터 개체(PDO) 확장을 사용할 수 있어야 합니다.

    Windows에서는 미리 빌드된 PHP 이진 파일에 PDO가 기본 제공되므로 로드하기 위해 php.ini 수정할 필요가 없습니다. 그러나 PHP를 원본에서 컴파일하고 빌드할 개별 PDO 확장을 지정한 경우 이름이 php_pdo.dll로 지정되므로 이를 확장 디렉터리에 복사하고 다음 줄을 PHP에 추가해야 합니다.

    extension=php_pdo.dll  
    

    Linux에서 시스템의 패키지 관리자를 사용하여 PHP를 설치한 경우 PDO는 동적으로 로드되는 확장자 이름 pdo.so로 설치되어 있을 것입니다. PDO_SQLSRV 확장보다 먼저 PDO 확장을 로드해야 하며, 그렇지 않으면 로드에 실패합니다. 확장은 일반적으로 개별 .ini 파일을 사용하여 로드되며 이러한 파일은 php.ini 후에 읽습니다. 따라서 pdo.so가 자체 .ini 파일을 통해 로드된 경우 PDO 다음에 PDO_SQLSRV 드라이버를 로드하는 별도의 파일이 필요합니다.

    확장별 .ini 파일이 있는 디렉터리를 찾으려면 php --ini을(를) 실행하고 Scan for additional .ini files in: 아래에 나열된 디렉터리를 확인합니다. pdo.so를 로드하는 파일을 찾습니다. 이 파일에는 10-pdo.ini 같은 숫자 접두사가 있을 수 있습니다. 숫자 접두사는 .ini 파일의 로드 순서를 나타내며, 숫자 접두사가 없는 파일은 알파벳 순으로 로드됩니다. PDO_SQLSRV 드라이버 파일을 로드할 파일을 30-pdo_sqlsrv.ini(pdo.ini 접두사 앞에 숫자보다 큰 숫자가 있으면 작동) 또는 pdo_sqlsrv.ini(pdo.ini 앞에 숫자 접두사가 없는 경우)라는 이름으로 만든 다음, 파일 이름을 적절히 변경하여 다음 줄을 추가합니다.

    extension=php_pdo_sqlsrv_82_nts.so
    

    SQLSRV와 마찬가지로 원본 또는 PECL에서 PDO_SQLSRV 이진 파일을 컴파일한 경우 대신 pdo_sqlsrv 이름이 지정됩니다.

    extension=pdo_sqlsrv.so
    

    이 파일을 다른 .ini 파일이 포함된 디렉터리에 복사합니다.

    기본 제공 PDO 지원을 사용하여 원본에서 PHP를 컴파일한 경우 별도의 .ini 파일이 필요하지 않으며, 위의 적절한 줄을 php.ini에 추가할 수 있습니다.

  3. 웹 서버를 다시 시작합니다.

참고 항목

드라이버가 성공적으로 로드되었는지 확인하려면 phpinfo()를 호출하는 스크립트를 실행합니다.

php.ini 지시문에 대한 자세한 내용은 핵심 php.ini 지시문 설명을 참조하세요.

참고 항목

Microsoft Drivers for PHP for SQL Server 시작

Microsoft Drivers for PHP for SQL Server에 대한 시스템 요구 사항

Microsoft Drivers for PHP for SQL Server 프로그래밍 가이드

SQLSRV 드라이버 API 참조

PDO_SQLSRV 드라이버 API 참조