Docs For Class Net_NNTP

Net_NNTP_Protocol (Constructor) [line 102]

Net_NNTP_Protocol Net_NNTP_Protocol(
)

[ Top ]

cmdArticle [line 325]

mixed cmdArticle(
mixed
$article)

Get an article from the currently open connection.

Return: (array) article on success or (object) pear_error on failure
Access: public

Parameters:

mixed $article — Either a message-id or a message-number of the article to fetch. If null or '', then use current article.

[ Top ]

cmdBody [line 420]

mixed cmdBody(
mixed
$article)

Get the body of an article from the currently open connection.

Return: (array) body on success or (object) pear_error on failure
Access: public

Parameters:

mixed $article — Either a message-id or a message-number of the article to fetch the body from. If null or '', then use current article.

[ Top ]

cmdDate [line 940]

mixed cmdDate(
[
$timestamp = false], bool
$timestap)

Get the date from the newsserver format of returned date

Return: (string) 'YYYYMMDDhhmmss' / (int) timestamp on success or (object) pear_error on failure
Access: public

Parameters:

bool	`$timestap`	—	when false function returns string, and when true function returns int/timestamp.
	`$timestamp`	—

[ Top ]

cmdGroup [line 535]

mixed cmdGroup(
string
$newsgroup)

Selects a news group (issue a GROUP command to the server)

Return: (array) groupinfo on success or (object) pear_error on failure
Access: public

Parameters:

string $newsgroup — The newsgroup name

[ Top ]

cmdHead [line 373]

mixed cmdHead(
mixed
$article)

Get the headers of an article from the currently open connection.

Return: (array) headers on success or (object) pear_error on failure
Access: public

Parameters:

mixed $article — Either a message-id or a message-number of the article to fetch the headers from. If null or '', then use current article.

[ Top ]

cmdList [line 569]

mixed cmdList(
)

Fetches a list of all avaible newsgroups

Return: (array) nested array with informations about existing newsgroups on success or (object) pear_error on failure
Access: public

[ Top ]

cmdListgroup [line 875]

mixed cmdListgroup(
string
$newsgroup)

Return: (array) on success or (object) pear_error on failure

Parameters:

string $newsgroup —

[ Top ]

cmdListNewsgroups [line 608]

mixed cmdListNewsgroups(
[string
$wildmat = ''])

Fetches a list of (all) avaible newsgroup descriptions.

Return: (array) nested array with description of existing newsgroups on success or (object) pear_error on failure
Access: public

Parameters:

string $wildmat — Wildmat of the groups, that is to be listed, defaults to '';

[ Top ]

cmdListOverviewFmt [line 728]

mixed cmdListOverviewFmt(
)

Returns a list of avaible headers which are send from newsserver to client for every news message

Return: (array) of header names on success or (object) pear_error on failure
Access: public

[ Top ]

cmdModeReader [line 295]

mixed cmdModeReader(
)

Return: (bool) true when one can post on success or (object) pear_error on failure
Access: public

[ Top ]

cmdNewgroups [line 695]

mixed cmdNewgroups(
int
$time)

Fetches a list of all newsgroups created since a specified date.

Return: (array) nested array with informations about existing newsgroups on success or (object) pear_error on failure
Access: public

Parameters:

int $time — Last time you checked for groups (timestamp).

[ Top ]

cmdNewnews [line 907]

void cmdNewnews(

$time, [
$newsgroups = '*'])

Parameters:

	`$time`	—
	`$newsgroups`	—

[ Top ]

cmdPost [line 477]

mixed cmdPost(
string
$newsgroup, string
$subject, string
$body, string
$from, [optional
$aditional = ''])

Post an article to a newsgroup.

Among the aditional headers you might think of adding could be: "NNTP-Posting-Host: <ip-of-author>", which should contain the IP-adress of the author of the post, so the message can be traced back to him. "Organization: <org>" which contain the name of the organization the post originates from.

Return: (bool) true on success or (object) pear_error on failure
Access: public

Parameters:

string	`$newsgroup`	—	The newsgroup to post to.
string	`$subject`	—	The subject of the post.
string	`$body`	—	The body of the post itself.
string	`$from`	—	Name + email-adress of sender.
optional	`$aditional`	—	string $aditional Aditional headers to send.

[ Top ]

cmdQuit [line 174]

void cmdQuit(
)

Close connection to the server

Access: public

[ Top ]

cmdXGTitle [line 653]

mixed cmdXGTitle(
[string
$wildmat = '*'])

Fetches a list of (all) avaible newsgroup descriptions.

Depresated as of RFC2980.

Return: (array) nested array with description of existing newsgroups on success or (object) pear_error on failure
Access: public

Parameters:

string $wildmat — Wildmat of the groups, that is to be listed, defaults to '*';

[ Top ]

cmdXOver [line 774]

mixed cmdXOver(
integer
$first, integer
$last)

Fetch message header from message number $first until $last

The format of the returned array is: $messages[message_id][header_name]

Return: (array) nested array of message and there headers on success or (object) pear_error on failure
Access: public

Parameters:

integer	`$first`	—	first article to fetch
integer	`$last`	—	last article to fetch

[ Top ]

cmdXROver [line 828]

mixed cmdXROver(
integer
$first, integer
$last)

Fetch message references from message number $first to $last

Return: (array) assoc. array of message references on success or (object) pear_error on failure
Access: public

Parameters:

integer	`$first`	—	first article to fetch
integer	`$last`	—	last article to fetch

[ Top ]

connect [line 118]

mixed connect(
[optional
$host = NET_NNTP_PROTOCOL_DEFAULT_HOST], [optional
$port = NET_NNTP_PROTOCOL_DEFAULT_PORT])

Connect to the server

Return: (bool) true on success or (object) pear_error on failure
Access: public

Overridden in child classes as:

Net_NNTP::connect(): Connect to the newsserver.

Net_NNTP_Realtime::connect(): Connect to the NNTP-server.

Parameters:

optional	`$host`	—	string $host The adress of the NNTP-server to connect to, defaults to 'localhost'.
optional	`$port`	—	int $port The port number to connect to, defaults to 119.

[ Top ]

disconnect [line 161]

void disconnect(
)

alias for cmdQuit()

Access: public

[ Top ]

isConnected [line 970]

bool isConnected(
)

Test whether we are connected or not.

Return: true or false
Access: public

Overridden in child classes as:

Net_NNTP::isConnected(): Test whether we are connected or not.

Net_NNTP_Realtime::isConnected(): Test whether a connection is currently open.

[ Top ]

setDebug [line 986]

bool setDebug(
[boolean
$debug = true])

Sets the debuging information on or off

Return: previos state
Access: public

Parameters:

boolean $debug — True or false

[ Top ]

Class: Net_NNTP_Protocol

Class Overview

Author(s):

Version:

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Method Detail

Net_NNTP_Protocol (Constructor) [line 102]

cmdArticle [line 325]

Parameters:

cmdBody [line 420]

Parameters:

cmdDate [line 940]

Parameters:

cmdGroup [line 535]

Parameters:

cmdHead [line 373]

Parameters:

cmdList [line 569]

cmdListgroup [line 875]

Parameters:

cmdListNewsgroups [line 608]

Parameters:

cmdListOverviewFmt [line 728]

cmdModeReader [line 295]

cmdNewgroups [line 695]

Parameters:

cmdNewnews [line 907]

Parameters:

cmdPost [line 477]

Parameters:

cmdQuit [line 174]

cmdXGTitle [line 653]

Parameters:

cmdXOver [line 774]

Parameters:

cmdXROver [line 828]

Parameters:

connect [line 118]

Parameters:

disconnect [line 161]

isConnected [line 970]

setDebug [line 986]

Parameters: