Läser in Microsoft-drivrutiner för PHP för SQL Server

Ladda ned PHP-drivrutin

Den här sidan innehåller instruktioner för att läsa in Microsoft Drivers for PHP för SQL Server i PHP-processutrymmet.

Du kan ladda ned de fördefinierade drivrutinerna för din plattform från Microsoft Drivers for PHP för SQL Server GitHub-projektsidan. Varje installationspaket innehåller SQLSRV- och PDO_SQLSRV drivrutinsfiler i trådade och icke-trådade varianter. I Windows finns de också i 32-bitars- och 64-bitarsvarianter. Se Systemkrav för Microsoft-drivrutiner för PHP för SQL Server för en lista över drivrutinsfilerna som finns i varje paket. Drivrutinsfilen måste matcha PHP-versionen, arkitekturen och trådigheten i PHP-miljön.

I Linux och macOS kan drivrutinerna också installeras med PECL, som du hittar i installationsguiden.

Du kan också bygga drivrutinerna från källan antingen när du bygger PHP eller med hjälp av phpize. Om du väljer att skapa drivrutinerna från källan kan du skapa dem statiskt i PHP i stället för att skapa dem som delade tillägg genom att lägga till --enable-sqlsrv=static --with-pdo_sqlsrv=static (på Linux och macOS) eller --enable-sqlsrv=static --with-pdo-sqlsrv=static (i Windows) i ./configure kommandot när du skapar PHP. Mer information om PHP-byggsystemet och phpizefinns i PHP-dokumentationen.

Flytta drivrutinsfilen till din tilläggskatalog

Drivrutinsfilen måste finnas i en katalog där PHP-körningen kan hitta den. Det är enklast att placera drivrutinsfilen i php-standardtilläggskatalogen – för att hitta standardkatalogen kör php -i | sls extension_dir du i Windows eller php -i | grep extension_dir på Linux/macOS. Om du inte använder standardtilläggskatalogen anger du en katalog i PHP-konfigurationsfilen (php.ini), med hjälp av alternativet extension_dir . Om du till exempel har placerat drivrutinsfilen i din c:\php\ext katalog i Windows lägger du till följande rad i php.ini:

extension_dir = "c:\PHP\ext"  

Läser in drivrutinen vid PHP-start

Om du vill läsa in SQLSRV-drivrutinen när PHP startas flyttar du först en drivrutinsfil till din tilläggskatalog. Följ sedan dessa steg:

1. Om du vill aktivera SQLSRV-drivrutinen ändrar duphp.ini genom att lägga till följande rad i tilläggsavsnittet och ändra filnamnet efter behov:

   På Windows:

   extension=php_sqlsrv_82_ts.dll  
   

   Om du har hämtat de fördefinierade binärfilerna för distributionen i Linux:

   extension=php_sqlsrv_82_nts.so  
   

   Om du har kompilerat SQLSRV-binärfilen från källan eller med PECL får den i stället namnet sqlsrv.so:

   extension=sqlsrv.so
   

2. Om du vill aktivera PDO_SQLSRV drivrutinen måste TILLÄGGET PHP Data Objects (PDO) vara tillgängligt, antingen som ett inbyggt tillägg eller som ett dynamiskt inläst tillägg.

   I Windows levereras de fördefinierade PHP-binärfilerna med inbyggd PDO, så du behöver inte ändra php.ini för att läsa in den. Om du däremot har kompilerat PHP från källan och angett ett separat PDO-tillägg som ska skapas, kommer det att heta php_pdo.dll, och du måste kopiera det till tilläggskatalogen och lägga till följande rad i php.ini:

   extension=php_pdo.dll  
   

   Om du har installerat PHP i Linux med hjälp av systemets pakethanterare installeras PDO förmodligen som ett dynamiskt inläst tillägg med namnet pdo.so. PDO-tillägget måste läsas in innan PDO_SQLSRV-tillägget, annars misslyckas inläsningen. Tillägg läses vanligtvis in med hjälp av enskilda .ini filer och dessa filer läses efter php.ini. Därför, om pdo.so laddas via en egen .ini-fil, krävs en separat fil som laddar PDO_SQLSRV-drivrutinen efter att PDO har laddats.

   Om du vill ta reda på vilken katalog de tilläggsspecifika .ini filerna finns kör php --ini du och noterar katalogen som anges under Scan for additional .ini files in:. Leta upp filen som läser in pdo.so. Det prefixas troligen av ett tal, till exempel 10-pdo.ini. Det numeriska prefixet anger inläsningsordningen för de .ini filerna, medan filer som inte har ett numeriskt prefix läses in alfabetiskt. Skapa en fil för att läsa in PDO_SQLSRV drivrutinsfilen med namnet antingen 30-pdo_sqlsrv.ini (ett nummer som är större än det som pdo.ini prefixas med) eller pdo_sqlsrv.ini (om pdo.ini inte har ett nummer som prefix), och lägg till följande rad i den. Ändra sedan filnamnet efter behov:

   extension=php_pdo_sqlsrv_82_nts.so
   

   Precis som med SQLSRV, om du har kompilerat den PDO_SQLSRV binärfilen från källan eller med PECL, kommer den i stället att namnges pdo_sqlsrv.so:

   extension=pdo_sqlsrv.so
   

   Kopiera den här filen till katalogen som innehåller de andra .ini filerna.

   Om du har kompilerat PHP från källan med inbyggt PDO-stöd behöver du inte en separat .ini-fil, och du kan lägga till lämplig rad ovan i php.ini.

3. Starta om webbservern.

Anmärkning

För att avgöra om drivrutinen har lästs in kör du ett skript som anropar phpinfo().

Mer information om php.ini direktiv finns i Beskrivning av grundläggande php.ini direktiv.

Se även

Komma igång med Microsoft-drivrutiner för PHP för SQL Server

Systemkrav för Microsoft-drivrutiner för PHP för SQL Server

Programmeringsguide för Microsoft-drivrutiner för PHP för SQL Server

API-referens för SQLSRV-drivrutin

API-referens för PDO_SQLSRV-drivrutin