int mysql_pconnect(string
[hostname
[:port]
[:/path/to/socket]
]
, string
[username]
, string
[password]
);成功した場合に正の MySQL 持続link_identifier 、エラー時に FALSE を返します。
mysql_pconnect は、MySQL サーバーへの 接続を確立します。全ての引数はオプションであり、 省略された場合には、デフォルト値('localhost'、サーバープロセスの 所有者のユーザ名、空のパスワード)が仮定されます。
文字列 hostname では、"hostname:port" のようにポート番号を 指定したり、localhost において ":/path/to/socket" のようにソケットへのパスを 指定することも可能です。
注意: ":port" のサポートは、3.0B4 で追加されました。
":/path/to/socket" のサポートは 3.0.10 で追加されました。
mysql_pconnect は、二つの点を除いて mysql_connect と全く同様に動作します。
1番目の違いとしては、この関数は、接続時にまず 同じホスト、ユーザ命、パスワードを有する(持続的)リンクが すでにオープンされていないかどうかを調べます。 それがみつかった場合、新規の接続をオープンする代わりに そのリンクの ID が返されます。
2番目の違いは、SQL サーバーへの接続が、 スクリプトの実行終了時にも閉じられないということです。 代わりに、リンクは、将来的な使用のために、オープンされたままと なります。 (mysql_close は、 mysql_pconnectにより確立されたリンクを 閉じません)
このため、この型のリンクは、'持続的(persistent)' であると言われます。