PDO::__construct

發行項
06/02/2023

建立與 SQL Server 資料庫的連線。

語法

  
PDO::__construct($dsn [,$username [,$password [,$driver_options ]]] )

參數

$dsn：一個字串，其中包含前置詞名稱 (一律為 sqlsrv)、冒號與 Server 關鍵字。例如： "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::setAttribute一起指定時，無效的屬性會產生例外狀況。

傳回值

傳回 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;  
?>

另請參閱

PDO 類別

PDO