Verbindingsopties

PHP-stuurprogramma downloaden

In dit onderwerp worden de opties vermeld die zijn toegestaan in de associatieve matrix (wanneer u sqlsrv_connect gebruikt in het SQLSRV-stuurprogramma) of de trefwoorden die zijn toegestaan in de naam van de gegevensbron (dsn) (bij gebruik van PDO::__construct in het PDO_SQLSRV-stuurprogramma).

Tabel met verbindingsopties

Key	Waarde	Description	Verstek
AccessToken	Snaar / Touwtje	De bytetekenreeks van het Microsoft Entra-toegangstoken dat is geëxtraheerd uit een OAuth JSON-antwoord. De verbindingsreeks mag geen gebruikers-id, wachtwoord of trefwoord Authentication bevatten. Zie Verbinding maken met Microsoft Entra-verificatie voor meer informatie	Niet ingesteld.
APP	Snaar / Touwtje	Hiermee geeft u de toepassingsnaam op die wordt gebruikt bij tracering.	Niet ingesteld.
ApplicationIntent	Snaar / Touwtje	Declareert het workloadtype van de toepassing bij het maken van verbinding met een server. Mogelijke waarden zijn ReadOnly- en ReadWrite-. Zie Ondersteuning voor hoge beschikbaarheid, herstel na noodgevallen voor meer informatie over Microsoft-stuurprogramma's voor PHP voor SQL Server-ondersteuning voor AlwaysOn-beschikbaarheidsgroepen.	LezenSchrijven
AttachDBFileName	Snaar / Touwtje	Geeft aan welk databasebestand de server moet koppelen.	Niet ingesteld.
Authenticatie	Een van de volgende tekenreeksen: SqlPassword ActiveDirectoryPassword ActiveDirectoryMsi ActiveDirectoryServicePrincipal	Hiermee wordt de verificatiemodus gespecificeerd. Zie Verbinding maken met Microsoft Entra-verificatie voor meer informatie	Niet ingesteld.
Tekenreeks (niet ondersteund in het PDO_SQLSRV-stuurprogramma)	Snaar / Touwtje	Hiermee geeft u de tekenset op die wordt gebruikt om gegevens naar de server te verzenden. Mogelijke waarden zijn SQLSRV_ENC_CHAR en UTF-8. Zie Instructies voor meer informatie : UTF-8-gegevens verzenden en ophalen met behulp van Built-In UTF-8-ondersteuning.	SQLSRV_ENC_CHAR
Kolomversleuteling	Een van de volgende tekenreeksen: Ingeschakeld Disabled Een tekenreeks die het attestation-protocol en de URL voor het attesteren van de enclave identificeert	Hiermee geeft u op of de functie Always Encrypted is ingeschakeld of niet. Als er een attestation-protocol en URL zijn opgegeven, is Always Encrypted met beveiligde enclaves ingeschakeld, mits aan de andere vereisten wordt voldaan, zoals beschreven in Always Encrypted gebruiken met beveiligde enclaves met de PHP-stuurprogramma's voor SQL Server.	Disabled
ConnectionPooling	1 of true voor verbindingspooling ingeschakeld. 0 of false voor het uitschakelen van verbindingengroepering.	Hiermee geeft u op of de verbinding is toegewezen vanuit een verbindingsgroep (1 of waar) of niet (0 of onwaar). 1	waar (1)
ConnectRetryCount	Geheel getal tussen 0 en 255 (inclusief)	Het maximum aantal pogingen om een verbroken verbinding te herstellen voordat u het opgeeft. Standaard wordt één poging gedaan om een verbinding opnieuw tot stand te gebracht wanneer deze wordt verbroken. Een waarde van 0 betekent dat er geen nieuwe verbinding wordt geprobeerd.	1
ConnectRetryInterval	Geheel getal tussen 1 en 60 (inclusief)	De tijd, in seconden, tussen pogingen om een verbinding te herstellen. De toepassing probeert onmiddellijk opnieuw verbinding te maken bij het detecteren van een verbroken verbinding en wacht ConnectRetryInterval vervolgens seconden voordat u het opnieuw probeert. Dit trefwoord wordt genegeerd als ConnectRetryCount het gelijk is aan 0.	10
gegevensbank	Snaar / Touwtje	Hiermee geeft u de naam van de database die wordt gebruikt voor de verbinding tot stand wordt gebracht2.	De standaarddatabase voor de aanmelding die wordt gebruikt.
DecimalPlaces (niet ondersteund in het PDO_SQLSRV-stuurprogramma)	Geheel getal tussen 0 en 4 (inclusief)	Hiermee stelt u het aantal decimalen in bij het formatteren van opgehaalde geldbedragen. Deze optie werkt alleen als FormatDecimals waar is. Alle negatieve gehele getallen of waarden die meer dan 4 zijn, worden genegeerd.	Standaard precisie en schaal
Bestuurder	Snaar / Touwtje	Hiermee geeft u het Microsoft ODBC-stuurprogramma op dat wordt gebruikt om te communiceren met SQL Server. Mogelijke waarden zijn: ODBC-stuurprogramma 18 voor SQL Server ODBC-stuurprogramma 17 voor SQL Server ODBC-stuurprogramma 13 voor SQL Server ODBC-stuurprogramma 11 voor SQL Server (alleen Windows).	Wanneer het trefwoord Stuurprogramma niet is opgegeven, proberen de Microsoft-stuurprogramma's voor PHP voor SQL Server ondersteunde Microsoft ODBC-stuurprogramma's in het systeem te vinden, te beginnen met de nieuwste versie van ODBC enzovoort.
Coderen	1 of true voor versleuteling aan. 0 of false voor versleuteling uit.	Hiermee geeft u op of de communicatie met SQL Server is versleuteld (1 of waar) of niet-versleuteld (0 of onwaar)3.	false (0)
Failover_Partner	Snaar / Touwtje	Hiermee geeft u de server en het exemplaar van de databasespiegel (indien ingeschakeld en geconfigureerd) op die moeten worden gebruikt wanneer de primaire server niet beschikbaar is. Er zijn beperkingen voor het gebruik Failover_Partner met MultiSubnetFailover. Zie Ondersteuning voor hoge beschikbaarheid, herstel na noodgevallen voor meer informatie. Deze optie wordt niet ondersteund in Linux of macOS omdat databasespiegeling niet wordt ondersteund door het ODBC-stuurprogramma in Linux of macOS. Gebruik in plaats daarvan AlwaysOn-beschikbaarheidsgroepen en stel de MultiSubnetFailover en TransparentNetworkIPResolution opties in.	Niet ingesteld.
FormatDecimals (niet ondersteund in het PDO_SQLSRV-stuurprogramma)	1 of true voor het opmaken van opgehaalde decimale tekenreeksen. 0 of onwaar voor standaardgedrag voor decimale opmaak.	Hiermee geeft u op of voorloopnullen moeten worden toegevoegd aan decimale tekenreeksen, indien van toepassing en wordt de optie voor het DecimalPlaces opmaken van geldtypen ingeschakeld. Als dit onwaar blijft, wordt het standaardgedrag gebruikt waarbij exacte precisie wordt geretourneerd en voorloopnullen voor waarden kleiner dan 1 worden weggelaten. Zie Decimale tekenreeksen en geldwaarden opmaken voor meer informatie.	false (0)
KeyStoreAuthentication	KeyVaultPassword KeyVaultClientSecret	Verificatiemethode voor toegang tot Azure Key Vault. Hiermee bepaalt u welk type referenties worden gebruikt met KeyStorePrincipalId en KeyStoreSecret. Zie Azure Key Vault gebruiken voor meer informatie.	Niet ingesteld.
KeyStorePrincipalId	Snaar / Touwtje	Id voor het account dat toegang wil krijgen tot Azure Key Vault. Als KeyStoreAuthenticationKeyVaultPassword is, moet deze waarde een Microsoft Entra-gebruikersnaam zijn. Als KeyStoreAuthenticationKeyVaultClientSecret is, moet deze waarde een client-id van de toepassing zijn.	Niet ingesteld.
KeyStoreSecret	Snaar / Touwtje	Referentiegeheim voor het account dat toegang wil krijgen tot Azure Key Vault. Als KeyStoreAuthenticationKeyVaultPassword is, moet deze waarde een Microsoft Entra-wachtwoord zijn. Als KeyStoreAuthenticationKeyVaultClientSecret is, moet deze waarde een toepassingsclientgeheim zijn.	Niet ingesteld.
Language	Snaar / Touwtje	Hiermee geeft u de taal op van berichten die door de server worden geretourneerd. De beschikbare talen worden weergegeven in de sys.syslanguages tabel. Deze optie heeft geen invloed op de taal die door de stuurprogramma's zelf wordt gebruikt, omdat deze momenteel alleen beschikbaar zijn in het Engels en dit heeft geen invloed op de taal van het onderliggende ODBC-stuurprogramma, waarvan de taal wordt bepaald door de gelokaliseerde versie die op het clientsysteem is geïnstalleerd. Als u deze instelling wijzigt, kunnen berichten in verschillende talen worden geretourneerd, afhankelijk van of deze afkomstig zijn van het PHP-stuurprogramma, het ODBC-stuurprogramma of SQL Server.	De standaardinstelling is de taal die is ingesteld in SQL Server.
LoginTimeout	Geheel getal (SQLSRV-stuurprogramma) String (PDO_SQLSRV stuurprogramma)	Hiermee geeft u het aantal seconden dat moet worden gewacht voordat de verbindingspoging mislukt.	Geen timeout.
MultipleActiveResultSets	1 of true om meerdere actieve resultatensets te gebruiken. 0 of false om meerdere actieve resultatensets uit te schakelen.	Hiermee wordt ondersteuning voor meerdere actieve resultatensets (MARS) uitgeschakeld of expliciet ingeschakeld. Zie Procedure: Meerdere actieve resultatensets (MARS) uitschakelen voor meer informatie.	waar (1)
MultiSubnetFailover	Snaar / Touwtje	Specificeer altijd multiSubnetFailover=yes wanneer u verbinding maakt met de listener van een SQL Server 2012-beschikbaarheidsgroep (11.x) of een SQL Server 2012-failoverclusterexemplaar (11.x). multiSubnetFailover=yes configureert Microsoft-stuurprogramma's voor PHP voor SQL Server om snellere detectie en verbinding te bieden met de (momenteel) actieve server. Mogelijke waarden zijn Ja en Nee. Zie Ondersteuning voor hoge beschikbaarheid, herstel na noodgevallen voor meer informatie over Microsoft-stuurprogramma's voor PHP voor SQL Server-ondersteuning voor AlwaysOn-beschikbaarheidsgroepen.	Nee.
PWD (niet ondersteund in het PDO_SQLSRV-stuurprogramma)	Snaar / Touwtje	Hiermee geeft u het wachtwoord op dat is gekoppeld aan de gebruikers-id die moet worden gebruikt bij het maken van verbinding met SQL Server-verificatie4.	Niet ingesteld.
GeciteerdeId	1 of waar om SQL-92-regels te gebruiken. 0 of false om verouderde regels te gebruiken.	Hiermee specificeert u of u de SQL-92-regels voor geciteerde identificatoren (1 of waar) wilt gebruiken of de verouderde Transact-SQL-regels (0 of onwaar).	waar (1)
ReturnDatesAsStrings (niet ondersteund in het PDO_SQLSRV-stuurprogramma)	1 of true om datums en tijden als tekenreeksen te retourneren. 0 of false om datum- en tijdtypen als PHP DateTime-typen te retourneren.	Haalt datum- en tijdtypen (datum/tijd, smalldatetime, datum, tijd, datum/tijd2 en datetimeoffset) op als tekenreeksen of als PHP-typen. Voor meer informatie, zie Datum- en tijdtypen ophalen als tekenreeksen met behulp van het SQLSRV-stuurprogramma. Wanneer u het stuurprogramma PDO_SQLSRV gebruikt, worden datums geretourneerd als tekenreeksen, tenzij anders is opgegeven. Zie Procedure: Datum- en tijdtypen ophalen als PHP-datum/tijdobjecten met behulp van het PDO_SQLSRV-stuurprogramma voor meer informatie.	onwaar
Schuifbaar	Snaar / Touwtje	'gebufferd' geeft aan dat u een cursor aan de clientzijde (gebufferd) wilt, zodat u een volledige resultatenset in het geheugen kunt opslaan. Zie Cursortypen (SQLSRV-stuurprogramma) voor meer informatie.	Alleen-vooruit-cursor
Server (niet ondersteund in het SQLSRV-stuurprogramma)	Snaar / Touwtje	Het SQL Server-exemplaar waarmee verbinding moet worden gemaakt. U kunt ook een naam voor een virtueel netwerk opgeven om verbinding te maken met een AlwaysOn-beschikbaarheidsgroep. Zie Ondersteuning voor hoge beschikbaarheid, herstel na noodgevallen voor meer informatie over Microsoft-stuurprogramma's voor PHP voor SQL Server-ondersteuning voor AlwaysOn-beschikbaarheidsgroepen.	Server is een vereist trefwoord (hoewel dit niet het eerste trefwoord in de verbindingsreeks hoeft te zijn). Als een servernaam niet wordt doorgegeven aan het trefwoord, wordt geprobeerd verbinding te maken met het lokale exemplaar. De waarde die wordt doorgegeven aan Server, kan de naam zijn van een SQL Server-exemplaar of het IP-adres van het exemplaar. U kunt desgewenst een poortnummer opgeven (bijvoorbeeld sqlsrv:server=(local),1033). Vanaf versie 3.0 van de Microsoft-stuurprogramma's voor PHP voor SQL Server kunt u ook een LocalDB-exemplaar opgeven met server=(localdb)\instancename. Zie Ondersteuning voor LocalDB voor meer informatie.
TraceFile	Snaar / Touwtje	Hiermee geeft u het pad op voor het bestand dat wordt gebruikt voor traceringsgegevens.	Niet ingesteld.
TraceOn	1 of true om de tracering in te schakelen. 0 of false om tracering uit te schakelen.	Hiermee geeft u op of ODBC-tracering is ingeschakeld (1 of waar) of uitgeschakeld (0 of onwaar) voor de verbinding die tot stand wordt gebracht.	false (0)
TransactionIsolation	Het SQLSRV-stuurprogramma gebruikt de volgende waarden: SQLSRV_TXN_READ_UNCOMMITTED SQLSRV_TXN_READ_COMMITTED SQLSRV_TXN_REPEATABLE_READ SQLSRV_TXN_SNAPSHOT SQLSRV_TXN_SERIALIZABLE Het PDO_SQLSRV stuurprogramma gebruikt de volgende waarden: PDO::SQLSRV_TXN_READ_UNCOMMITTED PDO::SQLSRV_TXN_READ_COMMITTED PDO::SQLSRV_TXN_REPEATABLE_READ PDO::SQLSRV_TXN_SNAPSHOT PDO::SQLSRV_TXN_SERIALIZABLE	Hiermee geeft u het niveau van transactieisolatie op. Zie SET TRANSACTION ISOLATION LEVEL in de SQL Server-documentatie voor meer informatie over transactieisolatie .	SQLSRV_TXN_READ_COMMITTED or PDO::SQLSRV_TXN_READ_COMMITTED
TransparanteNetwerkIPResolutie	Ingeschakeld of uitgeschakeld	Beïnvloedt de verbindingsreeks wanneer het eerste opgeloste IP-adres van de hostnaam niet reageert en er meerdere IP-adressen zijn gekoppeld aan de hostnaam. Het communiceert met MultiSubnetFailover om verschillende verbindingsreeksen te bieden. Voor meer informatie, zie Transparent Network IP Resolution of Using Transparent Network IP Resolution.	Ingeschakeld
TrustServerCertificate	1 of true om het certificaat te vertrouwen. 0 of onwaar om het certificaat niet te vertrouwen.	Hiermee geeft u op of de client een zelfondertekend servercertificaat moet vertrouwen (1 of waar) of weigeren (0 of onwaar).	false (0)
unieke identificatie (niet ondersteund in het PDO_SQLSRV-stuurprogramma)	Snaar / Touwtje	Hiermee geeft u de gebruikers-id op die moet worden gebruikt bij het maken van verbinding met SQL Server Authentication4.	Niet ingesteld.
WSID	Snaar / Touwtje	Hiermee geeft u de naam van de computer voor tracering.	Niet ingesteld.

1. Het ConnectionPooling kenmerk kan niet worden gebruikt om groepsgewijze verbindingen in Linux en macOS in of uit te schakelen. Zie Groepsgewijze verbindingen (Microsoft-stuurprogramma's voor PHP voor SQL Server).

2. Alle query's die worden uitgevoerd op de tot stand gebrachte verbinding, worden gemaakt met de database die is opgegeven door het Database kenmerk. Als de gebruiker echter over de juiste machtigingen beschikt, kunnen gegevens in andere databases worden geopend met behulp van een volledig gekwalificeerde naam. Als de hoofddatabase bijvoorbeeld is ingesteld met het Database verbindingskenmerk, is het nog steeds mogelijk om een Transact-SQL query uit te voeren die toegang heeft tot de tabel AdventureWorks.HumanResources.Employee met behulp van de volledig gekwalificeerde naam.

3. Het inschakelen Encryption kan van invloed zijn op de prestaties van sommige toepassingen vanwege de rekenkundige overhead die nodig is om gegevens te versleutelen.

4. De UID en PWD kenmerken moeten beide worden ingesteld bij het maken van verbinding met SQL Server-verificatie.

Veel van de ondersteunde sleutels zijn ODBC-verbindingsreekskenmerken. Zie Trefwoorden voor verbindingsreeksen gebruiken met SQL Native Client voor informatie over ODBC-verbindingsreeksen.

Zie ook

Verbinding maken met de server