共用方式為


PDO::__construct

下載 PHP 驅動程式

建立與 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