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

Ez a lap útmutatást nyújt az SQL Serverhez készült PHP-illesztőprogramok betöltésére a PHP-folyamattérbe.

Telepítsd a drivereket Windows-ra PIE-val

PIE, a PHP-bővítmények telepítője, telepíti a megfelelő előre lefordított illesztőprogram-fájlokat, és engedélyezi őket a PHP parancssori konfigurációjában. A Windows-nak nincs szüksége építési eszközláncra.

  1. Telepíts egy támogatott PHP verziót és a Microsoft ODBC Driver for SQL Server-t.

  2. Futtassa a php --ini programot. Ha a betöltött konfigurációs fájl(none), másolja át a php.ini-development fájlt a PHP telepítési könyvtárából a php.ini fájlba ugyanabban a könyvtárban.

  3. php.ini-ben beállítsuk a bővítménykönyvtárat, és engedélyezzük a openssl és zip kiterjesztéseket:

    extension_dir = "ext"
extension=openssl
extension=zip

  4. Egy írható munkakönyvtárból töltsd le a legújabb stabil pie.phar. A parancs a Parancssorban és PowerShellben működik:

    curl.exe -fL --output pie.phar https://github.com/php/pie/releases/latest/download/pie.phar

    Ha megvan a GitHub CLI-d, ellenőrizd, hogy a PHP Alapítvány közzétette a fájlt:

    gh attestation verify --owner php .\pie.phar

  5. Telepítse mindkét illesztőprogramot a(z) PATH rendszerű PHP futtatható fájl használatával:

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

  6. Ellenőrizd, hogy ugyanaz a PHP parancssori futás tölti be mindkét meghajtót:

    php --ri sqlsrv
php --ri pdo_sqlsrv

További PIE telepítési módszerekért lásd a PIE használati dokumentációt.

Telepítsd a drivereket Linuxon és macOS-en

Telepítsd a drivereket és azok platformfüggőségeit a PIE-vel, ahogy azt a Linux és macOS telepítési útmutatóban leírjuk.

Előre telepített driverek kézzel telepíthető

A Microsoft Drivers for PHP for SQL Server oldalról letöltheti az előre elkészített illesztőprogramokat. A Windows rendszerhez készült letöltés egy ZIP-fájl, amely SQLSRV- és PDO_SQLSRV-illesztőprogram-fájlokat tartalmaz az összes támogatott PHP-verzió, architektúra és szálbiztonsági mód esetében. Válaszd ki azokat a fájlokat, amelyek megfelelnek a PHP környezetednek. Lásd: Rendszerkövetelmények a fájllistához.

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 Windows rendszeren vagy a php -i | grep extension_dir 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. Például Windows rendszeren, ha az illesztőprogram fájlt a c:\php\ext könyvtárba helyezi, adja hozzá a következő sort a php.ini-hez:

extension_dir = "c:\PHP\ext"

Az illesztőprogram betöltése 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-meghajtó engedélyezéséhez módosítsa a php.ini fájlt úgy, hogy hozzáadja a következő sort a bővítményszakaszhoz, a PHP-verziójának megfelelően, illetve figyelembe véve a szálbiztos és nem szálbiztos telepítés közötti különbséget, változtassa meg a fájlnevet.

    Windows rendszeren:

    extension=php_sqlsrv_83_ts.dll

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

    extension=php_sqlsrv_83_nts.so

    Ha az SQLSRV binárist forrásból fordítottad, vagy PIE vagy PECL-lel telepítetted, a neve sqlsrv.so:

    extension=sqlsrv.so

  2. A PDO_SQLSRV meghajtó engedélyezéséhez a PHP Data Objects (PDO) kiterjesztésnek elérhetőnek kell lennie, akár beépített kiterjesztésként, akár dinamikusan betöltött kiterjesztésként.

    Windows rendszeren az előre összeállított PHP bináris fájlok készen található beépített PDO-val, így nincs szükség php.ini módosítására a betöltéséhez. Ha azonban a PHP-t a forrásból fordította le, és külön PDO bővítményt adott meg, amelynek neve php_pdo.dll, akkor át kell másolnia a bővítménykönyvtárba, és hozzá kell adnia a következő sort a php.ini-hez:

    extension=php_pdo.dll

    Linuxon, ha a rendszer csomagkezelőjével telepítette a PHP-t, a PDO valószínűleg egy dinamikusan betöltött bővítményként van telepítve pdo.so néven. A PDO bővítményt be kell tölteni, mielőtt a PDO_SQLSRV bővítmény, különben a betöltés kudarcot vall. A bővítmények egyes .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. Egy számmal kell előtaggal rendelkeznie, 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 illesztő betöltéséhez, amelynek a neve legyen vagy 30-pdo_sqlsrv.ini (ha egy, pdo.ini által használt sorszámnál nagyobb szám lehet hozzáfűzve), vagy pdo_sqlsrv.ini (ha a pdo.ini-hez nincs egy számos előtag), majd adja hozzá a következő sort, és módosítsa a fájlnevet a helyzetnek megfelelően:

    extension=php_pdo_sqlsrv_3_nts.so

    Ahogy az SQLSRV esetében, ha a PDO_SQLSRV binárist forrásból fordítottad, vagy PIE-vel vagy PECL-lel telepítetted, a neve pdo_sqlsrv.so:

    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 forrásból, nincs szükség külön .ini fájlra, és hozzáadhatja az előző sort a php.ini-hez.

  3. Indítsd újra a webszervert.

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.

Kapcsolódó tartalom

  • Last updated on