A Microsoft PHP-illesztőprogramok betöltése az SQL Serverhez

PHP-illesztőprogram letöltése

Ez az oldal útmutatást nyújt a Microsoft PHP-illesztőprogramok az SQL Serverhez PHP-folyamattérbe való betöltéséhez.

A saját platformjához előre összeállított illesztőprogramokat a Microsoft Drivers for PHP SQL Serverhez készült GitHub projektoldaláról töltheti le. Minden telepítési csomag SQLSRV- és PDO_SQLSRV illesztőfájlokat tartalmaz szálas és nem szálas változatokban. Windows rendszeren 32 bites és 64 bites változatokban is elérhetők. Az egyes csomagokban található illesztőprogram-fájlok listájáért tekintse meg az SQL Server PHP-hez készült Microsoft Drivers rendszerkövetelményei című témakört. Az illesztőfájlnak meg kell egyeznie a PHP-környezet PHP-verziójával, architektúrával és szálasságával.

Linuxon és macOS rendszeren az illesztőprogramok a PECL használatával is telepíthetők, ahogyan az a telepítési oktatóanyagban található.

A PHP fordításakor vagy a phpize használatával az illesztőprogramokat is létrehozhatja forrásból. Ha úgy dönt, hogy forrásból hozza létre az illesztőprogramokat, lehetősége van statikusan a PHP-be építeni őket ahelyett, hogy megosztott bővítményekként építenél fel őket úgy, hogy hozzáadod --enable-sqlsrv=static --with-pdo_sqlsrv=static (Linuxon és macOS rendszeren) vagy --enable-sqlsrv=static --with-pdo-sqlsrv=static (Windows rendszeren) a parancshoz a ./configure PHP létrehozásakor. További információ a PHP buildrendszerről, és phpizetekintse meg a PHP dokumentációját.

Az illesztőprogram-fájl áthelyezése a bővítménykönyvtárba

Az illesztőfájlnak olyan könyvtárban kell lennie, ahol a PHP-futtatókörnyezet megtalálja. Az illesztőfájlt a legegyszerűbb az alapértelmezett PHP-bővítménykönyvtárba helyezni – az alapértelmezett könyvtár megkereséséhez futtassa a php -i | sls extension_dir parancsot Windows rendszeren vagy a php -i | grep extension_dir parancsot Linux/macOS rendszeren. Ha nem az alapértelmezett bővítménykönyvtárat használja, adjon meg egy könyvtárat a PHP konfigurációs fájlban (php.ini), a extension_dir beállítással. Windows rendszeren például, ha az illesztőprogramot a c:\php\ext könyvtárba helyezte, a következő sort adja hozzá a php.ini fájlhoz:

extension_dir = "c:\PHP\ext"  

Az illesztőprogram betöltése a PHP indításkor

Ha a PHP indításakor szeretné betölteni az SQLSRV-illesztőt, először helyezzen át egy illesztőprogramfájlt a bővítménykönyvtárba. Ezután kövesse az alábbi lépéseket:

1. Az SQLSRV-illesztő engedélyezéséhez módosítsa aphp.ini úgy, hogy hozzáadja a következő sort a bővítményszakaszhoz, és szükség szerint módosítsa a fájlnevet:

   Windows rendszeren:

   extension=php_sqlsrv_82_ts.dll  
   

   Linuxon, ha letöltötte a disztribúció előre összeállított bináris fájljait:

   extension=php_sqlsrv_82_nts.so  
   

   Ha az SQLSRV bináris fájlt a forrásból vagy a PECL-ből állította össze, akkor az sqlsrv.so lesz a neve:

   extension=sqlsrv.so
   

2. Az PDO_SQLSRV illesztőprogram engedélyezéséhez a PHP Data Objects (PDO) bővítménynek elérhetőnek kell lennie beépített bővítményként vagy dinamikusan betölthető bővítményként.

   Windows rendszeren az előre összeállított PHP bináris fájlok beépített PDO-val vannak eladva, így nincs szükség php.ini módosítására a betöltéséhez. Ha azonban forráskódból fordította a PHP-t, és külön PDO kiterjesztést adott meg, azt php_pdo.dll néven kell átmásolnia a bővítménykönyvtárba, és hozzá kell adnia a következő sort a php.ini fájlhoz:

   extension=php_pdo.dll  
   

   Linux-on, ha a rendszer csomagkezelőjével telepítette a PHP-t, akkor a PDO valószínűleg dinamikusan betöltött bővítményként van telepítve pdo.so néven. Az PDO-bővítményt be kell tölteni a PDO_SQLSRV bővítmény előtt, különben a betöltés sikertelen lesz. A bővítmények általában egyéni .ini fájlok használatával töltődnek be, és ezek a fájlok php.iniután lesznek beolvasva. Ezért, ha a pdo.so be van töltve a saját .ini fájlja által, szükséges egy külön fájl, amely a PDO után tölti be a PDO_SQLSRV illesztőt.

   Ha meg szeretné tudni, hogy melyik könyvtárban találhatók a bővítményspecifikus .ini fájlok, futtassa php --ini és jegyezze fel a listában felsorolt Scan for additional .ini files in:könyvtárat. Keresse meg a pdo.so betöltő fájlt. Valószínűleg egy szám előtaggal rendelkezik, például 10-pdo.ini. A numerikus előtag a .ini fájlok betöltési sorrendjét jelzi, míg a numerikus előtaggal nem rendelkező fájlok betűrendben vannak betöltve. Hozzon létre egy fájlt a PDO_SQLSRV driver betöltéséhez, amelynek neve lehet 30-pdo_sqlsrv.ini (bármely szám, amely nagyobb, mint a pdo.ini prefixálására használt szám), vagy pdo_sqlsrv.ini (ha a pdo.ini nem rendelkezik szám előtaggal), és adja hozzá a következő sort, szükség szerint módosítva a fájlnevet:

   extension=php_pdo_sqlsrv_82_nts.so
   

   Az SQLSRV-hez hasonlóan, ha a forrásból vagy a PECL-ből állította össze a PDO_SQLSRV bináris fájlt, akkor az pdo_sqlsrv.so lesz a neve:

   extension=pdo_sqlsrv.so
   

   Másolja ezt a fájlt a többi .ini fájlt tartalmazó könyvtárba.

   Ha a PHP-t beépített PDO-támogatással állította össze a forrásból, nincs szükség külön .ini fájlra, és hozzáadhatja a fenti sort a php.ini fájlhoz.

3. Indítsa újra a webkiszolgálót.

Megjegyzés:

Annak megállapításához, hogy az illesztőprogram betöltése sikeresen megtörtént-e, futtasson egy phpinfo()-t hívó szkriptet.

A php.ini irányelvekről további információt az alapvető php.ini irányelvek leírásában talál.

Lásd még:

Ismerkedés az SQL Serverhez készült PHP-hez készült Microsoft-illesztőprogramokkal

Az SQL Serverhez készült PHP-hez készült Microsoft Drivers rendszerkövetelményei

Programozási útmutató a Microsoft által az SQL Serverhez készült PHP-illesztőprogramokhoz

SQLSRV Driver API-referencia

PDO_SQLSRV Driver API-referencia