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

Stáhnout ovladač PHP

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

Předem připravené ovladače pro vaši platformu si můžete stáhnout ze stránky projektu Microsoft Drivers for PHP pro SQL Server GitHub. Každý instalační balíček obsahuje soubory ovladačů SQLSRV a PDO_SQLSRV ve variantách s vlákny a bez vláken. Ve Windows jsou k dispozici také v 32bitových a 64bitových variantách. Seznam souborů ovladačů, které jsou obsaženy v jednotlivých balíčcích, najdete v tématu Systémové požadavky pro ovladače pro PHP pro SQL Server . Soubor ovladače se musí shodovat s verzí, architekturou PHP a vlákny vašeho prostředí PHP.

V Linuxu a macOS je možné ovladače nainstalovat pomocí PECL, jak je uvedeno v instalačním kurzu.

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. Soubor ovladače je nejjednodušší umístit 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 jste například v systému Windows umístili 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:

1. Pokud chcete povolit ovladač SQLSRV , upravte php.ini přidáním následujícího řádku do oddílu rozšíření a podle potřeby změňte název souboru:

   V systému Windows:

   extension=php_sqlsrv_82_ts.dll  
   

   Pokud jste si v Linuxu stáhli předem připravené binární soubory pro vaši distribuci:

   extension=php_sqlsrv_82_nts.so  
   

   Pokud jste zkompilovali binární soubor SQLSRV ze zdroje nebo s PECL, bude místo toho pojmenován sqlsrv.so:

   extension=sqlsrv.so
   

2. Pokud chcete povolit ovladač PDO_SQLSRV , musí být rozšíření PHP Data Objects (PDO) k dispozici, a to buď jako integrované rozšíření, nebo jako dynamicky načtené rozšíření.

   Na Windows jsou předem připravené binární soubory PHP, které již obsahují PDO, takže není nutné upravovat php.ini, aby se PDO načetlo. Pokud jste však zkompilovali PHP ze zdroje a zadali samostatné rozšíření PDO, které se má sestavit, bude pojmenováno 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, pdo se pravděpodobně 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ří. Rozšíření se obvykle načítají pomocí jednotlivých .ini souborů 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. Pravděpodobně je předpona číslem, 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 30-pdo_sqlsrv.ini (jakékoli číslo větší než číslo, které předchází pdo.ini, funguje) nebo pdo_sqlsrv.ini (pokud pdo.ini není předcházeno číslem) a přidejte do něj následující řádek, podle potřeby změňte název souboru:

   extension=php_pdo_sqlsrv_82_nts.so
   

   Stejně jako u SQLSRV, pokud jste zkompilovali PDO_SQLSRV binární soubor ze zdroje nebo s PECL, bude místo toho pojmenován 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ý .ini soubor a můžete přidat odpovídající řádek nad php.ini.

3. Restartujte webový server.

Poznámka:

Chcete-li zjistit, zda byl 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.

Viz také

Začínáme s ovladači Microsoftu pro PHP pro SQL Server

Požadavky na systém pro ovladače Microsoftu pro PHP pro SQL Server

Průvodce programováním pro ovladače Microsoftu pro PHP pro SQL Server

Referenční informace k rozhraní API ovladače SQLSRV

Referenční informace k rozhraní API ovladače PDO_SQLSRV