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 認証を使用して接続する場合、ログイン ID を指定します。 Windows 認証を使用して接続するには、 ""を指定します。

$password: 省略可です。 ユーザー パスワードを含む文字列です。 SQL Server 認証を使用して接続する場合、パスワードを指定します。 Windows 認証を使用して接続するには、 ""を指定します。

$driver_options: 省略可能。 PDO ドライバー マネージャーの属性および Microsoft SQL Server 用 Drivers for PHP に固有のドライバー属性 (PDO::SQLSRV_ATTR_ENCODING、PDO::SQLSRV_ATTR_DIRECT_QUERY) を指定できます。 無効な属性では、例外は生成されません。 無効な属性を PDO::setAttributeと共に指定すると、例外が生成されます。

戻り値

PDO オブジェクトを返します。 失敗した場合は、PDOException オブジェクトを返します。

例外

PDOException

解説

インスタンスを null に設定して、接続オブジェクトを閉じることができます。

接続後、PDO::errorCode には 00000 の代わりに 01000 が表示されます。

何らかの理由で PDO::__construct が失敗する場合、PDO::ATTR_ERRMODE が PDO::ERRMODE_SILENT に設定されていても例外がスローされます。

PDO のサポートは Microsoft SQL Server 用 Drivers for PHPのバージョン 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