Bağlantı Seçenekleri

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

Bu konu, ilişkilendirici dizide izin verilen seçenekleri (SQLSRV sürücüsünde sqlsrv_connect kullanırken) veya veri kaynağı adında (dsn) izin verilen anahtar sözcükleri (PDO_SQLSRV sürücüsünde PDO::__construct kullanırken) listeler.

Bağlantı Seçenekleri Tablosu

Key	Değer	Description	Varsayılan
AccessToken	String	OAuth JSON yanıtından ayıklanan Microsoft Entra erişim belirtecinin bayt dizesi. Bağlantı dizesi bir kullanıcı kimliği, parola veya Authentication anahtar sözcük içermemelidir. Daha fazla bilgi için bkz. Microsoft Entra kimlik doğrulamasını kullanarak bağlanma	Ayarlanmadı.
uygulama	String	İzlemede kullanılan uygulama adını belirtir.	Ayarlanmadı.
Uygulama Niyeti	String	Sunucuya bağlanırken uygulama iş yükü türünü bildirir. Olası değerler ReadOnly ve ReadWrite. Always On kullanılabilirlik grupları için SQL Server desteği için PHP için Microsoft Sürücüleri hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, Olağanüstü Durum Kurtarma desteği.	OkumaYazma
AttachDBFileName	String	Sunucunun hangi veritabanı dosyasını eklemesi gerektiğini belirtir.	Ayarlanmadı.
Authentication	Aşağıdaki dizelerden biri: SqlPassword ActiveDirectoryPassword ActiveDirectoryMsi ActiveDirectoryServicePrincipal	Kimlik doğrulama modunu belirtir. Daha fazla bilgi için bkz. Microsoft Entra kimlik doğrulamasını kullanarak bağlanma	Ayarlanmadı.
Karakter Seti (PDO_SQLSRV sürücüsünde desteklenmez)	String	Sunucuya veri göndermek için kullanılan karakter kümesini belirtir. Olası değerler SQLSRV_ENC_CHAR ve UTF-8'tir. Daha fazla bilgi için bkz Dahili UTF-8 Desteği Kullanarak UTF-8 Verilerini Gönderme ve Alma Yöntemi .	SQLSRV_ENC_CHAR
SütunŞifreleme	Aşağıdaki dizelerden biri: Enabled Disabled Enklavı kanıtlamak için kullanılan kanıtlama protokolünü ve URL'yi tanımlayan bir dize	Always Encrypted özelliğinin etkinleştirilip etkinleştirilmediğini belirtir. Bir kanıtlama protokolü ve URL belirtilirse, diğer gereksinimler SQL Server için PHP Sürücüleri ile güvenli kuşatmalarla Always Encrypted'ı kullanma bölümünde açıklandığı gibi karşılandığında güvenli kuşatmalarla Always Encrypted etkinleştirilir.	Disabled
ConnectionPooling	Bağlantı havuzunu etkinleştirmek için 1 veya true kullanın. Bağlantı havuzunun kapalı olması için 0 veya false.	Bağlantının bir bağlantı havuzundan (1 veya doğru) atanıp atanmayacağını (0 veya yanlış) belirtir. 1	true (1)
ConnectRetryCount	0 ile 255 arasında tamsayı (dahil)	Vazgeçmeden önce bozuk bir bağlantıyı yeniden kurmaya yönelik en fazla deneme sayısı. Varsayılan olarak, bağlantı kesildiğinde yeniden kurmak için tek bir deneme yapılır. 0 değeri, yeniden bağlanma girişiminde bulunılmayacak anlamına gelir.	1
Bağlantı Yeniden Deneme Aralığı	1 ile 60 arasında tamsayı (dahil)	Bağlantıyı yeniden kurmaya yönelik girişimler arasındaki saniye cinsinden süre. Uygulama, kopuk bir bağlantı algılanması üzerine hemen yeniden bağlanmayı dener ve yeniden denemeden önce saniyeler bekler ConnectRetryInterval . Bu anahtar sözcük, ConnectRetryCount 0'a eşitse yoksayılır.	10
Veritabanı	String	Kurulan bağlantı için kullanılan veritabanının adını belirtir2.	Kullanılan oturum açma için varsayılan veritabanı.
Ondalık Basamaklar (PDO_SQLSRV sürücüsünde desteklenmez)	0 ile 4 arasında tamsayı (dahil)	Getirilen para değerlerini biçimlendirirken ondalık basamakları belirtir. Bu seçenek yalnızca doğru olduğunda FormatDecimals çalışır. 4'ten büyük herhangi bir negatif tamsayı veya değer yoksayılır.	Varsayılan duyarlık ve ölçek
Driver	String	SQL Server ile iletişim kurmak için kullanılan Microsoft ODBC sürücüsünü belirtir. Olası değerler şunlardır: SQL Server için ODBC Sürücüsü 18 SQL Server için ODBC Sürücüsü 17 SQL Server için ODBC Sürücüsü 13 SQL Server için ODBC Sürücüsü 11 (yalnızca Windows).	Driver anahtar sözcüğü belirtilmediğinde, SQL Server için PHP için Microsoft Sürücüleri, ODBC'nin en son sürümünden başlayarak sistemde desteklenen Microsoft ODBC sürücülerini bulmaya çalışır.
Şifrelemek	Şifrelemeyi etkinleştirmek için 1 veya true girin. Şifrelemenin kapalı olması için 0 veya false.	SQL Server ile iletişimin şifrelenip şifrelenmediğini (1 veya doğru) veya şifrelenmemiş (0 veya yanlış)3 belirtir.	false (0)
Failover_Partner	String	Birincil sunucu kullanılamadığında kullanılacak yansıtılmış veritabanının sunucusunu ve örneğini (etkinleştirilmiş ve yapılandırılmışsa) belirler. Failover_Partner ile MultiSubnetFailover kullanmanın kısıtlamaları vardır. Daha fazla bilgi için bkz. Yüksek Kullanılabilirlik Desteği, Olağanüstü Durum Kurtarma. Veritabanı yansıtma, Linux veya macOS'ta ODBC sürücüsü tarafından desteklenmediğinden bu seçenek Linux veya macOS'ta desteklenmez. Bunun yerine Always On kullanılabilirlik gruplarını kullanın ve MultiSubnetFailover ve TransparentNetworkIPResolution seçeneklerini ayarlayın.	Ayarlanmadı.
FormatDecimals (PDO_SQLSRV sürücüsünde desteklenmez)	1 veya true, getirilen ondalık dizeleri biçimlendirmek için kullanılır. Varsayılan ondalık biçimlendirme davranışı için 0 veya false .	Uygun olduğunda ondalık dizelere baştaki sıfırların eklenip eklenmeyeceğini DecimalPlaces belirtir ve para türlerini biçimlendirme seçeneğini etkinleştirir. Yanlış olarak bırakılırsa, tam hassasiyetin döndürülmesi ve 1’den küçük değerler için öncüll sıfırların ihmal edilmesi varsayılan davranış olarak kullanılır. Daha fazla bilgi için bkz . Ondalık Dizeleri ve Para Değerlerini Biçimlendirme.	false (0)
KeyStoreAuthentication	KeyVaultPassword KeyVaultClientSecret	Azure Key Vault'a erişmek için kimlik doğrulama yöntemi. ve KeyStorePrincipalIdile KeyStoreSecret ne tür kimlik bilgilerinin kullanıldığını denetler. Daha fazla bilgi için bkz. Azure Key Vault kullanma.	Ayarlanmadı.
KeyStorePrincipalId	String	Azure Key Vault'a erişmek isteyen hesabın tanımlayıcısı. KeyStoreAuthentication KeyVaultPassword ise, bu değer bir Microsoft Entra kullanıcı adı olmalıdır. KeyStoreAuthentication ise, bu değer bir uygulama istemci kimliği olmalıdır.	Ayarlanmadı.
KeyStoreSecret	String	Azure Key Vault'a erişmeye çalışan hesabın kimliğe dair gizli bilgisi. KeyStoreAuthentication ise, bu değer bir Microsoft Entra parolası olmalıdır. "KeyVaultClientSecret" ise, bu değer bir uygulama istemci gizli anahtarı olmalıdır.	Ayarlanmadı.
Language	String	Sunucu tarafından döndürülen iletilerin dilini belirtir. Kullanılabilir diller tabloda listelenir sys.syslanguages . Bu seçenek, şu anda yalnızca İngilizce olarak kullanılabildikleri için sürücülerin kendileri tarafından kullanılan dili etkilemez ve dili istemci sisteminde yüklü yerelleştirilmiş sürüm tarafından belirlenen temel ODBC sürücüsünün dilini etkilemez. Bu nedenle, bu ayarın değiştirilmesi iletilerin PHP sürücüsünden mi, ODBC sürücüsünden mi yoksa SQL Server'dan mı geldiğine bağlı olarak farklı dillerde döndürülmesini sağlar.	Varsayılan değer SQL Server'da ayarlanan dildir.
OturumZamanAşımı	Tamsayı (SQLSRV sürücüsü) Dize (PDO_SQLSRV sürücüsü)	Bağlantı girişiminin başarısız olması için beklenmesi gereken saniye sayısını belirtir.	Zaman aşımı yok.
ÇokluAktifSonuçKümeleri	1 veya true ile birden çok etkin sonuç kümesi kullanın. Birden çok etkin sonuç kümesini devre dışı bırakmak için 0 veya false kullanın.	Birden çok etkin sonuç kümesi (MARS) için desteği devre dışı bırakır veya açıkça etkinleştirir. Daha fazla bilgi için bkz . Nasıl yapılır: Birden Çok Etkin Sonuç Kümesini (MARS) Devre Dışı Bırakma.	doğru (1)
MultiSubnetFailover	String	SQL Server 2012 (11.x) kullanılabilirlik grubunun veya SQL Server 2012 (11.x) Yük Devretme Kümesi Örneği'nin kullanılabilirlik grubu dinleyicisine bağlanırken her zaman multiSubnetFailover=yes belirtin. multiSubnetFailover=yes , (şu anda) etkin sunucuya daha hızlı algılama ve bağlantı sağlamak üzere SQL Server için PHP için Microsoft Sürücüleri'ni yapılandırır. Olası değerler Evet ve Hayır'dır. Always On kullanılabilirlik grupları için SQL Server desteği için PHP için Microsoft Sürücüleri hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, Olağanüstü Durum Kurtarma desteği.	Hayı
PWD (PDO_SQLSRV sürücüsünde desteklenmez)	String	SQL Server Authentication4 ile bağlanırken kullanılacak Kullanıcı Kimliği ile ilişkili parolayı belirtir.	Ayarlanmadı.
QuotedId	SQL-92 kurallarını kullanmak istediğinizi belirtmek için 1 veya true yazın. Eski kuralları kullanmak için 0 veya false girin.	Tırnak içine alınmış tanımlayıcılar için SQL-92 kurallarını (1 veya doğru) mı yoksa eski Transact-SQL kurallarını (0 veya yanlış) mı kullanacağını belirtir.	true (1)
TarihleriStringOlarakDöndür (PDO_SQLSRV sürücüsünde desteklenmez)	Tarih ve saat türlerini dize olarak döndürmek için 1 veya true olarak ayarla. Tarih ve saat türlerini PHP DateTime türleri olarak döndürmek için 0 veya false.	Tarih ve saat türlerini (datetime, smalldatetime, date, time, datetime2 ve datetimeoffset) dize veya PHP türü olarak alır. Daha fazla bilgi için bkz . Nasıl yapılır: SQLSRV Sürücüsünü Kullanarak Tarih ve Saat Türlerini Dize Olarak Alma. PDO_SQLSRV sürücüsü kullanılırken, aksi belirtilmedikçe tarihler dize olarak döndürülür. Daha fazla bilgi için PDO_SQLSRV Sürücüsünü Kullanarak PHP DateTime Nesneleri olarak Tarih ve Saat Türlerini Nasıl Alabilirsiniz'e bakın.	false
Kaydırılabilir	String	"arabelleğe alınmış", sonuç kümesinin tamamını bellekte önbelleğe almanızı sağlayan istemci tarafı (arabelleğe alınmış) bir imleç istediğinizi gösterir. Daha fazla bilgi için bkz. İmleç Türleri (SQLSRV Sürücüsü).	Yalnızca ileri imleç
Server (SQLSRV sürücüsünde desteklenmez)	String	Bağlanacak SQL Server örneği. Always On kullanılabilirlik grubuna bağlanmak için bir sanal ağ adı da belirtebilirsiniz. Always On kullanılabilirlik grupları için SQL Server desteği için PHP için Microsoft Sürücüleri hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, Olağanüstü Durum Kurtarma desteği.	Sunucu gerekli bir anahtar sözcüktür (ancak bağlantı dizesindeki ilk anahtar sözcük olması gerekmez). Anahtar sözcüğüne bir sunucu adı geçirilmediyse, yerel örneğe bağlanılmaya çalışılır. Sunucu'ya geçirilen değer bir SQL Server örneğinin adı veya örneğin IP adresi olabilir. İsteğe bağlı olarak bir bağlantı noktası numarası belirtebilirsiniz (örneğin, sqlsrv:server=(local),1033). PHP için Microsoft Sürücüleri'nin SQL Server için 3.0 sürümünden itibaren, server=(localdb)\instancename ile bir LocalDB örneği de belirtebilirsiniz. Daha fazla bilgi için bkz. LocalDB desteği.
TraceFile	String	İzleme verileri için kullanılan dosyanın yolunu belirtir.	Ayarlanmadı.
TraceOn	İzlemeyi etkinleştirmek için 1 veya true değerini girin. İzlemeyi devre dışı bırakmak için 0 veya false değerini girin.	Kurulan bağlantı için ODBC izlemenin etkin (1 veya doğru) veya devre dışı (0 veya yanlış) olup olmadığını belirtir.	false (0)
İşlem İzolasyonu	SQLSRV sürücüsü aşağıdaki değerleri kullanır: SQLSRV_TXN_READ_UNCOMMITTED SQLSRV_TXN_READ_COMMITTED SQLSRV_TXN_REPEATABLE_READ SQLSRV_TXN_SNAPSHOT SQLSRV_TXN_SERIALIZABLE PDO_SQLSRV sürücüsü aşağıdaki değerleri kullanır: PDO::SQLSRV_TXN_READ_UNCOMMITTED PDO::SQLSRV_TXN_READ_COMMITTED PDO::SQLSRV_TXN_REPEATABLE_READ PDO::SQLSRV_TXN_SNAPSHOT PDO::SQLSRV_TXN_SERIALIZABLE	İşlem yalıtım düzeyini belirtir. İşlem yalıtımı hakkında daha fazla bilgi için SQL Server belgelerindeki İŞLEM YALıTıM DÜZEYINI AYARLAMA bölümüne bakın.	SQLSRV_TXN_READ_COMMITTED veya PDO::SQLSRV_TXN_READ_COMMITTED
Şeffaf Ağ IP Çözümlemesi	Etkin veya Pasif	Ana bilgisayar adının ilk çözümlenen IP'sinin yanıt vermemesi ve konak adıyla ilişkilendirilmiş birden çok IP olması, bağlantı sırasını etkiler. MultiSubnetFailover ile etkileşim kurarak farklı bağlantı dizileri sağlar. Daha fazla bilgi için bkz . Saydam Ağ IP Çözümlemesi veya Saydam Ağ IP Çözümlemesini Kullanma.	Etkinleştirildi
TrustServerCertificate	Sertifikaya güvenmek amacıyla 1 veya true. Sertifikaya güvenmemek için 0 veya false .	İstemcinin otomatik olarak imzalanan bir sunucu sertifikasına (1 veya doğru) mı yoksa (0 mı yoksa yanlış mı) güvenip güvenmeyeceğini belirtir.	false (0)
Kullanıcı Kimliği (PDO_SQLSRV sürücüsünde desteklenmez)	String	SQL Server Authentication4 ile bağlanırken kullanılacak Kullanıcı Kimliğini belirtir.	Ayarlanmadı.
WSID	String	İzlenecek bilgisayarın adını belirtir.	Ayarlanmadı.

1. Özniteliği Linux ConnectionPooling ve macOS'ta bağlantı havuzunu etkinleştirmek/devre dışı bırakmak için kullanılamaz. Bkz. Bağlantı Havuzu (SQL Server için PHP için Microsoft Sürücüleri).

2. Oluşturulan bağlantıda yürütülen tüm sorgular özniteliği tarafından Database belirtilen veritabanına yapılır. Ancak, kullanıcı uygun izinlere sahipse, diğer veritabanlarındaki verilere tam ad kullanılarak erişilebilir. Örneğin, ana veritabanı bağlantı özniteliğiyle Database ayarlandıysa, tam adı kullanarak AdventureWorks.HumanResources.Employee tablosuna erişen bir Transact-SQL sorgusu yürütmek yine de mümkündür.

3. Encryption Etkinleştirme, verileri şifrelemek için gereken işlem yükü nedeniyle bazı uygulamaların performansını etkileyebilir.

4. UID SQL Server Kimlik Doğrulaması ile bağlanırken ve PWD özniteliklerinin her ikisi de ayarlanmalıdır.

Desteklenen anahtarların çoğu ODBC bağlantı dizesi öznitelikleridir. ODBC bağlantı dizeleri hakkında bilgi için bkz. SQL Yerel İstemcisi ile Bağlantı Dizesi Anahtar Sözcüklerini Kullanma.

Ayrıca Bkz.

Sunucuya Bağlanma