Ładowanie sterowników firmy Microsoft dla języka PHP dla programu SQL Server

Ta strona zawiera instrukcje dotyczące ładowania sterowników firmy Microsoft dla języka PHP dla programu SQL Server do obszaru procesu PHP.

Zainstaluj sterowniki na Windows z PIE

PIE, instalator PHP dla rozszerzeń, instaluje odpowiadające pliki sterowników i włącza je w konfiguracji wiersza poleceń PHP. Windows nie potrzebuje łańcucha narzędzi do budowania.

  1. Zainstaluj obsługiwaną wersję PHP oraz sterownik Microsoft ODBC dla SQL Server.

  2. Uruchom program php --ini. Jeśli Załadowany plik konfiguracyjny to (none), skopiuj php.ini-development z katalogu instalacyjnego programu PHP do php.ini w tym samym katalogu.

  3. W pliku php.ini ustaw katalog rozszerzeń i włącz rozszerzenia openssl i zip:

    extension_dir = "ext"
extension=openssl
extension=zip

  4. Z zapisywalnego katalogu roboczego pobierz najnowszą wersję stabilną pie.phar. To polecenie działa w Wierszu Poleceń i programie PowerShell:

    curl.exe -fL --output pie.phar https://github.com/php/pie/releases/latest/download/pie.phar

    Jeśli masz GitHub CLI, sprawdź, czy PHP Foundation opublikowała plik:

    gh attestation verify --owner php .\pie.phar

  5. Zainstaluj oba sterowniki, używając pliku wykonywalnego PHP na PATH:

    php .\pie.phar install microsoft/sqlsrv
php .\pie.phar install microsoft/pdo_sqlsrv

  6. Sprawdź, czy to samo środowisko uruchomieniowe PHP w wierszu poleceń ładuje oba sterowniki:

    php --ri sqlsrv
php --ri pdo_sqlsrv

Aby poznać inne metody instalacji PIE, zobacz dokumentację użytkowania PIE.

Zainstaluj sterowniki na Linuksie i macOS

Zainstaluj sterowniki i ich zależności platformy za pomocą PIE, jak opisano w samouczku instalacji Linuksa i macOS.

Ręcznie instaluj gotowe sterowniki

Możesz pobrać gotowe sterowniki ze strony Microsoft Drivers for PHP for SQL Server. Plik do pobrania dla systemu Windows to archiwum ZIP zawierające pliki sterowników SQLSRV i PDO_SQLSRV dla każdej obsługiwanej wersji PHP, architektury i trybu bezpieczeństwa wątków. Wybierz pliki pasujące do twojego środowiska PHP. Zobacz wymagania systemowe dla listy plików.

Możesz również skompilować sterowniki ze źródła podczas kompilowania języka PHP lub przy użyciu polecenia phpize. Jeśli zdecydujesz się skompilować sterowniki ze źródła, możesz utworzyć je statycznie w języku PHP, zamiast kompilować je jako rozszerzenia udostępnione, dodając --enable-sqlsrv=static --with-pdo_sqlsrv=static (w systemach Linux i macOS) lub --enable-sqlsrv=static --with-pdo-sqlsrv=static (w systemie Windows) do ./configure polecenia podczas kompilowania języka PHP. Aby uzyskać więcej informacji na temat systemu kompilacji PHP i phpize, zobacz dokumentację języka PHP.

Przenoszenie pliku sterownika do katalogu rozszerzeń

Plik sterownika musi znajdować się w katalogu, w którym można go znaleźć w środowisku uruchomieniowym PHP. Najłatwiej umieścić plik sterownika w domyślnym katalogu rozszerzenia PHP — aby znaleźć katalog domyślny, uruchomić php -i | sls extension_dir w systemie Windows lub php -i | grep extension_dir w systemie Linux/macOS. Jeśli nie używasz domyślnego katalogu rozszerzeń, określ katalog w pliku konfiguracji PHP (php.ini), używając opcji extension_dir . Jeśli na przykład w systemie Windows umieścisz plik sterownika w c:\php\ext katalogu, dodaj następujący wiersz do php.ini:

extension_dir = "c:\PHP\ext"

Ładowanie sterownika podczas uruchamiania php

Aby załadować sterownik SQLSRV po uruchomieniu języka PHP, najpierw przenieś plik sterownika do katalogu rozszerzeń. Następnie wykonaj następujące kroki:

  1. Aby włączyć sterownik SQLSRV, zmodyfikuj php.ini, dodając następujący wiersz do sekcji rozszerzeń, zmieniając nazwę pliku odpowiednio dla wersji PHP i instalacji bezpiecznej dla wątków lub niebezpiecznej dla wątków.

    W systemie Windows:

    extension=php_sqlsrv_83_ts.dll

    W systemie Linux, jeśli pobrano gotowe do użycia pliki binarne dla Twojej dystrybucji:

    extension=php_sqlsrv_83_nts.so

    Jeśli skompilowałeś binarny plik SQLSRV ze źródła lub zainstalowałeś go z PIE lub PECL, jego nazwa brzmi sqlsrv.so:

    extension=sqlsrv.so

  2. Aby umożliwić sterownik PDO_SQLSRV , rozszerzenie PHP Data Objects (PDO) musi być dostępne, zarówno jako wbudowane rozszerzenie, jak i jako dynamicznie ładowane rozszerzenie.

    W systemie Windows wstępnie utworzone pliki binarne PHP mają wbudowane PDO, więc nie trzeba modyfikować php.ini, aby je załadować. Jeśli jednak skompilujesz PHP ze źródeł i określiłeś oddzielne rozszerzenie PDO do zbudowania, jego nazwa to php_pdo.dll, i musisz skopiować je do katalogu z rozszerzeniami i dodać następujący wiersz do php.ini:

    extension=php_pdo.dll

    W systemie Linux, jeśli zainstalowano środowisko PHP przy użyciu menedżera pakietów systemu, pdO jest prawdopodobnie zainstalowane jako dynamicznie załadowane rozszerzenie o nazwie pdo.so. Rozszerzenie PDO musi zostać załadowane przed rozszerzeniem PDO_SQLSRV lub ładowanie kończy się niepowodzeniem. Rozszerzenia są ładowane przy użyciu pojedynczych plików .ini, a te pliki są odczytywane po php.ini. W związku z tym, jeśli pdo.so jest ładowany za pomocą własnego pliku .ini, wymagany jest oddzielny plik ładujący sterownik PDO_SQLSRV po PDO.

    Aby dowiedzieć się, w którym katalogu znajdują się pliki .ini specyficzne dla rozszerzenia, uruchom php --ini i zanotuj katalog wymieniony w obszarze Scan for additional .ini files in:. Znajdź plik, który ładuje pdo.so. Powinien być poprzedzony liczbą, taką jak 10-pdo.ini. Prefiks liczbowy wskazuje kolejność ładowania plików .ini, podczas gdy pliki, które nie mają prefiksu liczbowego, są ładowane alfabetycznie. Utwórz plik, aby załadować plik sterownika PDO_SQLSRV o nazwie 30-pdo_sqlsrv.ini (dowolna liczba większa niż ta, która jest prefiksem pdo.ini) lub pdo_sqlsrv.ini (jeśli pdo.ini nie ma prefiksu w postaci liczby), i dodaj do niego następujący wiersz, zmieniając nazwę pliku zgodnie z potrzebami:

    extension=php_pdo_sqlsrv_3_nts.so

    Podobnie jak w SQLSRV, jeśli skompilowałeś PDO_SQLSRV binarny z kodu źródłowego lub zainstalowałeś go z PIE lub PECL, jego nazwa to pdo_sqlsrv.so:

    extension=pdo_sqlsrv.so

    Skopiuj ten plik do katalogu zawierającego inne pliki .ini.

    Jeśli skompilujesz język PHP ze źródła z wbudowaną obsługą pdO, nie potrzebujesz oddzielnego pliku .ini i możesz dodać poprzedni wiersz do php.ini.

  3. Zrestartuj serwer WWW.

Uwaga / Notatka

Aby określić, czy sterownik został pomyślnie załadowany, uruchom skrypt, który wywołuje phpinfo().

Aby uzyskać więcej informacji na temat dyrektyw php.ini , zobacz Opis podstawowych dyrektyw php.ini.

Treści powiązane

  • Last updated on