sqlsrv_connect

  • [アーティクル]

PHP ドライバーのダウンロード

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

構文

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

パラメーター

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

Microsoft SQL Server 用 Drivers for PHPのバージョン 3.0 以降では、 "(localdb)\instancename"で LocalDB インスタンスを指定することもできます。 詳細については、「LocalDB のサポート」を参照してください。

また、Microsoft Drivers for PHP for SQL Server バージョン 3.0 以降、Always On 可用性グループへの接続に仮想ネットワーク名を指定することもできます。 Always On 可用性グループに対する Microsoft SQL Server 用 Drivers for PHP サポートの詳細については、「高可用性およびディザスター リカバリーのサポート」をご覧ください。

$connectionInfo [省略可能]: 接続属性を含む連想 array です (たとえば、array("Database" => "AdventureWorks"))。 配列でサポートしているキーの一覧については、「 Connection Options 」を参照してください。

戻り値

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

解説

UID キーおよび PWD キーの値がオプションの $connectionInfo パラメーターで指定されていない場合、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, "Database"=>"AdventureWorks");  
*/  
$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);  
?>

参照

SQLSRV ドライバー API リファレンス

サーバーへの接続

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