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

説明

resource mysql_pconnect ([ string $server = ini_get("mysql.default_host") [, string $username = ini_get("mysql.default_user") [, string $password = ini_get("mysql.default_password") [, int $client_flags ]]]] )

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

mysql_pconnect()は、 mysql_connect()とよく似た動作をしますが、 2 つの大きな違いがあります。

1 番目の違いとして、この関数は接続時にまず同じホスト、ユーザ名、パスワードを有する(持続的)リンクがすでにオープンされていないかどうかを調べます。それがみつかった場合、新規の接続をオープンする代わりにそのリンクの ID が返されます。

2 番目の違いは、スクリプトの実行が終了しても SQL サーバとの接続が閉じられないということです。そのかわりに、将来再利用されるためにリンクがオープンされたままとなります（mysql_close() は、mysql_pconnect() によって確立されたリンクを閉じません）。

このため、この型のリンクは、'持続的(persistent)'であると言われます。

パラメータ

server

MySQL サーバ。"hostname:port" のようにポート番号を指定することが可能で、localhost では ":/path/to/socket" のようにソケットへのパスを指定することも可能です。

PHP ディレクティブ mysql.default_host が指定されない場合（デフォルト）、 'localhost:3306' が使用されます。

username

ユーザ名。デフォルト値はサーバプロセスの所有ユーザ名です。

password

パスワード。デフォルト値は空のパスワードです。

client_flags

パラメータ client_flags は、以下の定数の組み合わせです： 128 (LOAD DATA LOCAL の処理を有効にする)、 MYSQL_CLIENT_SSL、 MYSQL_CLIENT_COMPRESS、 MYSQL_CLIENT_IGNORE_SPACE または MYSQL_CLIENT_INTERACTIVE

返り値

成功した場合に MySQL 持続的リンク ID を、失敗した場合に FALSE を返します。

変更履歴

バージョン	説明
4.3.0	パラメータ `client_flags` が追加されました。

注意

注意:
この接続方法は、モジュールバージョンの PHP でのみ使用可能であることに注意しましょう。詳しい情報は持続的データベース接続を参照ください。

警告

持続的接続を利用する場合、MySQL の同時接続数の制限をこえないように Apache や MySQL の設定を多少変更する必要があるかも知れません。

注意:
関数名の前に @ を追加すると、失敗した場合のエラーメッセージを抑制できます。

参考

mysql_connect() - MySQL サーバへの接続をオープンする
Persistent Database Connections