PHP マニュアル
前のページ |  | 次のページ

# ircg_pconnect

(PHP 4 >= 4.0.4, PHP 5 <= 5.0.4)

ircg_pconnect -- IRC サーバに接続する

## 説明

resource ircg_pconnect ( string username [, string server_ip [, int server_port [, string msg_format [, array ctcp_messages [, array user_settings [, bool bailout_on_trivial]]]]]] )

ircg_pconnect() は、IRC サーバへの接続を 確立しようと試み、後で使用するための接続リソースハンドルを返します。

必須パラメータは `username` のみで、 ここでサーバ上の初期ニックネームを設定します。 `server_ip` および `server_port` はオプションで、デフォルトは `127.0.0.1` および `6667` です。

> 注意: 現時点では、パラメータ `server_ip` は ホスト名の解決を行わないため、数値表現の IP アドレスしか受け付けません。 DNS 検索はコストがかかる処理で、IRCG で行うべきです。

事前に ircg_register_format_messages() で作成した フォーマットメッセージセットの名前を `msg_format` に指定することで、IRC のメッセージやイベントの出力をカスタマイズ することが可能です。

ACTION (/me) のような CTCP メッセージを扱いたい場合は、 CTCP 型 (例: ACTION) からカスタムフォーマット文字列への マッピングを定義する必要があります。そうするには、 `ctcp_messages` に連想配列を渡します。 配列のキーが CTCP 型で、対応する値がフォーマットメッセージとなります。

IRC サーバに送信する "ident"、"password" および "realname" トークンを 連想配列として指定することが可能です。この連想配列を `user_settings` に設定します。

ircg_disconnect()、 ircg_is_conn_alive()、 ircg_register_format_messages() も参照ください。

前のページ | ホーム | 次のページ
ircg_part | 上に戻る | ircg_register_format_messages