Net_NNTP_Client::connectAuthenticated()

Net_NNTP_Client::connectAuthenticated() -- Connect and authenticate to a NNTP-server

Synopsis

      require_once 'Net/NNTP/Client.php';

boolean Net_NNTP_Client::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 NNTP-server

Warning

This function is deprecated. That means that future versions of this package may not support it anymore.

Parameter

$user - Username to authenticate
$pass - Password to authenticate
$host - Hostname of the NNTP-server. Default=NET_NNTP_PROTOCOL_DEFAULT_HOST
$port - Port, where the NNTP-server listens. Default=NET_NNTP_PROTOCOL_DEFAULT_PORT
$authmode - Type of authentication. Default=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 $host"` or `"Not connected"`	The connection couldn't be established because wrong hostname/ip-address or port the host itself isn't linked to a network a firewall doesn't allow 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_Client::connect() Net_NNTP_Client::quit(),

Example

Using connectauthenticated()

      
<?php
require_once 'Net/NNTP/Client.php';

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