PEAR マニュアル
前のページ次のページ

Net_NNTP::prepareConnection()

Net_NNTP::prepareConnection() -- ニュースサーバ上のニュースグループに接続する

概要

require_once 'Net/NNTP.php';

boolean Net_NNTP::prepareConnection (string $nntpserver [, integer $port = 119, integer $newsgroup [, integer $user = NULL [, integer $pass = NULL, integer [$authmode = PEAR_NNTP_ORIGINAL]]]])

説明

指定したニュースサーバに接続し、ニュースグループにアクセスします。

警告

この関数は 非推奨の関数です。 今後、このパッケージの将来のバージョンでは、 サポートされないかもしれません。

この関数は廃止予定であることに気をつけてください。 代わりに Net_NNTP::connectAuthenticated() を利用してください。

パラメータ

返り値

boolean - 成功した場合は TRUE を返します。

例外・エラー

表 54-1PEAR_Error の値

エラー番号エラーメッセージ原因対応方法
NULL "Could not connect to NNTP-server $nntpserver" または "Not connected" 接続が確立できませんでした。原因は

  • サーバ名あるいは IP アドレスが間違っている

  • ホストがネットワークに接続されていない

  • ファイアウォールによってアクセスが制限されている

 サーバ名やネットワーク接続の状況を調べます。また、可能なら ファイアウォールの設定も確かめます。
NULL それ以外のすべてのメッセージ ニュースサーバから返される文字列をそのままの形式で返します。 たいがいの場合、存在しないニュースグループを指定したことが原因です。 ニュースグループの名前を確認します。

注意

この関数は、スタティックにコールする ことはできません。

警告

この関数は 非推奨の関数です。 今後、このパッケージの将来のバージョンでは、 サポートされないかもしれません。

データの取得速度は、 prepareConnection() による接続のほうが connect() で接続した場合より早くなります。

参照

Net_NNTP::quit(), Net_NNTP::connect()

例

例 54-1prepareConnection() の使用

require_once "Net/NNTP.php";

$nntp = new Net_NNTP;
$ret = $nntp->connect("news.php.net", 119, "php.pear.dev");
if( PEAR::isError($ret)) {
 // エラー処理
} else {
 // 成功
}
前のページホーム次のページ
Net_NNTP::post()上に戻るNet_NNTP::quit()