Net_NNTP
pear.php.net
NNTP implementation
PEAR's package for communication with NNTP/Usenet servers. Net_NNTP handles the connection and protocol level commands (RFC977), including many commonly implemented non-standard commands (RFC2980). Net_NNTP includes an unserfriendly API for intermediate user, who don't want to work directly at the command level. However, Net_NNTP does require some knowlege about the NNTP protocol (RFC 977), and general knowledge about email (RFC(2)822) and MIME (2045-2048), since any handling of both content and headers is left up to the user! The protocol implementation does not parse the actual article data, but at the command level it splits returned data at protocol specified boundaries where appropriate.
Heino H. Gehlsen
heino
heino@gehlsen.dk yes
Jan-Pascal van Best
janpascal
janpascal@vanbest.org yes
2013-05-31
19:38:41
1.5.0
0.9.0
stable
alpha
W3C
Stable release, only bug reported during 1,5 years of RC status just fixed
5.0.0
1.4.5
PEAR
pear.php.net
1.4.0
Log
pear.php.net
1.8.7
2013-05-31
1.5.0RC3
0.9.0
stable
alpha
Fix noisy version_compare warning (bug #19753)
2011-10-05
1.5.0RC2
0.9.0
beta
alpha
+ Fix limited buffer for large replies from server (bug# 18875)
2011-08-15
12:00:00
1.5.0RC1
0.9.0
beta
alpha
+ Fix NNTP injection vulnerability (reported by Brendan Coles, itsecuritysolutions.org) + Fix XXS vulnerability in demo (reported by Brendan Coles, itsecuritysolutions.org) + Fix usage of deprecated split() (bug #17417 and #17783) + Fix for large groups on 32 bit systems: Article numbers are no longer cast into integers, but passed on directly from the server as strings (bug #17689). This _could_ possibly have implications and should considered a possible backward compatibility breakage, but is thought to be acceptable, since PHP is expected to cast into integers/floats as needed...
2009-10-04
12:00:00
1.5.0a1
0.8.1
alpha
alpha
W3C
+ Added support for STARTTLS encryption + Use PHP's streams instead of Net_NNTP (to allow easy TLS encryption and future on demand data compressed) + Improved logging with notices for most commands + Added warning about feof() defect in PHP 5.2.11 (bug #49706)
2008-06-17
12:00:00
1.4.0
0.8.1
stable
alpha
W3C
Finally released as stable - after two years as release candidate...
1.4.0RC1
0.8.1
beta
alpha
2006-06-17
W3C
Changes in Net_NNTP_Client: - fix bug #6833: mail() does not work - fix bug #6845: notices in getOverview() + Loading deprecated classes Net_NNTP_Message and Net_NNTP_Header now triggers warnings !
1.3.3
0.8.1
beta
alpha
2006-02-06
W3C
+ Changes in Net_NNTP_Protocol_Client: - fix bug #6618: notices in cmdListNewsgroups()
1.3.2
0.8.1
alpha
alpha
2005-12-23
W3C
+ Changes in Net_NNTP_Client: - getNewArticles() and getNewGroups() now validates that any strtotime() convertions was successfull.

+ Changes in Net_NNTP_Protocol_Client: - fix bug #6334: cmdNewNews() and cmdNewGroups() no longer localize the timestamp depending on timezones.
1.3.1
0.8.1
alpha
alpha
2005-12-23
W3C
+ Changes in Net_NNTP_Client: - added: mail() as a replacement for experimental post() using identical parameters as PHP's mail() function, (temporarily) preserving backward compatibility with experimental method in v1.0. - modified and rewritten: post(), reduced to having only one parameter, (temporarily) preserving backward compatibility with experimental method in v1.0.

+ Changes in Net_NNTP_Protocol_Client: - added: _sendArticle() - modified and rewritten: cmdPost() split into cmdPost() and cmdPost2() + now sends data via _sendArticle() - modified and rewritten: cmdIhave() split into cmdIhave() and cmdIhave2() + now sends data via _sendArticle()
1.3.1
0.8.0
alpha
alpha
2005-12-14
W3C
+ WARNING! - Serious backward compatibility break with v1.2.x (alpha) releases!!! The experimental classes Net_NNTP_Header and Net_NNTP_Message has been droped, since such features does not belong in this package! For now loading either class results in a notice/warning, but later on both classes will be removed! Previously unimplementet NNTP commands now allow access to article headers... - Some backward compatibility break with v1.1.x (beta) releases!!!

+ Changes in Net_NNTP_Client: - fixed: connect(), now returns false when posting is prohibited (like cmdModeReader()). - fixed: getGroupArticles(), now updates internal group summary cache. - added: getHeaderField(). - added: getGroupArticles(). - modified: connect(), added $encryption parameter to support ssl/tls connections, and $timeout parameter. - modified: selectGroup(), added (experimental) parameter to allow fetching of article numbers at once. - modified: getOverview(), added two (experimental) parameters (rewritten to preserve backward compatible with v1.0). - modified and rewritten: getGroups(), addition of optional $wildmat parameter. - modified and rewritten: getDescriptions(), addition of optional $wildmat parameter. - modified and rewritten: getOverview(), $first and $last parameters changed into $range. - renamed: quit() into disconnect(), (temporarily) preserving backward compatible with v1.0. - renamed: getArticleRaw() into getArticle(), (temporarily) preserving backward compatible with v1.1. - renamed: getHeaderRaw() into getHeader(), (temporarily) preserving backward compatible with v1.1. - renamed: getBodyRaw() into getBody(), (temporarily) preserving backward compatible with v1.1. - renamed and rewritten: getReferencesOverview() into getReferences(). - removed: connectAuthenticated() (as in MAINT_1_0 and MAINT_1_2). - removed: isConnected() removed due to use of private members in Net_Socket! - misc: all internal PEAR::throwError() changed to $this->throwError(). - misc: major phpdoc rewrite. - misc: removal of code related to not yet implemented alternative authentication methods.

+ Changes in Net_NNTP_Protocol_Client: - added: cmdXHdr(). - added: cmdCapabilities(). - added: cmdHelp(). - added: cmdListActive(). - added: cmdXPat(). - modified connect(), added $encryption parameter to support ssl/tls connections. - modified: cmdNext(), now returns array by default. - modified and rewritten: cmdXOver(), first parameter now optional. - renamed: isConnected() into _isConnected(), due to use of private members in Net_Socket. - misc: support for logging via the Log package (debugging rewritten to use logger). - misc: use of status response code constants in Net_NNTP_Protocol_Responsecode. - misc: extends PEAR (as in v1.0.x). - misc: all internal PEAR::throwError() changed to $this->throwError().

+ Examples replaced by fully functional newsgroup reader demo.

+ License upgraded to newer edition of 'W3C SOFTWARE NOTICE AND LICENSE'
1.2.5
0.7.4
alpha
alpha
2005-11-27
W3C
+ getHeaderField() added + getReferencesOverview() rewritten + cmdOver() added + cmdHelp() added + cmdXHdr() added + cmdCapabilities() added + cmdXOver() rewritten + cmdListOverviewFmt rewritten + cmdNext() modified + cmdPrevious() modified + cmdStat() modified + connectAuthenticated() removed + examples rewritten
1.2.4
0.7.3
alpha
alpha
2005-10-20
W3C
+ Fix: connect() now returns false when posting is prohibited, like cmdModeReader() does + New: Response code constants + Misc. internal rewrites in protocol implementation: - Expected response codes in cmdArticle(), cmdHead() and cmdBody() reduced to correspond actual implementations. - First parameter in cmdXOver(), cmdXROver() and cmdListgroup() is now optional. - New third optional parameter in getNewNews() and cmdNewnews(). - cmdNext(), cmdLast() and cmdStat() now returns array by default.
1.2.3
0.7.2
alpha
alpha
2005-05-13
W3C
+ New method in Net_NNTP_Client: getBody(). + Added parameters to Net_NNTP_Client::getArticle/getHeader() to allow use of external return classes. + Added status response code constants in Net_NNTP_Protocol_Clients.
1.2.2
0.7.1
alpha
alpha
2005-03-13
W3C
+ Bug #3967 fixed: typo in Net_NNTP_Header::decodeString().
1.2.1
0.7.1
alpha
alpha
2005-03-28
W3C
+ New methods in Net_NNTP_Client: selectArticle(), selectNextArticle() and selectPreviousArticle(). + New methods in Net_NNTP_Protocol_Client: cmdStat(), cmdNext() and cmdLast().
1.2.0
0.7.0
alpha
alpha
2005-01-14
W3C
+ Corresponds to v0.11.3 (exact feature match).
1.1.2
0.6.2
beta
beta
2005-05-13
W3C
+ Three new Net_NNTP_Client methods: getArticle(), getHeader() and getBody() - stripped down versions from the v1.2 releases (no default return classes).
1.1.1
0.6.1
beta
beta
2005-03-28
W3C
+ Net_NNTP_Client::connectAuthenticated() removed - it should only exist in the MAINT_1_2 branch for now (was not removed by mistake in the v1.1.0 release).
1.1.0
0.6.0
beta
beta
2005-01-14
W3C
+ This release is NOT fully backward compatible with v0.11.3, since experimental features (Net_NNTP_Message and Net_NNTP_Header and related methods Net_NNTP_Client::getArticle() and Net_NNTP_Client::getHeader()) have been removed (users of those features should consider v1.2.x in stead).
1.0.1
0.5.0
stable
beta
2005-03-28
W3C
+ Fixes lack of $fp property in historical Net_NNTP class (only relevant for backward compatibility with v0.2.5). + Fixes typo in examples.
1.0.0
0.5.0
stable
beta
2005-01-18
W3C
+ This release is NOT backward compatible with v0.11.3, since all non-stable features (classes, methods etc.) have been removed!!! + Users of releases between 0.3.x and 0.11.x should consider v1.1.x or v1.2.x in stead. (This release is meant only as a final replacement for v0.2.5 - and of cause as a way to finally get rid of the former protocol implementation). + Backward compatible with v0.2.5 (this is ONLY guarantied in v1.0.x releases, and may be removed in the future).
1.0.0RC1
0.5.0
beta
beta
2005-01-14
W3C
+ This release is NOT backward compatible with v0.11.3, since all non-stable features (classes, methods etc.) have been removed!!! + Users of releases between 0.3.x and 0.11.x should consider v1.1.x or v1.2.x in stead. (This release is meant only as a final replacement for v0.2.5 - and of cause as a way to finally get rid of the former protocol implementation). + Backward compatible with v0.2.5 (this is ONLY guarantied in v1.0.x releases, and may be removed in the future).
0.11.3
0.4.3
beta
beta
2004-09-06
W3C
+ Going beta (features not documented in the manual should still be considered experiemental). + Added the 'distributions' parameter to getNewGroups() and cmdNewGroups().
0.11.2
0.4.2
alpha
alpha
2004-08-22
W3C
+ Update PhpDoc blocks. + Changed xmdXOver(),cmdXROver(),getOverview() and getReferencesOverview() into using only parameter: $range. + Fixes whitespace in Net_NNTP_Client, Net_NNTP_Protocol_Client and Net_NNTP.
0.11.1
0.4.1
devel
alpha
2004-07-30
W3C
+ Fixes bug in (deprecated) Net_NNTP::command(). + Rename a few constants due to renamed classes (BC preserved). + Update class phpdoc blocks.
0.11.0
0.4.0
devel
alpha
2004-07-19
W3C
+ New directory structure (classes/files renamed/moved) to allow future server class (dummy files preserves backward compatibility).
0.10.3
0.3.1
alpha
alpha
2004-07-14
W3C
+ Fixes undefined property warning.
0.10.2
0.3.1
alpha
alpha
2004-07-06
W3C
+ Fixes bug #1803 (trailing space character sent in cmdListNewsgrups()). + Fixes bug #825 (no more lazy assignement of new values to $this). + Examples moved into docs to comply with the standard PEAR directory structure.
0.10.1
0.3.1
alpha
alpha
2003-10-24
W3C
+ Fixes bug #7 (lines longer than 1000 chars no longer stop download).
0.10.0
0.3.0
alpha
alpha
2003-10-12
W3C
+ Merges v0.3.3 and v0.9.4 into one package (The 'Net_NNTP' class from v0.9.x is now called 'Net_NNTP_Realtime').
0.9.3
0.2.2
alpha
alpha
2003-09-13
W3C
+ Fixes Incorrect handling of the XROVER extension corrected in cmdXROver() and removed in getOverview(). + Constant names pearified. + Deprecated/historical methods that didn't follow PEAR's coding standard have been removed.
0.9.2
0.2.1
alpha
alpha
2003-08-16
W3C
+ Fixes syntax typo...
0.9.1
0.2.1
alpha
alpha
2002-08-15
W3C
+ Bug fixing and improvements in Net_NNTP_Header and Net_NNTP_Message.
0.9.0
0.2.0
alpha
alpha
2002-08-09
W3C
+ Major rewrite, yet still generaly backward compatible - now uses Net_Socket, lets the user choose if the article data are to be returned as strings or arrays or objects, authentication has been separated from the execution of commands, returns pear_error objects of failure, and handles the server's responses individually.
0.3.3
0.1.1
beta
beta
2003-10-12
W3C
+ Fixes bug #85. + PhpDoc updateds.
0.3.2
0.1.1
beta
beta
2003-09-20
W3C
+ Incorrect handling of the XROVER extension corrected in cmdXROver() and removed in getOverview().
0.3.1
0.1.1
beta
beta
2003-08-31
W3C
+ Uses the new protocol implementation from 0.9.*, but preserves backward compatibility with 0.2, since the experimental header and message classes are not used. + Deprecated/historical methods that didn't follow PEAR's coding standard have been removed.
0.2.5
0.0.3
stable
alpha
2004-07-19
PHP 2.0
+ post() rewritten to allow posting using authentication (bug #817). + Examples moved into docs to comply with the standard PEAR directory structure.
0.2.4
0.0.3
stable
alpha
2004-03-10
PHP 2.0
(Not released)
0.2.3
0.0.3
stable
alpha
2003-09-20
PHP 2.0
+ Incorrect handling of the XROVER extension in getOverview() removed.
0.2.2
0.0.3
stable
alpha
2003-08-31
PHP 2.0
+ Constant names pearified.
0.2.1
0.0.2
stable
alpha
2003-08-09
PHP 2.0
+ Fix binary safety.
0.2
0.0.2
stable
alpha
2003-07-20
PHP 2.0
+ Pearified API.
0.1
0.0.1
stable
alpha
2002-05-22
PHP 2.0
+ This is the initial independent release of the NNTP package.