PEAR Manual
PrevNext

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

Return value

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

Throws

Table 38-1. Possible PEAR_Error values

Error codeError messageReasonSolution
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 38-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);
}
PrevHomeNext
Net_NNTP::getHeaderRaw()UpNet_NNTP::getOverview()