Načítání ovladačů Microsoft pro PHP pro SQL Server

Tato stránka obsahuje pokyny pro načtení ovladačů Microsoft pro PHP pro SQL Server do prostoru procesu PHP.

Nainstalujte ovladače na Windows přes PIE

PIE, instalátor PHP pro rozšíření, instaluje odpovídající předkompilované soubory ovladačů a aktivuje je v příkazové konfiguraci PHP. Windows nepotřebuje sadu nástrojů pro sestavení.

Nainstalujte podporovanou verzi PHP a ovladač Microsoft ODBC pro SQL Server.
Spusťte php --ini. Pokud je Načtený konfigurační soubor(none), zkopírujte php.ini-development z instalačního adresáře PHP do php.ini ve stejném adresáři.
V php.ini nastavte adresář pro rozšíření a povolte rozšíření openssl a zip:
```
extension_dir = "ext"
extension=openssl
extension=zip
```
Z zapisovatelného pracovního adresáře si stáhněte nejnovější stabilní pie.pharverzi. Příkaz funguje v příkazovém řádku a PowerShellu:
```
curl.exe -fL --output pie.phar https://github.com/php/pie/releases/latest/download/pie.phar
```
Pokud máte GitHub CLI, ověřte, že PHP Foundation soubor publikovala:
```
gh attestation verify --owner php .\pie.phar
```

Nainstalujte oba ovladače pomocí spustitelného souboru PHP na PATH:

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

Ověřte, že stejné běhové prostředí PHP pro příkazový řádek načítá oba ovladače:
```
php --ri sqlsrv
php --ri pdo_sqlsrv
```

Pro další metody instalace PIE viz dokumentaci k použití PIE.

Nainstalujte ovladače na Linux a macOS

Nainstalujte ovladače a jejich platformní závislosti pomocí PIE, jak je popsáno v instalačním tutoriálu pro Linux a macOS.

Instalujte předpřipravené ovladače ručně

Předpřipravené ovladače si můžete stáhnout ze stránky Microsoft Drivers for PHP for SQL Server. Balíček ke stažení pro Windows je soubor ZIP, který obsahuje soubory ovladačů SQLSRV a PDO_SQLSRV pro každou podporovanou verzi PHP, architekturu a režim zabezpečení vláken. Vyberte soubory, které odpovídají vašemu PHP prostředí. Viz Systémové požadavky pro seznam souborů.

Ovladače můžete také sestavit ze zdroje buď při sestavování PHP, nebo pomocí .phpize Pokud se rozhodnete sestavit ovladače ze zdroje, máte při sestavování PHP možnost je staticky sestavit do PHP místo toho, abyste je vytvářeli jako sdílená rozšíření přidáním --enable-sqlsrv=static --with-pdo_sqlsrv=static (v Linuxu a macOS) nebo --enable-sqlsrv=static --with-pdo-sqlsrv=static (ve Windows) do ./configure příkazu. Další informace o systému sestavení PHP a phpizenaleznete v dokumentaci k PHP.

Přesunutí souboru ovladače do adresáře rozšíření

Soubor ovladače musí být umístěn v adresáři, kde ho může modul runtime PHP najít. Nejjednodušší je umístit soubor ovladače do výchozího adresáře rozšíření PHP – pokud chcete najít výchozí adresář, spustit php -i | sls extension_dir ve Windows nebo php -i | grep extension_dir v Linuxu nebo macOS. Pokud nepoužíváte výchozí adresář rozšíření, zadejte adresář v konfiguračním souboru PHP (php.ini), pomocí možnosti extension_dir . Pokud například ve Windows vložíte soubor ovladače do adresáře c:\php\ext , přidejte do php.ininásledující řádek:

extension_dir = "c:\PHP\ext"

Načtení ovladače při spuštění PHP

Pokud chcete načíst ovladač SQLSRV při spuštění PHP, nejprve přesuňte soubor ovladače do adresáře rozšíření. Pak postupujte takto:

Chcete-li povolit ovladač SQLSRV, upravte php.ini přidáním následujícího řádku do oddílu rozšíření, a změňte název souboru podle potřeby pro vaši verzi PHP a pro instalace typu thread-safe a non-thread-safe:

V systému Windows:
```
extension=php_sqlsrv_83_ts.dll
```
Pokud jste v Linuxu stáhli předem připravené binární soubory pro vaši distribuci:
```
extension=php_sqlsrv_83_nts.so
```
Pokud jste zkompilovali SQLSRV binární soubor ze zdroje, nebo ho nainstalovali s PIE či PECL, jeho název je sqlsrv.so:
```
extension=sqlsrv.so
```
Pro povolení ovladače PDO_SQLSRV musí být rozšíření PHP Data Objects (PDO) dostupné, buď jako vestavěné rozšíření, nebo jako dynamicky načítané rozšíření.

Na Windows přicházejí předem připravené binární soubory PHP s integrovaným PDO, takže není nutné upravovat php.ini, aby se načetlo. Pokud jste však zkompilovali PHP ze zdroje a zadali samostatné rozšíření PDO, které se má sestavit, jeho název je php_pdo.dlla musíte ho zkopírovat do adresáře rozšíření a přidat následující řádek do php.ini:
```
extension=php_pdo.dll
```
Pokud jste v Linuxu nainstalovali PHP pomocí správce balíčků systému, pravděpodobně se pdo nainstaluje jako dynamicky načtené rozšíření s názvem pdo.so. Rozšíření PDO musí být načteno před rozšířením PDO_SQLSRV, jinak se načtení nezdaří. Přípony se načítají pomocí jednotlivých souborů .ini a tyto soubory se čtou po php.ini. Proto pokud se pdo.so načítá prostřednictvím vlastního souboru .ini, je vyžadován samostatný soubor, který načítá ovladač PDO_SQLSRV po načtení PDO.

Pokud chcete zjistit, který adresář se nachází .ini soubory specifické pro příponu, spusťte php --ini a poznamenejte si adresář uvedený v části Scan for additional .ini files in:. Vyhledejte soubor, který načte pdo.so. Měla by mít předponu číslo, například 10-pdo.ini. Číselná předpona označuje pořadí načítání souborů .ini, zatímco soubory, které nemají číselnou předponu, se načítají abecedně. Vytvořte soubor pro načtení souboru ovladače PDO_SQLSRV s názvem buď 30-pdo_sqlsrv.ini (jakékoli číslo větší než číslo, které předchází pdo.ini) nebo pdo_sqlsrv.ini (pokud pdo.ini není předponou čísla), a přidejte do něj následující řádek, podle potřeby upravte název souboru.
```
extension=php_pdo_sqlsrv_3_nts.so
```
Stejně jako u SQLSRV, pokud jste PDO_SQLSRV binární soubor zkompilovali ze zdrojového kódu nebo ho nainstalovali s PIE či PECL, jeho název je pdo_sqlsrv.so:
```
extension=pdo_sqlsrv.so
```
Zkopírujte tento soubor do adresáře, který obsahuje ostatní soubory .ini.

Pokud jste zkompilovali PHP ze zdroje s integrovanou podporou PDO, nepotřebujete samostatný soubor .ini a předchozí řádek můžete přidat do php.ini.
Restartujte webový server.

Poznámka:

Chcete-li zjistit, zda je ovladač úspěšně načten, spusťte skript, který volá phpinfo().

Další informace o direktiváchphp.ini naleznete v tématu Popis základních php.ini direktiv.

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-09-25