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

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

Using getHeaders()

      
<?php
...

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