PEAR Manual
Prev |  | Next

# Net_NNTP::connect()

Net_NNTP::connect() -- Connects to a newsserver

## Synopsis

    require_once 'Net/NNTP.php';

``boolean Net_NNTP::connect` (string $host = NET_NNTP_PROTOCOL_DEFAULT_HOST [, integer $port = NET_NNTP_PROTOCOL_DEFAULT_PORT])`

## Description

Connect to a specific newsserver

## Parameter

- `$host` - Hostname of the newsserver

- `$port` - Port, where the newsserver listens

## Return value

`boolean` - Returns `TRUE` on success, PEAR_Error on failure.

## Throws

Table 48-1. 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 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

This function can not be called statically.

## See

Net_NNTP::quit(), Net_NNTP::pepareConnection()

## Example

Example 48-1. Using connect()
    require_once "Net/NNTP.php";

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

Prev | Home | Next
Net_NNTP::command() | Up | Net_NNTP::connectAuthenticated()