Php/docs/function.fbsql-pconnect

提供:Dev Guides
< Php
移動先:案内検索

fbsql_pconnect

(PHP 4 >= 4.0.6, PHP 5 < 5.3.0)

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


説明

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

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

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

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

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

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

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


パラメータ

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


返り値

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


参考