建立與 SQL Server 資料庫的連線。
語法
PDO::__construct($dsn [,$username [,$password [,$driver_options ]]] )
參數
$dsn:包含前綴名稱(永遠 sqlsrv)、冒號及伺服器關鍵字的字串。 例如: "sqlsrv:server=(local)" 。 您可以選擇性地指定其他連接關鍵字。 如需 Server 關鍵字和其他連接關鍵字的說明,請參閱 Connection Options 。 整個 $dsn 會以引號括住,因此每個連接關鍵字不應分別加上引號。
$username:可選。 包含使用者名稱的字串。 若要使用 SQL Server 驗證連線,請指定登入識別碼。 若要使用 Windows 驗證進行連接,請指定 ""。
$password:可選。 包含使用者密碼的字串。 若要使用 SQL Server 驗證連線,請指定密碼。 若要使用 Windows 驗證進行連接,請指定 ""。
$driver_options:選填。 您可以指定 PDO 驅動程式管理員屬性和 Microsoft Drivers for PHP for SQL Server 的特定驅動程式屬性 -- PDO::SQLSRV_ATTR_ENCODING, PDO::SQLSRV_ATTR_DIRECT_QUERY。 當 PDO::ATTR_ERRMODE 為 PDO::ERRMODE_EXCEPTION預設值時,若屬性或屬性值無效,建構函式會拋出 PDOException 帶有 SQLSTATE IMSSP的 。
PDO::setAttribute 以相同方式驗證屬性。
設定 PDO::SQLSRV_ATTR_DEFAULT_STR_LENGTH , $driver_options 以指定新語句中符合條件輸入字串的初始自適應長度。 預設值為 0 (停用);接受的值為 0 到 8,000 的整數。 一個無效的值會回報 SQLSTATE IMSSP。 有關範例與限制,請參閱 「宣告輸入字串類型與長度(PDO_SQLSRV)」。
傳回值
傳回 PDO 物件。 如果失敗,會傳回 PDOException 物件。
例外狀況
PDOException
備註
您可以將執行個體設為 Null,以關閉連接物件。
連線之後,PDO::errorCode 將會顯示 01000,而不是 00000。
如果 PDO::__construct 因故失敗,則會擲回例外狀況,即使 PDO::ATTR_ERRMODE 設定為 PDO::ERRMODE_SILENT 亦然。
PDO 支援已新增至 Microsoft Drivers for PHP for SQL Server 2.0 版。
附資料庫的範例
此範例說明如何使用 Windows 驗證連接到伺服器,並指定資料庫。
<?php
$c = new PDO( "sqlsrv:Server=(local) ; Database = AdventureWorks ", "", "", array(PDO::SQLSRV_ATTR_DIRECT_QUERY => true));
$query = 'SELECT * FROM Person.ContactType';
$stmt = $c->query( $query );
while ( $row = $stmt->fetch( PDO::FETCH_ASSOC ) ) {
print_r( $row );
}
$c = null;
?>
不附資料庫的範例
此範例說明如何在後續指定資料庫,以連接到伺服器。
<?php
$c = new PDO( "sqlsrv:server=(local)");
$c->exec( "USE AdventureWorks2022" );
$query = 'SELECT * FROM Person.ContactType';
$stmt = $c->query( $query );
while ( $row = $stmt->fetch( PDO::FETCH_ASSOC ) ){
print_r( $row );
}
$c = null;
?>