Net_NNTP::connectAuthenticated()

Net_NNTP::connectAuthenticated() -- Connects and authenticates to a newsserver

Synopsis

      require_once 'Net/NNTP.php';

boolean Net_NNTP::connectAuthenticated ( integer $user = NULL , integer $pass = NULL , string $host = NET_NNTP_PROTOCOL_DEFAULT_HOST , integer $port = NET_NNTP_PROTOCOL_DEFAULT_PORT , integer $authmode = NET_NNTP_AUTHORIGINAL )

Description

Connect and authenticate to a specific newsserver

Parameter

$user - Username to authenticate
$pass - Password to authenticate
$host - Hostname of the NNTP-server
$port - Port, where the newsserver listens
$authmode - Type of authentication, at the moment only NET_NNTP_AUTHORIGINAL

Return value

boolean - Returns TRUE on success, PEAR_Error on failure.

Throws

Possible PEAR_Error values

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

Note

since 0.3

This function can not be called statically.

See

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

Example

Using connectauthenticated()

      
<?php
require_once "Net/NNTP.php";

$nntp = new Net_NNTP;
$ret = $nntp->connectAuthenticated("news.php.net");
if( PEAR::isError($ret)) {
 // handle error
} else {
 // success
}
?>