FrontBase サーバへの持続的接続をオープンする

説明

resource fbsql_pconnect ([ string $hostname = ini_get("fbsql.default_host") [, string $username = ini_get("fbsql.default_user") [, string $password = ini_get("fbsql.default_password") ]]] )

FrontBase サーバへの持続的な接続を確立します。

サーバのポート番号を指定するには fbsql_select_db() を使用します。

fbsql_pconnect() は fbsql_connect() とほとんど同じように動作しますが、 2 つの大きな違いがあります。

まず、接続の際に、この関数は事前に同じホスト・ユーザ名・パスワードでオープンされている (持続的) リンクを探そうとします。見つかった場合には、新しい接続をオープンせずにその接続の ID を返します。

次に、SQL サーバへの接続はスクリプトが終了しても閉じられません。その代わりに、今後利用されるときのためにオープンされたままとなります。

これらにより、この形式のリンクは「持続的(persistent)」と呼ばれます。

パラメータ

hostname: ホスト名。
username: 接続時のユーザ名。
password: 接続時のパスワード。

返り値

成功した場合には正の FrontBase 持続的リンク ID、エラー時には FALSE を返します。

参考

fbsql_connect() - FrontBase サーバへの接続をオープンする