Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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:
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.
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;')"filekomutu, ç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ğinarch -arm64 php --versionveyaarch -x86_64 php --version. Uzantıları oluştururken, yüklerken ve test ederken aynı mimari seçimini kullanın.PHP minör sürümünü, işletim sistemini ve veritabanı hedefini destekleyen bir PHP sürücü sürümü seçin.
Bu makaledeki uyumluluk tablosundan desteklenen bir Microsoft ODBC Sürücü sürümünü seçin.
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.
CLI ve web sunucusu çalışma zamanlarını ayrı ayrı yapılandırın ve doğrulayın. Başarılı bir
php -mkomutu, 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.
PHP sürümünüzle eşleşen sürücü dosyasını etkinleştirin. Dosya adları için bkz. Sürücü sürümleri. Dosyaları PHP için Microsoft SQL Server Sürücüleri'ni İndirin bağlantısından indirin. Yapılandırma talimatları için bkz. SQL Server için PHP’ye yönelik Microsoft Sürücülerini Yükleme.
PHP ve uygulama çerçeveniz tarafından desteklenen bir web sunucusu ve PHP entegrasyon yöntemi seçin. Web sunucusunu PHP çalıştıracak şekilde yapılandırmak için PHP kurulum dokümantasyonunu ve framework'unuzun dağıtım talimatlarını takip edin. Eklentinin web sunucusu çalışma zamanında CLI'dan ayrı yüklenmesini doğrulayın.
İş 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 .