Net_NNTP::prepareConnection()
Synopsis
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
This function is deprecated. That means that future versions of this package may not support it anymore.
Consider this method deprecated - use Net_NNTP::connectAuthenticated() instead.
Parameter
-
$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
Return value
boolean -
TRUE if successful
Throws
| Error code | Error message | Reason | Solution |
|---|---|---|---|
| NULL |
"Could not connect to NNTP-server $nntpserver"
or
"Not connected"
|
The connection couldn't be established because
|
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.
This function is deprecated. That means that future versions of this package may not support it anymore.
Fetching data with a connection created with prepareConnection() is faster then a created connection with connect()
Example
Using prepareConnection()
<?php
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
}
?>