(PHP 4, PHP 5, PECL odbtp >= 1.1.1)
mssql_pconnect — 持続的 MS SQL 接続をオープンする
この関数は PHP 7.0.0 で 削除 されました。
この関数の代替として、これらが使えます。
$servername
[, string $username
[, string $password
[, bool $new_link
= false
]]]] )mssql_pconnect() は mssql_connect() とほとんど同じく動作しますが、違う点が 2 つあります。
第 1 に、この関数は接続時に同じホスト、ユーザー名、パスワードで既に オープンされている(持続的)リンクを探そうとします。 もし見つかった場合、新規の接続をオープンせずにその ID を返します。
第 2 に、SQL サーバーはスクリプトの実行終了時に接続を閉じません。 代わりに、リンクは後に使用されるためにオープンされたままとします (mssql_close() は mssql_pconnect() により確立されたリンクを閉じません)。
この型のリンクはこのため '持続的である' と呼ばれます。
servername
MS SQL サーバー。 hostname:port のようにポート番号を含めることもできます。
username
ユーザー名。
password
パスワード。
new_link
同じ引数で mssql_pconnect() が再度コールされた場合、 新規のリンクは作成されず、代わりに既にオープンされたリンク ID が返されます。 このパラメータは、この振る舞いを変更し、mssql_pconnect() が常に新しいリンクを返すようにします。同じパラメータで事前に mssql_pconnect() がコールされていたとしても、 新しいリンクを返します。
成功時に正の MS SQL 持続的リンク ID、エラー時に FALSE
を返します。
例1 mssql_pconnect() で new_link
を使う例
<?php
// MSSQL に接続し、データベースを選択します
$link1 = mssql_pconnect('MANGO\SQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php', $link1);
// 新しいリンクを作成します
$link2 = mssql_pconnect('MANGO\SQLEXPRESS', 'sa', 'phpfi', true);
mssql_select_db('random', $link2);
?>