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.

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
}
?>