Memuat Driver Microsoft untuk PHP untuk SQL Server

Artikel
06/02/2023

Halaman ini menyediakan instruksi untuk memuat Driver Microsoft untuk PHP untuk SQL Server ke dalam ruang proses PHP.

Anda dapat mengunduh driver bawaan untuk platform Anda dari halaman proyek Microsoft Drivers for PHP for SQL Server GitHub. Setiap paket penginstalan berisi file driver SQLSRV dan PDO_SQLSRV dalam varian utas dan non-utas. Di Windows, mereka juga tersedia dalam varian 32-bit dan 64-bit. Lihat Persyaratan Sistem untuk Driver Microsoft untuk PHP untuk SQL Server daftar file driver yang terkandung dalam setiap paket. File driver harus cocok dengan versi PHP, arsitektur, dan utas lingkungan PHP Anda.

Di Linux dan macOS, driver dapat diinstal secara alternatif menggunakan PECL, seperti yang ditemukan dalam tutorial penginstalan.

Anda juga dapat membangun driver dari sumber baik saat membangun PHP atau dengan menggunakan phpize. Jika Anda memilih untuk membangun driver dari sumber, Anda memiliki opsi untuk membangunnya secara statis ke PHP alih-alih membangunnya sebagai ekstensi bersama dengan menambahkan --enable-sqlsrv=static --with-pdo_sqlsrv=static (di Linux dan macOS) atau --enable-sqlsrv=static --with-pdo-sqlsrv=static (di Windows) ke ./configure perintah saat membangun PHP. Untuk informasi selengkapnya tentang sistem build PHP dan phpize, lihat dokumentasi PHP.

Memindahkan File Driver ke Direktori Ekstensi Anda

File driver harus berada di direktori tempat runtime PHP dapat menemukannya. Paling mudah untuk menempatkan file driver di direktori ekstensi PHP default Anda - untuk menemukan direktori default, jalankan php -i | sls extension_dir di Windows atau php -i | grep extension_dir di Linux/macOS. Jika Anda tidak menggunakan direktori ekstensi default, tentukan direktori dalam file konfigurasi PHP (php.ini), menggunakan opsi extension_dir . Misalnya, pada Windows, jika Anda telah meletakkan file driver di direktori Anda c:\php\ext , tambahkan baris berikut ke php.ini:

extension_dir = "c:\PHP\ext"

Memuat Driver di Startup PHP

Untuk memuat driver SQLSRV saat PHP dimulai, pertama-tama pindahkan file driver ke direktori ekstensi Anda. Lalu, ikuti langkah-langkah berikut:

Untuk mengaktifkan driver SQLSRV , ubah php.ini dengan menambahkan baris berikut ke bagian ekstensi, mengubah nama file yang sesuai:

Di Windows:
```
extension=php_sqlsrv_82_ts.dll  
```
Di Linux, jika Anda telah mengunduh biner bawaan untuk distribusi Anda:
```
extension=php_sqlsrv_82_nts.so  
```
Jika Anda telah mengkompilasi biner SQLSRV dari sumber atau dengan PECL, biner tersebut akan diberi nama sqlsrv.so:
```
extension=sqlsrv.so
```
Untuk mengaktifkan driver PDO_SQLSRV , ekstensi PHP Data Objects (PDO) harus tersedia, baik sebagai ekstensi bawaan, atau sebagai ekstensi yang dimuat secara dinamis.

Di Windows, biner PHP bawaan dilengkapi dengan bawaan PDO, sehingga tidak perlu memodifikasi php.ini untuk memuatnya. Namun, jika Anda telah mengkompilasi PHP dari sumber dan menentukan ekstensi PDO terpisah yang akan dibuat, ekstensi tersebut akan diberi nama php_pdo.dll, dan Anda harus menyalinnya ke direktori ekstensi Anda dan menambahkan baris berikut ke php.ini:
```
extension=php_pdo.dll  
```
Di Linux, jika Anda telah menginstal PHP menggunakan manajer paket sistem Anda, PDO mungkin diinstal sebagai ekstensi yang dimuat secara dinamis bernama pdo.so. Ekstensi PDO harus dimuat sebelum ekstensi PDO_SQLSRV, atau pemuatan akan gagal. Ekstensi biasanya dimuat menggunakan file .ini individual, dan file-file ini dibaca setelah php.ini. Oleh karena itu, jika pdo.so dimuat melalui file .ini sendiri, file terpisah yang memuat driver PDO_SQLSRV setelah PDO diperlukan.

Untuk mengetahui direktori mana file .ini khusus ekstensi berada, jalankan php --ini dan catat direktori yang tercantum di bawah Scan for additional .ini files in:. Temukan file yang dimuat pdo.so. Kemungkinan diawali dengan angka, seperti 10-pdo.ini. Awalan numerik menunjukkan urutan pemuatan file .ini, sementara file yang tidak memiliki awalan numerik dimuat menurut abjad. Buat file untuk memuat file driver PDO_SQLSRV yang disebut 30-pdo_sqlsrv.ini (angka apa pun yang lebih besar dari yang awalan pdo.ini bekerja) atau pdo_sqlsrv.ini (jika pdo.ini tidak diawali oleh angka), dan tambahkan baris berikut ke dalamnya, mengubah nama file sebagaimana mewajibkan:
```
extension=php_pdo_sqlsrv_82_nts.so
```
Seperti halnya SQLSRV, jika Anda telah mengkompilasi biner PDO_SQLSRV dari sumber atau dengan PECL, itu akan diberi nama pdo_sqlsrv.so:
```
extension=pdo_sqlsrv.so
```
Salin file ini ke direktori yang memuat berkas .ini lainnya.

Jika Anda telah mengkompilasi PHP dari sumber dengan dukungan PDO bawaan, Anda tidak memerlukan file .ini terpisah, dan Anda dapat menambahkan baris yang sesuai di atas ke php.ini.
Mulai ulang server Web.