Wymagania systemowe dotyczące sterowników firmy Microsoft dla języka PHP dla programu SQL Server

Pobieranie sterownika PHP

Ten artykuł wymienia komponenty, które musisz zainstalować na swoim systemie, aby uzyskać dostęp do danych w SQL Server lub Azure SQL Database, korzystając z sterownika SQLSRV lub PDO_SQLSRV.

Więcej informacji o cyklach życia wsparcia i wymaganiach sterowników PHP można znaleźć w macierzy wsparcia. Sterowniki SQLSRV i PDO_SQLSRV w każdej wersji mają te same wymagania dotyczące PHP, systemu operacyjnego, architektury, bezpieczeństwa wątków i ODBC.

Jak elementy stosu sterowników współdziałają

Aplikacja PHP nie łączy się bezpośrednio z serwerem bazy danych. Każda warstwa musi być kompatybilna z warstwą sąsiedzącą:

SQLSRV i PDO_SQLSRV oferują różne API PHP na tym samym sterowniku ODBC. Zainstaluj obie, gdy Twoja aplikacja korzysta z obu interfejsów API. Zainstalowanie jednego rozszerzenia nie powoduje automatycznego zainstalowania ani włączenia drugiego.

Rozszerzenia można instalować samodzielnie. PDO_SQLSRV wymaga też załadowania PDO przed PDO_SQLSRV.

Wybierz zgodny zestaw

Zanim pobierzesz lub zbudujesz sterownik, wykonaj następujące kontrole:

1. Zidentyfikuj każdy runtime PHP obsługujący aplikację. Zaplanowane zadanie, worker wiersza poleceń, witryna IIS, moduł Apache oraz pula PHP-FPM mogą korzystać z różnych plików wykonywalnych PHP i różnych plików konfiguracyjnych.

2. Wykonaj następujące polecenie dla każdego interpretera PHP:

   php -i | findstr /I "PHP Version Architecture Thread Safety extension_dir"
   

   Na Linuksie lub macOS używaj:

   php -i | grep -E "PHP Version|Thread Safety|extension_dir"
   file "$(php -r 'echo PHP_BINARY;')"
   

   Polecenie file podaje architekturę pliku wykonywalnego. Jeśli raportuje uniwersalny plik wykonywalny macOS, wyraźnie wybierz zamierzoną architekturę, np. arch -arm64 php --version lub arch -x86_64 php --version. Używaj tej samej architektury podczas budowania, ładowania i testowania rozszerzeń.

3. Wybierz wydanie sterownika PHP, które obsługuje pomocniczą wersję PHP, system operacyjny oraz docelową bazę danych.

4. Wybierz obsługiwaną wersję sterownika Microsoft ODBC z tabeli zgodności w tym artykule.

5. Dopasuj plik rozszerzenia lub build PIE do architektury PHP i trybu bezpieczeństwa wątków. Nie kopiuj rozszerzenia z innej instalacji PHP, chyba że wszystkie te wartości się zgadzają.

6. Konfiguruj i weryfikuj CLI oraz środowiska uruchomieniowe serwera WWW osobno. Pomyślne wykonanie polecenia php -m dowodzi jedynie, że środowisko uruchomieniowe CLI załadowało rozszerzenie.

PHP

Pobierz pliki binarne PHP ze strony PHP. Wybierz wersję PHP z listy w obsłudze wersji PHP.

• Włącz plik sterownika odpowiadający wersji PHP. Nazwy plików: zobacz Wersje sterowników. Pobierz pliki z Download the Microsoft Drivers for PHP for SQL Server. Instrukcje konfiguracyjne znajdują się w artykule Load the Microsoft Drivers for PHP for SQL Server.

• Wybierz serwer WWW i metodę integracji z PHP obsługiwaną przez PHP oraz framework Twojej aplikacji. Stosuj się do dokumentacji instalacji PHP oraz instrukcji wdrożenia frameworka, aby skonfigurować serwer WWW do uruchamiania PHP. Zweryfikować ładowanie rozszerzenia w środowisku uruchomieniowym serwera WWW oddzielnie od CLI.

Bezpieczeństwo wątkowe i architektura

Plik kompilacji PHP i plik rozszerzenia muszą zgadzać się co do obu wartości.

CLI może korzystać zarówno z bezpiecznej dla wątków lub bezwątkowej wersji PHP. Wybierz rozszerzenie według zgłoszonej wartości, a nie zakładając, że każdy build CLI nie jest bezpieczny wielowątkowo.

sterownik ODBC

Zainstaluj wspierany sterownik Microsoft ODBC dla SQL Server na komputerze, na którym działa PHP. Pobierz sterownik z Download ODBC Driver for SQL Server.

Jeśli pobierasz wersję sterownika systemu Windows w 64-bitowej wersji systemu Windows, instalator 64-bitowy ODBC instaluje zarówno 32-bitowe, jak i 64-bitowe sterowniki ODBC. Jeśli używasz 32-bitowej wersji systemu Windows, użyj instalatora X86 ODBC. Na platformach innych niż Windows dostępne są tylko 64-bitowe wersje sterownika.

Tabela zawiera dotychczasowe kombinacje do planowania modernizacji. Do nowej instalacji użyj aktualnej wersji sterownika PHP oraz wymienionych dla niej wersji ODBC. Kompatybilność ze starszą wersją nie przedłuża jej cyklu wsparcia. Sprawdź zarówno cykl wsparcia sterowników PHP , jak i obsługiwane wersje PHP.

Pusta komórka nie oznacza, że sterownik PHP koniecznie odrzuca tę wersję ODBC. Poszczególne funkcje mogą wymagać nowszych wersji ODBC niż kombinacja bazowa.

Jeśli używasz sterownika SQLSRV, sqlsrv_client_info zwraca informacje o wersji programu SQL Server, której sterownik Microsoft ODBC dla SQL Server jest używany przez sterowniki Microsoft dla PHP dla SQL Server. Jeśli używasz sterownika PDO_SQLSRV, możesz użyć pdO::getAttribute , aby odnaleźć wersję.

SQL Server

Aby poznać wspierane wersje SQL Server, zobacz Obsługiwane wersje bazy danych.

Oceń wsparcie docelowe osobno dla SQL Server, Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, bazy danych SQL w Microsoft Fabric oraz Warehouse w Microsoft Fabric. Wymagania instalacyjne są wymaganiami po stronie klienta i nie oznaczają, że każda metoda uwierzytelniania, opcja połączenia, funkcja Transact-SQL (T-SQL) czy typ danych jest dostępny na każdym celu. Użyj macierzy wsparcia oraz dokumentacji produktu docelowego dla scenariusza, którego używa twoja aplikacja.

Systemy operacyjne

Aby uzyskać informacje o wspieranych systemach operacyjnych, zobacz Wspierane systemy operacyjne.

Wersje sterowników

Każda wersja Microsoft Drivers for PHP for SQL Server zawiera pliki sterowników SQLSRV i PDO_SQLSRV w wariantach bezpiecznych dla wątków i niebezpiecznych dla wątków. Na Windows każda wersja jest również zbudowana z myślą o 32-bitowym i 64-bitowym PHP. Dopasuj plik sterownika do wersji PHP, trybu bezpieczeństwa wielowątkowego i architektury. Aby włączyć plik sterownika po jego pobraniu, zobacz Ładowanie sterowników Microsoft Drivers for PHP for SQL Server.

Na Linuksie i macOS instaluj biblioteki za pomocą PIE, czyli instalatora PHP dla rozszerzeń, zgodnie z instrukcjami instalacji Linuksa i macOS. PIE zastępuje przestarzały system pakietów PHP Extension Community Library (PECL) i nadaje zainstalowanemu rozszerzeniu nazwę sqlsrv.so lub pdo_sqlsrv.so. Poniższe tabele przedstawiają nazwy plików gotowych pakietów binarnych, które ręcznie pobierasz ze strony Microsoft Drivers for PHP for SQL Server Releases.

Poniższe tabele przedstawiają pliki w pakietach wydań 5.13. W nazwach plików ts i nts oznaczają bezpieczny dla wątków, a NTS i TS oznaczają niebezpieczny dla wątków.

Pliki sterowników Windows

Pakiet Windows_5.13.xRTW.zip zawiera te pliki.

Użyj niewątkowego pliku sterownika z niewątkowym buildem PHP oraz wątkowo bezpiecznego pliku sterownika z wątkowo bezpiecznym buildem PHP. Interfejs wiersza poleceń (CLI) może korzystać z dowolnej z dwóch wersji. Aby potwierdzić, jaki masz build, uruchom php -i i sprawdź wartość Thread Safety.

Pliki sterowników Linux i macOS

Pakiety Linux_5.13.xRTW.tar.gz i Mac_5.13.xRTW.tar.gz zawierają te pliki. Archiwum Linuksa zawiera pliki binarne x64, a archiwum macOS zawiera pliki Arm64.

Wstępnie skompilowane pliki muszą również odpowiadać natywnym bibliotekom systemu operacyjnego. Pliki binarne Linuksa 5.13.3 wymagają wersji glibc 2.38 i nowszych oraz środowiska uruchomieniowego C++, które zapewnia GLIBCXX_3.4.32. Pliki binarne macOS 5.13.3 deklarują macOS 26 jako minimalny cel wdrożenia. Te wymagania binarne są odrębne od wsparcia systemu operacyjnego dla kompilacji ze źródeł.

Używaj PIE, gdy architektura pakietu lub wymagania dotyczące natywnej biblioteki nie są zgodne z Twoją instalacją PHP. Kompilacje PIE dla zainstalowanego PHP i natywnych bibliotek. Nie zastępuj ręcznie bibliotek systemowych, aby załadować wstępnie skompilowane rozszerzenie.

Skopiuj każdy plik, którego potrzebujesz, do katalogu rozszerzenia PHP. Możesz zachować nazwę pliku pakietu i zapisać extension=SQLSRV_8.4_NTS.so, albo zmienić nazwę pliku na sqlsrv.so i zapisać krótką formę extension=sqlsrv. Zastosuj ten sam wybór nazwy do PDO_SQLSRV. Aby znaleźć katalog rozszerzenia, uruchom php -i | grep extension_dir. Postępuj zgodnie z instrukcjami w Załaduj sterowniki w systemach Linux i macOS, aby włączyć rozszerzenia w odpowiednim pliku konfiguracyjnym i załadować PHP Data Objects (PDO) przed PDO_SQLSRV.

Wcześniejsze wersje

Aby uzyskać pliki sterowników zawarte w wydaniach wcześniejszych niż 5.13, pobierz pakiet dla tego wydania ze strony wydań Microsoft Drivers for PHP for SQL Server i wyświetl jego zawartość. Wydania przed 5.12 publikują osobny pakiet dla każdego systemu operacyjnego i wersji PHP, zamiast pojedynczego pakietu na platformę.

Zweryfikuj wybrane środowisko

Wykonaj te kontrole po zainstalowaniu rozszerzeń PHP i sterownika ODBC, ale przed skonfigurowaniem serwera WWW:

php --version
php --ini
php --ri sqlsrv
php --ri pdo_sqlsrv

Ostatnie dwa polecenia muszą wyświetlać oddzielne sekcje informacji o module. Jeśli któreś z poleceń zgłasza brak rozszerzenia, zakończ procedurę instalacji i ładowania platformy przed testowaniem połączenia z bazą danych.

Stwórz verify-php-drivers.php tak, aby sprawdzić oba API PHP bez potrzeby danych logowania:

<?php
$failures = [];

if (!extension_loaded('sqlsrv') || !function_exists('sqlsrv_connect')) {
    $failures[] = 'SQLSRV is not loaded.';
}

if (!extension_loaded('pdo_sqlsrv') || !in_array('sqlsrv', PDO::getAvailableDrivers(), true)) {
    $failures[] = 'PDO_SQLSRV is not loaded.';
}

echo $failures === []
    ? "SQLSRV and PDO_SQLSRV are loaded." . PHP_EOL
    : implode(PHP_EOL, $failures) . PHP_EOL;

exit($failures === [] ? 0 : 1);

Uruchom go z plikiem wykonywalnym PHP, który obsługuje aplikację:

php verify-php-drivers.php

Oczekiwane dane wyjściowe:

SQLSRV and PDO_SQLSRV are loaded.

Ta kontrola weryfikuje ładowanie rozszerzenia. Nie weryfikuje łączności ODBC, uwierzytelniania, zaufania certyfikatów, dostępu do sieci ani uprawnień do bazy danych.

Usuń verify-php-drivers.php po nagraniu wyniku.

Diagnozowanie niepowodzeń wymagań

Treści powiązane

• Wprowadzenie do sterowników firmy Microsoft dla języka PHP dla programu SQL Server
• Przewodnik programowania dla sterowników firmy Microsoft dla języka PHP dla programu SQL Server
• Dokumentacja interfejsu API sterownika SQLSRV
• dokumentacja sterownika PDO_SQLSRV