PEAR Manual
Prev |  | Next

# Net_NNTP::getArticle()

Net_NNTP::getArticle() -- fetch an article from a new server

## Synopsis

    require_once 'Net/NNTP.php';

``mixed Net_NNTP::getArticle` (string $articleId)`

## Description

Returns the whole article from the current selected newsgroup

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

Consider this method deprecated and subject to changes - use Net_NNTP::getArticleRaw() instead.

## Parameter

- `string $articleID` - Message-ID of the message number to fetch

## Return value

`string` - If message exists the message as string or a PEAR_Error, if fail.

## Throws

Table 48-1. Possible PEAR_Error values

Error code | Error message | Reason | Solution
--- | --- | --- | ---
`NULL` | Different error messages | The messages are directly passed from the news server, in the most cases caused by calling a non existing article | Check the article ID or if your are still connected to the server ( Net_NNTP::isConnected())

## Note

This function can not be called statically.

## See

Net_NNTP::getHeaders() , Net_NNTP::getBody() , Net_NNTP::getOverview()

## Example

Example 48-1. Using getArticle()
    ...
    $article = $nntp->getArticle($msg_id);
    if( PEAR::isError($article)) {
     // handle error
    } else {
     // success
    }

Prev | Home | Next
Net_NNTP::first() | Up | Net_NNTP::getArticleRaw()