PDO::__construct
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;
?>