Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Sterowniki SQLSRV i PDO_SQLSRV to rozszerzenia PHP. PHP ładuje je na początku procesu PHP, odczytując php.ini i wczytując dodatkowe .ini pliki.
Wczytywanie jest oddzielne od instalacji. Kopiowanie lub budowanie rozszerzenia umieszcza plik na dysku. PHP nie może używać SQLSRV ani PDO_SQLSRV, dopóki aktywna konfiguracja nie zawiera poprawnego wpisu i proces PHP się nie zrestartuje.
Chroń strony diagnostyczne sieci Web
Przed utworzeniem tymczasowej strony phpinfo() skonfiguruj serwer WWW tak, aby zezwalał tylko na żądania z localhosta lub od uwierzytelnionych administratorów. Zachowaj to ograniczenie do momentu usunięcia strony.
phpinfo() może udostępniać zmienne środowiskowe, dane uwierzytelniające i konfigurację serwera. Usuń stronę natychmiast po weryfikacji.
Zrozum zakres konfiguracji PHP
Każdy interfejs programowania aplikacji serwerowych PHP (SAPI) może używać innego pliku wykonywalnego i konfiguracji:
| Runtime | Typowe źródło konfiguracji | Jak go rozpoznać |
|---|---|---|
| Interfejs wiersza polecenia | Katalog skanowania php.ini i katalog skanowania zgłoszone przez php --ini |
Uruchom php --ini przy użyciu dokładnie tego pliku wykonywalnego |
| IIS FastCGI | Plik wykonywalny PHP skonfigurowany w aplikacji IIS FastCGI | Użyj tymczasowej strony phpinfo() |
| Moduł Apache | Konfiguracja modułu PHP w Apache | Użyj tymczasowej phpinfo() stronę |
| PHP-FPM | Plik wykonywalny FPM, pula, php.ini, oraz katalog skanowania |
Uruchom wersjonowany plik binarny FPM za pomocą -i lub użyj tymczasowej strony phpinfo() |
| Długotrwale działający proces roboczy | Plik wykonywalny i środowisko, które uruchomiły proces roboczy | Sprawdź usługę workera i zrestartuj ją po zmianach |
Zmiana konfiguracji CLI nie wpływa na konfigurację IIS, Apache ani PHP-FPM, gdy używają innej instalacji PHP lub katalogu skanowania.
Znajdź konfigurację PHP
Wykonaj te polecenia za pomocą pliku wykonywalnego PHP używanego przez Twoją aplikację:
php --ini
php -i | findstr /I "PHP Version Thread Safety Architecture extension_dir"
W systemie Linux lub macOS zastąp findstr elementem grep:
php -i | grep -E "PHP Version|Thread Safety|extension_dir"
file "$(php -r 'echo PHP_BINARY;')"
Polecenie file identyfikuje architekturę wybranego pliku wykonywalnego. Aby utworzyć uniwersalny plik wykonywalny macOS, należy stosować jawny wybór architektury.
Wartości Załadowany plik konfiguracyjny oraz Skanuj dodatkowe pliki .ini w identyfikują konfigurację używaną przez proces wiersza poleceń. Serwer WWW lub proces PHP FastCGI Process Manager (PHP-FPM) może używać innego pliku wykonywalnego PHP lub pliku konfiguracyjnego. Użyj tymczasowej strony phpinfo(), aby zidentyfikować wartości tego procesu.
Przed edycją pliku zapisz:
- Ścieżka i wersja pliku wykonywalnego PHP.
- Załadowano
php.inielement. - Dodatkowy katalog skanów
.ini. - Katalog rozszerzenia.
- Tryb bezpieczeństwa wielowątkowego i architektura.
- Każdy proces, który musisz zrestartować.
Zrób kopię zapasową każdego pliku konfiguracyjnego, który zmienisz.
Załaduj sterowniki na Windows
Przy instalacji z instalatorem PHP dla rozszerzeń (PIE) najpierw pobierz i zweryfikuj PIE. Wykonaj następujące polecenia z katalogu zawierającego pie.phar, używając pliku wykonywalnego PHP, który powinien ładować sterowniki:
php .\pie.phar install microsoft/sqlsrv
php .\pie.phar install microsoft/pdo_sqlsrv
PIE instaluje php_sqlsrv.dll i php_pdo_sqlsrv.dll. Jeśli PIE nie może automatycznie włączyć rozszerzeń, usuń wszystkie istniejące SQLSRV i PDO_SQLSRV wpisy z aktywnego php.ini, a następnie dodaj:
extension=php_sqlsrv.dll
extension=php_pdo_sqlsrv.dll
Używaj tylko jednego rekordu dla każdego kierowcy. Po zmianie konfiguracji ponownie uruchom proces PHP.
Dla instalacji ZIP skopiuj biblioteki DLL, które odpowiadają pomocniczej wersji PHP, architekturze i trybowi bezpieczeństwa wątków, do katalogu extension_dir. Środowisko uruchomieniowe PHP 8.5 x64 bezpieczne dla wątków używa następujących nazw plików:
php_sqlsrv_85_ts_x64.dll
php_pdo_sqlsrv_85_ts_x64.dll
Dodaj obie nazwy plików do elementu php.ini, którego używa proces PHP:
extension=php_sqlsrv_85_ts_x64.dll
extension=php_pdo_sqlsrv_85_ts_x64.dll
Zastąp 85, ts, i x64 wartościami dla twojego środowiska uruchomieniowego PHP. Nie mieszaj plików bezpiecznych dla wątków i niebezpiecznych dla wątków, plików 32-bitowych i 64-bitowych ani plików stworzonych dla innej wersji PHP.
Załaduj sterowniki na Linuksie i macOS
Zainstaluj sterowniki za pomocą PIE. Więcej informacji znajdziesz w samouczku instalacji systemów Linux i macOS. PIE instaluje pliki rozszerzenia i próbuje je włączyć, korzystając z narzędzi konfiguracyjnych PHP platformy lub dodając wpis extension= do dodatkowego pliku .ini lub standardowego pliku php.ini. Jeśli PIE raportuje, że nie udało się włączyć rozszerzenia, dodaj sam wpis i zweryfikowaj aktywną konfigurację.
Do ręcznej instalacji wybierz .so wstępnie skompilowane pliki odpowiadające wersji PHP, architekturze, trybowi bezpieczeństwa wątków oraz natywnym bibliotekom systemu operacyjnego. Sprawdź wymagania dla wstępnie skompilowanych wersji systemów Linux i macOS; użyj PIE, jeśli nie pasują do twojego środowiska.
Na przykład pliki PHP 8.4 niewątkowo bezpieczne mają nazwy SQLSRV_8.4_NTS.so i PDO_SQLSRV_8.4_NTS.so. Umieść je w katalogu zwróconym przez php -i | grep extension_dir. Zmień ich nazwy na sqlsrv.so i pdo_sqlsrv.so, aby użyć następujących wpisów, lub zamiast tego użyj we wpisach dokładnych nazw plików pakietów. Dodaj wpisy do aktywnej konfiguracji PHP w kolejności ładowania opisanej w tej sekcji:
extension=sqlsrv.so
extension=pdo_sqlsrv.so
Obiekty danych PHP (PDO) muszą się załadować przed PDO_SQLSRV. PHP odczytuje php.ini przed zeskanowaniem kolejnych .ini plików w kolejności alfabetycznej. Jeśli dystrybucja ładuje pdo.so z zeskanowanego pliku, umieść wpis PDO_SQLSRV w później zeskanowanym pliku, na przykład 30-pdo_sqlsrv.ini gdy PDO używa 10-pdo.ini. W takim przypadku nie umieszczaj wpisu PDO_SQLSRV w php.ini.
Wybierz wpisy rozszerzeń
Używaj wpisów odpowiadających sposobowi instalacji sterowników:
| Platforma i metoda | Wpis SQLSRV | PDO_SQLSRV wpis |
|---|---|---|
| Windows z PIE | extension=php_sqlsrv.dll |
extension=php_pdo_sqlsrv.dll |
| Windows odblokował plik ZIP | Dokładna nazwa DLL z oznaczeniem wersji, taka jak extension=php_sqlsrv_85_ts_x64.dll |
Dokładna nazwa DLL z numerem wersji, taka jak extension=php_pdo_sqlsrv_85_ts_x64.dll |
| Linux lub macOS z PIE | extension=sqlsrv.so |
extension=pdo_sqlsrv.so |
| Archiwum wydania dla systemu Linux lub macOS, pliki po zmianie nazwy | extension=sqlsrv.so |
extension=pdo_sqlsrv.so |
| Archiwum dla systemu Linux lub macOS, oryginalne pliki | Dokładna nazwa pliku archiwum, na przykład extension=SQLSRV_8.4_NTS.so |
Dokładna nazwa pliku archiwum, na przykład extension=PDO_SQLSRV_8.4_NTS.so |
Nie konfiguruj zarówno krótkiej, jak i wersjonowanej nazwy dla tego samego rozszerzenia. PHP może raportować, że moduł jest już załadowany, lub kontynuować ładowanie starszego pliku po aktualizacji.
Zrestartuj PHP, aby załadować sterowniki
Restartuj proces po zmianie pliku rozszerzenia lub pliku konfiguracyjnego. Zrestartuj serwer WWW, PHP-FPM, workerów kolejek i inne długo działające procesy PHP, które ładują sterownik.
Rozszerzenia SQLSRV i PDO_SQLSRV można ładować osobno, ale należy zainstalować i zweryfikować oba, gdy aplikacja korzysta z obu sterowników. PDO jest wbudowane w wiele pakietów PHP. Jeśli PDO nie jest wbudowane, włącz rozszerzenie PDO przed PDO_SQLSRV.
Sprawdź załadowane sterowniki
Dla środowiska uruchomieniowego wiersza poleceń wykonaj:
php --ri sqlsrv
php --ri pdo_sqlsrv
php -m | findstr /I "sqlsrv pdo_sqlsrv"
W systemie Linux lub macOS użyj:
php --ri sqlsrv
php --ri pdo_sqlsrv
php -m | grep -E "sqlsrv|pdo_sqlsrv"
Dla serwera WWW należy ograniczyć dostęp do stron diagnostycznych przed utworzeniem tymczasowej strony zawierającej <?php phpinfo(); ?>. Potwierdź załadowany plik konfiguracyjny, extension_dir oraz oddzielne sekcje sqlsrv i pdo_sqlsrv. Usuń stronę po weryfikacji.
Wykonaj też sprawdzenie na poziomie PHP, aby weryfikacja obejmowała oba API, a nie tylko nazwy modułów. Zapisz ten program jako verify-php-drivers.php:
<?php
$checks = [
'SQLSRV extension' => extension_loaded('sqlsrv'),
'SQLSRV API' => function_exists('sqlsrv_connect'),
'PDO_SQLSRV extension' => extension_loaded('pdo_sqlsrv'),
'PDO_SQLSRV API' => class_exists('PDO')
&& in_array('sqlsrv', PDO::getAvailableDrivers(), true),
];
$failed = false;
foreach ($checks as $name => $passed) {
echo $name . ': ' . ($passed ? 'loaded' : 'missing') . PHP_EOL;
$failed = $failed || !$passed;
}
exit($failed ? 1 : 0);
Uruchom program z każdym plikiem wykonywalnym PHP, którego używa twoja aplikacja:
php verify-php-drivers.php
Oczekiwane dane wyjściowe:
SQLSRV extension: loaded
SQLSRV API: loaded
PDO_SQLSRV extension: loaded
PDO_SQLSRV API: loaded
W czasie uruchomienia webowego umieść plik tymczasowo w katalogu głównym dokumentów i otwórz go w przeglądarce. Usuń go po weryfikacji. Ten program nie otwiera połączenia z bazą danych ani nie wyświetla wartości konfiguracyjnych.
Usuń verify-php-drivers.php po zakończeniu CLI i testów web-runtime.
Rozwiązywanie problemów z ładowaniem sterowników
| Objaw | Sprawdź przyczynę | Akcja naprawcza |
|---|---|---|
Unable to load dynamic library |
Błędna nazwa pliku, extension_dir, wersja PHP minor, architektura lub tryb bezpieczeństwa wątku |
Porównaj php -i z wybranym plikiem sterownika i tymczasowo użyj ścieżki absolutnej, aby wyizolować błędy ścieżki |
The specified module could not be found w systemie Windows |
Sterownik DLL lub jedna z jego zależności nie jest dostępna | Potwierdź, że DLL jest w extension_dir, zainstaluj odpowiadające środowisko wykonawcze Visual C++ i sprawdź wszelkie brakujące zależności DLL |
undefined symbol lub błąd współdzielonej biblioteki na Linuksie lub macOS |
Niedopasowanie między rozszerzeniem a budową PHP lub brakującą zależnością ODBC | Odbuduj z docelowym php-config, a następnie sprawdź zgłoszoną brakującą bibliotekę |
Module "sqlsrv" is already loaded |
Zduplikowane wpisy lub dwa zeskanowane pliki | Przeszukaj załadowany php.ini i katalog skanowania, a następnie zachowaj jeden wpis |
could not find driver z PDO |
PDO_SQLSRV nie jest załadowany albo PDO ładuje się po nim | Sprawdź php --ri pdo_sqlsrv i przesuń wpis PDO_SQLSRV po PDO |
| CLI działa, ale żądania webowe kończą się niepowodzeniem | Inna konfiguracja SAPI lub proces, który nie został zrestartowany | Porównaj CLI i phpinfo() wartości konfiguracyjne, edytuj konfigurację webową i restartuj proces webowy |
Stare ExtensionVer pozostaje po aktualizacji |
Konfiguracja nadal wskazuje na starszy plik z numerem wersji | Zastąp stary wpis plikiem zainstalowanym przez wybraną metodę, usuń duplikaty i zrestartuj wszystkie procesy PHP |
PHP odpowiada za wykrywanie rozszerzeń i kolejność ładowania. PIE lub ręczne kopiowanie dostarcza plik rozszerzenia. Program rozruchowy systemu operacyjnego rozwiązuje natywne zależności. Sterownik Microsoft ODBC przejmuje obsługę protokołu bazy danych po załadowaniu rozszerzenia.