PEAR Manual
Prev |  | Next

# Net_NNTP::getHeaders()

Net_NNTP::getHeaders() -- fetch message headers

## Synopsis

    require_once 'Net/NNTP.php';

``string Net_NNTP::getHeaders` (string $articleId)`

## Description

Returns all avaible header lines of a specified message in 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::getHeaderRaw() instead.

## Parameter

- string `$articleId` - Message-ID or Message number

## Return value

`string` - If message exists the headers 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::splitHeaders() , Net_NNTP::getBody() , Net_NNTP::getOverview()

## Example

Example 48-1. Using getHeaders()
    ...

    $headers = $nntp->getHeaders($msgId);
    if( PEAR::isError($headers)) {
     // handle error
    } else {
     // success - split the string into a array
     $headersArray = explode( "\n", $headers);
    }

Prev | Home | Next
Net_NNTP::getHeaderRaw() | Up | Net_NNTP::getOverview()