SQL Server için PHP için Microsoft Sürücüleri sistem gereksinimleri

PHP sürücüsünü indirme

Bu makale, SQLSRV veya PDO_SQLSRV sürücüsü kullanarak SQL Server veya Azure SQL Veritabanı verilerine erişmek için sisteminize kurmanız gereken bileşenleri listeler.

PHP sürücülerinin destek yaşam döngüleri ve gereksinimleri hakkında daha fazla bilgi için destek matrisine bakınız. Her sürümdeki SQLSRV ve PDO_SQLSRV sürücüleri aynı PHP, işletim sistemi, mimari, iş parçacığı güvenliği ve ODBC gereksinimlerine sahiptir.

Sürücü yığınının nasıl bir araya geldiği

Bir PHP uygulaması doğrudan veritabanı sunucusuna bağlanmaz. Her katman, yanındaki katmanla uyumlu olmalıdır:

Katman Seçtiğiniz veya yapılandırdığınız şey Bir uyumsuzluk nasıl görünüyor
Application SQLSRV fonksiyonları veya PDO_SQLSRV sınıfları ve öznitelikleri Tanımlanmamış fonksiyonlar, mevcut olmayan PDO sürücüsü veya uygulama düzeyinde hatalar
PHP uzantısı PHP minör sürümü, mimarisi ve iş parçacığı güvenliği modu için oluşturulmuş SQLSRV ve PDO_SQLSRV dosyaları PHP başlatma uyarısı, modül yükleme hatası veya işlem çökmesi
PHP çalışma zamanı Komut satırı arayüzü (CLI), Apache modülü, PHP-FPM veya IIS FastCGI yapılandırması CLI sürücüleri yükler ama web uygulaması sürücüleri yüklemiyor
Microsoft ODBC Sürücüsü Seçilen PHP sürücü sürümü tarafından desteklenen bir PHP sürümü Bağlantı arızaları veya eksik bir ODBC kütüphanesi
İşletim Sistemi Gerekli çalışma zamanı ve derleme paketleriyle desteklenen bir sürüm ve mimari Uyumlu bir paket, çözülmemiş paylaşılan kütüphane veya kaynak derleme hatası yok
Veritabanı ürünü Desteklenen SQL Server veya Azure SQL hedefi Bağlantı kurulduktan sonra sunucu sürümü veya özelliğe özgü hatalar

SQLSRV ve PDO_SQLSRV aynı ODBC sürücüsü üzerinden farklı PHP API'leri sağlar. Uygulamanız her iki API kullandığında ikisini de kurun. Bir uzantı kurmak diğerini otomatik olarak yüklemez veya etkinleştirmez.

API Programlama modeli Kuruluma özgü kontrol
SQLSRV Prosedürel sqlsrv_* fonksiyonlar ve SQLSRV sabitleri extension_loaded('sqlsrv') ve function_exists('sqlsrv_connect')
PDO_SQLSRV PHP Veri Nesneleri (PDO) sınıfları, nitelikleri ve istisnaları extension_loaded('pdo_sqlsrv') ve sqlsrv içinde PDO::getAvailableDrivers()

Uzantılar bağımsız olarak kurulabilir. PDO_SQLSRV ayrıca PDO'nun PDO_SQLSRV'den önce yüklenmesi gerekiyor.

Uyumlu bir küme seçin

Bir sürücü indirmeden veya derlemeden önce şu kontrolleri tamamlayın:

  1. Uygulamaya hizmet veren her PHP çalışma zamanını belirleyin. Bir planlanmış görev, komut satırı çalışanı, IIS sitesi, Apache modülü ve PHP-FPM havuzu farklı PHP çalıştırılabilir dosyalar ve yapılandırma dosyalarını kullanabilir.

  2. Her PHP yürütülebilir dosyası için aşağıdaki komutu çalıştırın:

    php -i | findstr /I "PHP Version Architecture Thread Safety extension_dir"
    

    Linux veya macOS'ta şunları kullanın:

    php -i | grep -E "PHP Version|Thread Safety|extension_dir"
    file "$(php -r 'echo PHP_BINARY;')"
    

    file komutu, çalıştırılabilir dosyanın mimarisini bildirir. Evrensel bir macOS yürütülebilir dosyası olarak algılanırsa, amaçlanan mimariyi açıkça seçin, örneğin arch -arm64 php --version veya arch -x86_64 php --version. Uzantıları oluştururken, yüklerken ve test ederken aynı mimari seçimini kullanın.

  3. PHP minör sürümünü, işletim sistemini ve veritabanı hedefini destekleyen bir PHP sürücü sürümü seçin.

  4. Bu makaledeki uyumluluk tablosundan desteklenen bir Microsoft ODBC Sürücü sürümünü seçin.

  5. Uzantı dosyasını veya PIE derlemesini PHP mimarisi ve iş parçacığı güvenliği moduna eşleştirin. Tüm bu değerler eşleşmedikçe başka bir PHP kurulumundan bir uzantı kopyalamayın.

  6. CLI ve web sunucusu çalışma zamanlarını ayrı ayrı yapılandırın ve doğrulayın. Başarılı bir php -m komutu, yalnızca CLI çalışma zamanının uzantıyı yüklediğini kanıtlar.

PHP

PHP binary dosyalarını PHP web sitesinden indirin. PHP sürüm desteği'nde listelenen bir PHP sürümünü seçin.

İş parçacığı güvenliği ve mimari

PHP derleme ve uzantı dosyası her iki değerde de birbiriyle eşleşmelidir.

PHP değeri Zorunlu sürücü seçimi
Thread Safety => enabled İş parçacığı güvenli (ts veya TS) sürücü dosyası
Thread Safety => disabled İş parçacığına güvenli olmayan (nts veya NTS) sürücü dosyası
Architecture => x64 64-bit sürücü dosyası ve 64-bit ODBC bileşenleri
Architecture => x86 32-bit Windows sürücü dosyası ve 32-bit ODBC bileşenleri

CLI, iş parçacığı güvenli veya iş parçacığı güvenli olmayan bir PHP derlemesi kullanabilir. Uzantını, her bir CLI derlesinin iş parçacığına güvenli olmadığını varsaymak yerine bildirilen değere göre seçin.

ODBC sürücüsü

PHP çalıştıran bilgisayara desteklenen Microsoft ODBC Driver for SQL Server'ı yükleyin. Sürücüyü SQL Server için ODBC Sürücüsünü İndirin bağlantısından indirin.

Sürücünün Windows sürümünü Windows'un 64 bit sürümüne indiriyorsanız, ODBC 64 bit yükleyicisi hem 32 bit hem de 64 bit ODBC sürücülerini yükler. Windows'un 32 bit sürümünü kullanıyorsanız ODBC x86 yükleyicisini kullanın. Windows dışı platformlarda, sürücünün yalnızca 64 bit sürümleri kullanılabilir.

Tablo, yükseltme planlaması için tarihsel kombinasyonları içerir. Yeni bir kurulum için mevcut PHP sürücü sürümü ve listelenen ODBC sürümlerini kullanın. Eski sürümle uyumluluk, destek yaşam döngüsünü uzatmaz. Hem PHP sürücü destek yaşam döngüsünü hem de PHP'nin desteklenen sürümlerini kontrol edin.

Boş hücre, PHP sürücüsünün o ODBC sürümünü mutlaka reddettiği anlamına gelmez. Bireysel özellikler, temel kombinasyondan daha yeni ODBC sürümleri gerektirebilir.

PHP sürücü sürümü →
↓ ODBC sürücü sürümü
5.13 5.12 5.11 5.10 5.9 5.8 5.6 5.3 5.2 4.3 4,0 3.2
ODBC Sürücüsü 18 Yes Yes Yes Yes
ODBC Sürücüsü 17 Yes Yes Yes Yes Yes Yes Yes Yes Yes
ODBC Sürücüsü 13.1 Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
ODBC Sürücüsü 13 Yes
ODBC Sürücüsü 11 Yes Yes Yes Yes Yes Yes Yes

SQLSRV sürücüsünü kullanıyorsanız sqlsrv_client_info , SQL Server için PHP için Microsoft Sürücüleri tarafından SQL Server için Microsoft ODBC Sürücüsünün hangi sürümünün kullanıldığı hakkında bilgi döndürür. PDO_SQLSRV sürücüsünü kullanıyorsanız, sürümü bulmak için PDO::getAttribute kullanabilirsiniz.

SQL Server

Desteklenen SQL Server sürümleri için bkz. Desteklenen veritabanı sürümleri.

SQL Server, Azure SQL Veritabanı, Azure SQL Yönetilen Örneği, Azure Synapse Analytics, Microsoft Fabric'teki SQL veritabanı ve Microsoft Fabric'teki Warehouse için hedef desteğini ayrı ayrı değerlendirin. Kurulum gereksinimleri istemci tarafı gereksinimlerdir ve her kimlik doğrulama yönteminin, bağlantı seçeneğinin, Transact-SQL (T-SQL) özelliğinin veya veri türünün her hedefte mevcut olduğunu göstermez. Uygulamanızın kullandığı senaryo için destek matrisini ve hedef ürünün dokümantasyonunu kullanın.

İşletim sistemleri

Desteklenen işletim sistemleri için, Desteklenen işletim sistemleri konusuna bakın.

Sürücü sürümleri

SQL Server için PHP için Microsoft Sürücülerinin her sürümü, SQLSRV ve PDO_SQLSRV sürücü dosyalarını iş parçacığı güvenli ve iş parçacığı güvenli olmayan varyantlarda sunar. Windows'ta ise her varyant 32-bit ve 64-bit PHP için de derlenmiştir. Sürücü dosyasını PHP sürümüne, iş parçacığı güvenlik moduna ve mimarisine eşleştirin. Bir sürücü dosyasını indirdikten sonra etkinleştirmek için, SQL Server için PHP için Microsoft Sürücülerini Yükleme bölümüne bakınız.

Linux ve macOS'ta, sürücüleri Linux ve macOS kurulum talimatlarında açıklandığı gibi, PHP Eklenti Yükleyicisi olan PIE ile yükleyin. PIE, kullanımdan kaldırılmış PHP Extension Community Library (PECL) paket sisteminin yerini alır ve yüklü uzantıyı sqlsrv.so ya da pdo_sqlsrv.so olarak adlandırır. Aşağıdaki tablolar, Microsoft Drivers for PHP for SQL Server sürümleri sayfasından manuel olarak indireceğiniz önceden hazırlanmış ikili paketlerin dosya adlarını listeler.

Aşağıdaki tablolar 5.13 sürüm paketlerindeki dosyaları listeler. Dosya adlarında ts ve TS, thread-safe anlamına gelir; nts ve NTS ise thread-safe olmayan anlamına gelir.

Windows sürücü dosyaları

Bu Windows_5.13.xRTW.zip paket şu dosyaları içerir.

SQLSRV dosyası PDO_SQLSRV dosyası PHP sürümü İş parçacığı güvenli mi? Architecture
php_sqlsrv_83_nts_x86.dll php_pdo_sqlsrv_83_nts_x86.dll 8.3 no 32-bit
php_sqlsrv_83_ts_x86.dll php_pdo_sqlsrv_83_ts_x86.dll 8.3 yes 32-bit
php_sqlsrv_83_nts_x64.dll php_pdo_sqlsrv_83_nts_x64.dll 8.3 no 64-bit
php_sqlsrv_83_ts_x64.dll php_pdo_sqlsrv_83_ts_x64.dll 8.3 yes 64-bit
php_sqlsrv_84_nts_x86.dll php_pdo_sqlsrv_84_nts_x86.dll 8.4 no 32-bit
php_sqlsrv_84_ts_x86.dll php_pdo_sqlsrv_84_ts_x86.dll 8.4 yes 32-bit
php_sqlsrv_84_nts_x64.dll php_pdo_sqlsrv_84_nts_x64.dll 8.4 no 64-bit
php_sqlsrv_84_ts_x64.dll php_pdo_sqlsrv_84_ts_x64.dll 8.4 yes 64-bit
php_sqlsrv_85_nts_x86.dll php_pdo_sqlsrv_85_nts_x86.dll 8.5 no 32-bit
php_sqlsrv_85_ts_x86.dll php_pdo_sqlsrv_85_ts_x86.dll 8.5 yes 32-bit
php_sqlsrv_85_nts_x64.dll php_pdo_sqlsrv_85_nts_x64.dll 8.5 no 64-bit
php_sqlsrv_85_ts_x64.dll php_pdo_sqlsrv_85_ts_x64.dll 8.5 yes 64-bit

İş parçacığı güvenli olmayan bir sürücü dosyasını iş parçacığı güvenli olmayan bir PHP derlemesiyle, iş parçacığı güvenli bir sürücü dosyasını ise iş parçacığı güvenli bir PHP derlemesiyle kullanın. Komut satırı arayüzü (CLI) her iki yapıyı da kullanabilir. Hangi yapıya sahip olduğunuzu doğrulamak için php -i çalıştırın ve Thread Safety değerini kontrol edin.

Linux ve macOS sürücü dosyaları

Linux_5.13.xRTW.tar.gz ve Mac_5.13.xRTW.tar.gz paketleri bu dosyaları içerir. Linux arşivi x64 ikili dosyalar içerirken, macOS arşivi Arm64 ikili dosyaları içerir.

Hazır dosyalar ayrıca işletim sisteminizin yerel kütüphaneleriyle de eşleşmelidir. Linux 5.13.3 ikili dosyaları glibc 2.38 ve daha sonraki sürümleri ve GLIBCXX_3.4.32 sağlayan bir C++ çalışma zamanını gerektirir. macOS 5.13.3 ikili dosyalar, minimum dağıtım hedefi olarak macOS 26'yı belirtir. Bu ikili dosya gereksinimleri, kaynak derlemeler için işletim sistemi desteğinden ayrıdır.

Arşivin mimarisi veya yerel kütüphane gereksinimleri PHP kurulumunuzla uyuşmuyorsa PIE kullanın. PIE, kurulu PHP ve yerel kütüphaneler için derleme yapar. Önceden hazırlanmış bir uzantı yüklemek için sistem kütüphanelerini manuel olarak değiştirmeyin.

SQLSRV dosyası PDO_SQLSRV dosyası PHP sürümü İş parçacığı güvenli mi?
SQLSRV_8.3_NTS.so PDO_SQLSRV_8.3_NTS.so 8.3 no
SQLSRV_8.3_TS.so PDO_SQLSRV_8.3_TS.so 8.3 yes
SQLSRV_8.4_NTS.so PDO_SQLSRV_8.4_NTS.so 8.4 no
SQLSRV_8.4_TS.so PDO_SQLSRV_8.4_TS.so 8.4 yes
SQLSRV_8.5_NTS.so PDO_SQLSRV_8.5_NTS.so 8.5 no
SQLSRV_8.5_TS.so PDO_SQLSRV_8.5_TS.so 8.5 yes

İhtiyacınız olan her dosyayı PHP uzantı dizininize kopyalayın. Paket dosya adını koruyup extension=SQLSRV_8.4_NTS.so yazabilir veya dosyayı sqlsrv.so olarak yeniden adlandırıp extension=sqlsrv kısa biçimini yazabilirsiniz. Aynı isim seçimini PDO_SQLSRV için uygulayın. Uzantı dizinini bulmak için php -i | grep extension_dirçalıştırın. Doğru yapılandırma dosyasında uzantıları etkinleştirmek ve PDO_SQLSRV'den önce PHP Veri Nesneleri'ni (PDO) yüklemek için Linux ve macOS'ta sürücüleri yükleme konusunu izleyin.

Önceki sürümler

5.13 öncesi sürümlerde yer alan sürücü dosyaları için, Microsoft Drivers for PHP for SQL Server sürümler sayfasından o sürüm paketini indirin ve içeriğini listeleyin. 5.12 öncesi sürümler, her platform için tek bir paket yerine, her işletim sistemi ve PHP sürümü için ayrı bir paket yayımlar.

Seçilen ortamı doğrulayın

PHP uzantılarını ve ODBC sürücüsünü yükledikten sonra, ancak bir web sunucusu yapılandırmadan önce bu kontrolleri çalıştırın:

php --version
php --ini
php --ri sqlsrv
php --ri pdo_sqlsrv

Son iki komut ayrı modül bilgi bölümlerini göstermelidir. Eğer herhangi bir komut uzantının olmadığını bildirirse, veritabanı bağlantısını test etmeden önce platform kurulum ve yükleme prosedürünü tamamlayın.

Kimlik bilgileri gerektirmeden her iki PHP API'sini de kontrol etmek için verify-php-drivers.php oluşturun:

<?php
$failures = [];

if (!extension_loaded('sqlsrv') || !function_exists('sqlsrv_connect')) {
    $failures[] = 'SQLSRV is not loaded.';
}

if (!extension_loaded('pdo_sqlsrv') || !in_array('sqlsrv', PDO::getAvailableDrivers(), true)) {
    $failures[] = 'PDO_SQLSRV is not loaded.';
}

echo $failures === []
    ? "SQLSRV and PDO_SQLSRV are loaded." . PHP_EOL
    : implode(PHP_EOL, $failures) . PHP_EOL;

exit($failures === [] ? 0 : 1);

Uygulamayı sunan PHP çalıştırılabilir dosyası ile çalıştırın:

php verify-php-drivers.php

Beklenen çıkış:

SQLSRV and PDO_SQLSRV are loaded.

Bu kontrol uzantı yüklemesini doğrular. ODBC bağlantısını, kimlik doğrulamasını, sertifika güvenini, ağ erişimini veya veritabanı izinlerini doğrulamaz.

Sonucu kaydettikten sonra sil verify-php-drivers.php .

Gereksinim başarısızlıklarını tanıla

Belirti Muhtemel sahibi Denetle
PHP Startup: Unable to load dynamic library PHP çalışma zamanı veya uzantı seçimi PHP minör sürümü, mimarisi, iş parçacığı güvenlik modu extension_dirve tam dosya adı
Call to undefined function sqlsrv_connect() SQLSRV uzantı yapılandırması php --ri sqlsrv, aktif php.inive taranmış .ini dosyalar
PDOException: could not find driver PDO_SQLSRV uzantısı veya PDO yük sırası php --ri pdo_sqlsrv, PDO::getAvailableDrivers(), ve PDO'nun önce yüklenip yüklenmediği
Eksik msodbcsql veya libodbc kütüphanesi ODBC kurulumu veya işletim sistemi yükleyicisi ODBC paketi, mimari ve paylaşılan kitaplık bağımlılıkları kuruldu
CLI çalışır ama web sitesi çalışmaz SAPI'ye özgü PHP yapılandırması php --ini sonra ile geçici bir phpinfo() sayfasını karşılaştırın
Uzantı yükleniyor ama bağlantı kurulamıyor ODBC, ağ, kimlik doğrulama, sertifika veya veritabanı hedefi SQLSRV hata koleksiyonunu veya PDO istisnasını yakalayın ve bildirilen SQLSTATE sorununu giderin