PEAR Справочное руководство
Пред.		След.

Net_NNTP::prepareConnection()

Net_NNTP::prepareConnection() -- connects to a newsgroup on a newsserver

Synopsis

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]]]])

Описание

Connect to a specific newsserver and access the given newsgroup

Внимание

Эта функция объявлена как deprecated. Это означает, что в будущих версиях пакета она может больше не поддерживаться.

Consider this method deprecated - use Net_NNTP::connectAuthenticated() instead.

Параметр

$nntpserver - Name of the newsserver to connect
$port - Port, where the newsserver listens
$newsgroup - Newsgroup to access
$user - Username to authenticate
$user - Username to authenticate
$pass - Password to authenticate
$authmode - Type of authentication, at the moment only PEAR_NNTP_AUTHORIGINAL

Возвращаемое значение

boolean - TRUE if successful

Throws

Таблица 49-1. Возможные значения PEAR_Error

Error code Error message Reason Solution

Error code	Error message	Reason	Solution
`NULL`	`"Could not connect to NNTP-server $nntpserver"` or `"Not connected"`	The connection couldn't be established because wrong server name or adress the host itself isn't link to a network a firewall doesn't allow an access	Check for server name, the connection to the net and possible firewalls on client or server side
`NULL`	Every other message	This message is directly passed from the news server, in the most cases caused by calling a non existing newsgroup	Check the given newsgroup name

NULL

"Could not connect to NNTP-server $nntpserver" or "Not connected"

The connection couldn't be established because

wrong server name or adress
the host itself isn't link to a network
a firewall doesn't allow an access

Check for server name, the connection to the net and possible firewalls on client or server side

NULL Every other message This message is directly passed from the news server, in the most cases caused by calling a non existing newsgroup Check the given newsgroup name

Заметка

Эта функция не должна вызываться статически.

Внимание

Fetching data with a connection created with prepareConnection() is faster then a created connection with connect()

См. также

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

Пример

Пример 49-1. Using prepareConnection()

require_once "Net/NNTP.php";

$nntp = new Net_NNTP;
$ret = $nntp->connect("news.php.net", 119, "php.pear.dev");
if( PEAR::isError($ret)) {
 // handle error
} else {
 // success
}

Пред.	Начало	След.
Net_NNTP::post()	Уровень выше	Net_NNTP::quit()

HIVE: All information for read only. Please respect copyright!