(PECL pdo_sqlsrv >= 2.0.1)
PDO_SQLSRV DSN — Connecting to MS SQL Server and SQL Azure databases
The PDO_SQLSRV Data Source Name (DSN) is composed of the following elements:
The DSN prefix is sqlsrv:
.
APP
The application name used in tracing.
ConnectionPooling
Specifies whether the connection is assigned from a connection pool
(1 or TRUE
) or not (0 or FALSE
).
Database
The name of the database.
Encrypt
Specifies whether the communication with SQL Server is encrypted
(1 or TRUE
) or unencrypted (0 or FALSE
).
Failover_Partner
Specifies the server and instance of the database's mirror (if enabled and configured) to use when the primary server is unavailable.
LoginTimeout
Specifies the number of seconds to wait before failing the connection attempt.
MultipleActiveResultSets
Disables or explicitly enables support for multiple active Result sets (MARS).
QuotedId
Specifies whether to use SQL-92 rules for quoted identifiers (1 or TRUE
)
or to use legacy Transact-SQL rules (0 or FALSE
).
Server
The name of the database server.
TraceFile
Specifies the path for the file used for trace data.
TraceOn
Specifies whether ODBC tracing is enabled (1 or TRUE
) or disabled
(0 or FALSE
) for the connection being established.
TransactionIsolation
Specifies the transaction isolation level. The accepted values for this option are PDO::SQLSRV_TXN_READ_UNCOMMITTED, PDO::SQLSRV_TXN_READ_COMMITTED, PDO::SQLSRV_TXN_REPEATABLE_READ, PDO::SQLSRV_TXN_SNAPSHOT, and PDO::SQLSRV_TXN_SERIALIZABLE.
TrustServerCertificate
Specifies whether the client should trust (1 or TRUE
) or reject
(0 or FALSE
) a self-signed server certificate.
WSID
Specifies the name of the computer for tracing.
Example #1 PDO_SQLSRV DSN examples
The following example shows how to connecto to a specified MS SQL Server database:
$c = new PDO("sqlsrv:Server=localhost;Database=testdb", "UserName", "Password");
The following example shows how to connect to a MS SQL Server database on a specified port:
$c = new PDO("sqlsrv:Server=localhost,1521;Database=testdb", "UserName", "Password");
The following example shows how to connecto to a SQL Azure database with server ID 12345abcde. Note that when you connect to SQL Azure with PDO, your username will be UserName@12345abcde (UserName@ServerId).
$c = new PDO("sqlsrv:Server=12345abcde.database.windows.net;Database=testdb", "UserName@12345abcde", "Password");