sqlsrv_connect

接続リソースを作成し、接続を開きます。既定では、Windows 認証を使用して接続が試行されます。

構文

sqlsrv_connect( string $serverName [, array $connectionInfo])

パラメータ

$serverName: 接続を確立するサーバーの名前を指定する文字列。この文字列の一部としてインスタンス名 (例 : "myServer\instanceName") やポート番号 (例 : "myServer, 1521") を含めることができます。このパラメーターで使用できるオプションの詳細については、「SQL Native Client での接続文字列キーワードの使用」の「ODBC ドライバー接続文字列キーワード」の Server キーワードの説明を参照してください。

$connectionInfo [オプション]: 接続属性を含む連想 array (例 : array("Database" => "AdventureWorks"))。サポートされている配列のキーを次の表に示します。

1. 確立された接続で実行するクエリはすべて、Database 属性で指定したデータベースに対して実行されます。ただし、ユーザーに適切な権限があれば、完全修飾名を使用して他のデータベースのデータにアクセスすることもできます。たとえば、Database 接続属性で master データベースが設定されていても、完全修飾名を使用すれば、AdventureWorks.HumanResources.Employee テーブルにアクセスする Transact-SQL クエリを実行できます。

2. Encryption を有効にすると、データを暗号化するために必要な計算のオーバーヘッドにより、一部のアプリケーションのパフォーマンスに影響が及ぶ可能性があります。

3. SQL Server 認証を使用して接続するときには、UID と PWD の両方の属性を設定する必要があります。

サポートされているキーの多くは ODBC 接続文字列の属性です。ODBC 接続文字列については、「SQL Native Client での接続文字列キーワードの使用」を参照してください。

戻り値

PHP 接続リソース。接続を正常に作成して開くことができない場合は false が返されます。

解説

省略可能な $connectionInfo パラメーターで UID キーと PWD キーが指定されていない場合は、Windows 認証を使用して接続が試行されます。サーバーへの接続の詳細については、「Windows 認証を使用して接続する方法」および「SQL Server 認証を使用して接続する方法」を参照してください。

例

次の例では、Windows 認証を使用して接続を作成し、開きます。この例では、SQL Server と AdventureWorks データベースがローカル コンピューターにインストールされていることを前提としています。この例をコマンド ラインから実行した場合、すべての出力はコンソールに書き込まれます。

<?php
/*
Connect to the local server using Windows Authentication and specify
the AdventureWorks database as the database in use. To connect using
SQL Server Authentication, set values for the "UID" and "PWD"
 attributes in the $connectionInfo parameter. For example:
$connectionInfo = array("UID" => $uid, "PWD" => $pwd)); 
*/
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);

if( $conn )
{
     echo "Connection established.\n";
}
else
{
     echo "Connection could not be established.\n";
     die( print_r( sqlsrv_errors(), true));
}

//-----------------------------------------------
// Perform operations with connection.
//-----------------------------------------------

/* Close the connection. */
sqlsrv_close( $conn);
?>

参照

概念

ドキュメントのコード例について

その他のリソース

API リファレンス (SQL Server Driver for PHP)
サーバーへの接続