PEAR Manual
PrevNext

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

Description

Connect to a specific newsserver and access the given newsgroup

Parameter

Return value

boolean - TRUE if successful

Throws

Table 31-1. Possible PEAR_Error values

Error codeError messageReasonSolution
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

Note

This function can not be called statically

Warning

This function is deprecated. So it could not be supported in further package releases.

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

See

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

Example

Example 31-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
}
PrevHomeNext
Net_NNTP::min()UpNet_NNTP::post()