cvs: pear(BRANCH_0_5_X) /Net_SmartIRC package.xml
| From: | Mirco 'meebey' Bauer | Date: | Fri, 27 May 2005 23:33:01 +0000 |
| Subject: | cvs: pear(BRANCH_0_5_X) /Net_SmartIRC package.xml | ||
| Groups: | php.pear.cvs | ||
| Request: | Send a blank email to pear-cvs+get-32167@lists.php.net to get a copy of this message | ||
meebey Fri May 27 19:33:01 2005 EDT
Modified files: (Branch: BRANCH_0_5_X)
/pear/Net_SmartIRC package.xml
Log:
- updated for 1.0.0 release
http://cvs.php.net/diff.php/pear/Net_SmartIRC/package.xml?r1=1.11.2.6&r2=1.11.2.7&ty=u Index: pear/Net_SmartIRC/package.xml diff -u pear/Net_SmartIRC/package.xml:1.11.2.6 pear/Net_SmartIRC/package.xml:1.11.2.7 --- pear/Net_SmartIRC/package.xml:1.11.2.6 Wed Jul 23 15:32:19 2003 +++ pear/Net_SmartIRC/package.xml Fri May 27 19:33:00 2005 @@ -3,8 +3,7 @@ <package version="1.0"> <name>Net_SmartIRC</name> <summary>Net_SmartIRC is a PHP class for communication with IRC networks</summary> - <description> -Net_SmartIRC is a PHP class for communication with IRC networks, + <description>Net_SmartIRC is a PHP class for communication with IRC networks, which conforms to the RFC 2812 (IRC protocol). It's an API that handles all IRC protocol messages. This class is designed for creating IRC bots, chats and show irc related info on webpages. @@ -62,9 +61,7 @@ who whois whowas - quit - </description> - <license>LGPL</license> + quit</description> <maintainers> <maintainer> <user>meebey</user> @@ -80,86 +77,44 @@ </maintainer> </maintainers> <release> - <version>0.5.5p1</version> - <date>2003-07-23</date> + <version>1.0.0</version> + <date>2005-05-28</date> + <license>LGPL</license> <state>stable</state> <notes> -v0.5.5: +v1.0.0: ------- +Released as 1.0.0 because current PEAR rule require this for stable +packages, there are _no_ big changes in this release! + fixes: + - renamed Net_SmartIRC_base::Net_SmartIRC to + Net_SmartIRC_base::Net_SmartIRC_base + a PHP4 bug made it work, in PHP5 its fixed and doesn't + (closes PEAR bug #1466, sf.net patch #967067) - fixed a bug in _rawreceive() - messages were parsed wrong which caused problems with kick reasons. - (thx to sniper for reporting this). - - fixed bug in message() - CTCP ACTION messages had missing \001 at the end. - - fixed a bug in quit(), which caused quit messages not to be sent to the server. - - fixed reconnect() bug, it sent the channel join requests right after connect(), - and tried to join a channel without a name. - - fixes in ChannelSync code - When a user joins a channel after SmartIRC, no WHO info is updated in the user object. - Fixed wrong update of channel mode when rpl_channelmodeis received. - Fixed bug in _mode() method, which caused wrong handling of mode changes. - Topic updates are now tracked (thanks to sniper). - Fixed bug which caused fatal errors with ChannelSync enabled - (closes sf.net bug #705269). - Fixed bug in _event_mode(), unhandled modes were stored wrong. - Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick - of a namreply got cut (closes sf.net bug #747832). - - fixed bug in _checktimer() - Which caused problems when a timehandler is unregistered. - - fixed _gettye() - It wasn't recognizing SMARTIRC_TYPE_ACTION. - - removed if(!$obj) check for newly created objects (closes PHP bug #24622), - required for PHP 4.1.2 compatibility. + the parser checked if he found a colon (messagepart) but +1 was added, the + check never worked right (I found this bug while porting SmartIRC to C#) + - fixed bug in _gettype() + the regexs was too sloppy, sometimes it got confused, this can break easily + the ChannelSync code. + - fixed bug in _event_rpl_whoreply() + on some IRC networks, the channel info in who replies can't be used, they + return sometimes random channels, this can break ChannelSync code. + - fixed include paths in example scripts (closes PEAR bug #2042) changes: - - removed all irc commands from SmartIRC.php - they have now their own file (SmartIRC/irccommands.php). - - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands. - - removed the 1. parameter (&$irc) of all message handlers, not needed anymore. - - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser, - added class Net_SmartIRC_ircuser. - - added prefix _event to all message handlers (needed because of class restructuring). - - tweaked filling of the ircdata objects. - - log() now checks the passed debug level bitwise. - - $data->message will be null instead of random garbage, - if the IRC message has no colon (the message part), - - All methods that depend on ChannelSync mode, checks if it's enabled. - - Optimized the usage of time() for $this->_lastrx. - - updated the URL of a SmartIRC based bot (atbs). - - _loggedin is now set to false when the socket is dead, - required for proper working reconnect(). - - on a reconnect(), the logfile won't be overwritten anymore. - - updated phpdoc tags. - - all access to the channel array now uses strtolower() for the key. - - fixed typo in function name setChannelSynching(), - now it's called setChannelSyncing() with a BC wrapper. - - removed all SMARTIRC_ prefixes for debug output. - - changed isJoined($channel) to isJoined($channel, $nickname) - for checking if the specified user is joined. - - removed "destructors", because they don't free the memory. + - applied load socket extension patch (sf.net patch #911993) from + Anatoly Techtonik <techtonik@users.sourceforge.net> + if the socket extension is not loaded, it will now try to load it for *nix + and windows. new: - - added isOpped() isVoiced() isBanned(). - - added debug output and debug level for the messageparser. - - reconnect() uses now the channel key if one exists. - - added channel key syncing in _mode(). - - when an actionhandler message regex has a leading '/' then the regex is used as it is, - this allows complex perl regex's. - - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP. - - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT - (for firendly browserouput). When the script is called from a browser, - the BROWSEROUT will automatic be used (closed sf.net bug #708155). - - added error handling for socket_select() in _rawreceive(). - - added getMessage() to Net_SmartIRC_Error class. - - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING). - - added filename and linenumber to debug output. - - added key property to channel class. - - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM. - - added isError() for more advanced errorhandling, needed for encapsulation. - - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types. + - added objListenFor() method + it works like listenFor() but returns an array of the received ircdata + objects (not just ircdata->message like listenFor() does) </notes> - <provides type="class" name="Net_SmartIRC_irccommands" /> + <provides type="class" name="Net_SmartIRC_irccommands" extends="Net_SmartIRC_base" /> <provides type="function" name="Net_SmartIRC_irccommands::message" /> <provides type="function" name="Net_SmartIRC_irccommands::channel" /> <provides type="function" name="Net_SmartIRC_irccommands::join" /> @@ -182,19 +137,19 @@ <provides type="function" name="Net_SmartIRC_irccommands::whois" /> <provides type="function" name="Net_SmartIRC_irccommands::whowas" /> <provides type="function" name="Net_SmartIRC_irccommands::quit" /> - <provides type="class" name="Net_SmartIRC_messagehandler" /> + <provides type="class" name="Net_SmartIRC_messagehandler" extends="Net_SmartIRC_irccommands" /> <provides type="class" name="Net_SmartIRC_base" /> - <provides type="class" name="Net_SmartIRC" /> + <provides type="class" name="Net_SmartIRC" extends="Net_SmartIRC_messagehandler" /> <provides type="class" name="Net_SmartIRC_data" /> <provides type="class" name="Net_SmartIRC_actionhandler" /> <provides type="class" name="Net_SmartIRC_timehandler" /> <provides type="class" name="Net_SmartIRC_channel" /> <provides type="class" name="Net_SmartIRC_user" /> - <provides type="class" name="Net_SmartIRC_channeluser" /> - <provides type="class" name="Net_SmartIRC_ircuser" /> + <provides type="class" name="Net_SmartIRC_channeluser" extends="Net_SmartIRC_user" /> + <provides type="class" name="Net_SmartIRC_ircuser" extends="Net_SmartIRC_user" /> <provides type="class" name="Net_SmartIRC_listenfor" /> + <provides type="class" name="Net_SmartIRC_objListenFor" /> <provides type="class" name="Net_SmartIRC_Error" /> - <provides type="function" name="Net_SmartIRC_base::Net_SmartIRC" /> <provides type="function" name="Net_SmartIRC_base::setUseSockets" /> <provides type="function" name="Net_SmartIRC_base::setDebug" /> <provides type="function" name="Net_SmartIRC_base::setBenchmark" /> @@ -226,6 +181,7 @@ <provides type="function" name="Net_SmartIRC_base::isBanned" /> <provides type="function" name="Net_SmartIRC_base::listen" /> <provides type="function" name="Net_SmartIRC_base::listenFor" /> + <provides type="function" name="Net_SmartIRC_base::objListenFor" /> <provides type="function" name="Net_SmartIRC_base::registerActionhandler" /> <provides type="function" name="Net_SmartIRC_base::unregisterActionhandler" /> <provides type="function" name="Net_SmartIRC_base::unregisterActionid" /> @@ -234,6 +190,7 @@ <provides type="function" name="Net_SmartIRC_base::isError" /> <provides type="function" name="Net_SmartIRC_base::throwError" /> <provides type="function" name="Net_SmartIRC_listenfor::handler" /> + <provides type="function" name="Net_SmartIRC_objListenFor::handler" /> <provides type="function" name="Net_SmartIRC_Error::getMessage" /> <filelist> <file role="doc" baseinstalldir="Net" name="docs/DOCUMENTATION"/> @@ -365,172 +322,132 @@ </release> <changelog> <release> - <version>0.5.5</version> - <date>2003-07-23</date> - <state>stable</state> - <notes> -v0.5.5: -------- -fixes: - - fixed a bug in _rawreceive() - messages were parsed wrong which caused problems with kick reasons. - (thx to sniper for reporting this). - - fixed bug in message() - CTCP ACTION messages had missing \001 at the end. - - fixed a bug in quit(), which caused quit messages not to be sent to the server. - - fixed reconnect() bug, it sent the channel join requests right after connect(), - and tried to join a channel without a name. - - fixes in ChannelSync code - When a user joins a channel after SmartIRC, no WHO info is updated in the user object. - Fixed wrong update of channel mode when rpl_channelmodeis received. - Fixed bug in _mode() method, which caused wrong handling of mode changes. - Topic updates are now tracked (thanks to sniper). - Fixed bug which caused fatal errors with ChannelSync enabled - (closes sf.net bug #705269). - Fixed bug in _event_mode(), unhandled modes were stored wrong. - Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick - of a namreply got cut (closes sf.net bug #747832). - - fixed bug in _checktimer() - Which caused problems when a timehandler is unregistered. - - fixed _gettye() - It wasn't recognizing SMARTIRC_TYPE_ACTION. - - removed if(!$obj) check for newly created objects (closes PHP bug #24622), - required for PHP 4.1.2 compatibility. + <version>0.2.5</version> + <date>2002-09-02</date> + <state>beta</state> + <notes>v0.2.5 +------ +- improved socket handling +- bufferedsend fix +- new version number system +- cpu usage reduced +- added changelog file</notes> + </release> + <release> + <version>0.2.6</version> + <date>2002-10-12</date> + <state>beta</state> + <notes>v0.2.6 +------ +* phpSmartIRCclass.inc.php: + - phpSmartIRCclass.inc renamed to + phpSmartIRCclass.inc.php because of security reasons + - changed function_exists() to get_loaded_extensions() for + checking if the PHP build has real socket support + - log() changed to create Linux style formated logs + - new methods for logging (daemon style) + log() for add log entries setlogdestination() can be STDOUT or FILE + setlogfile() sets the file + - changed received data processing in rawreceive() -changes: - - removed all irc commands from SmartIRC.php - they have now their own file (SmartIRC/irccommands.php). - - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands. - - removed the 1. parameter (&$irc) of all message handlers, not needed anymore. - - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser, - added class Net_SmartIRC_ircuser. - - added prefix _event to all message handlers (needed because of class restructuring). - - tweaked filling of the ircdata objects. - - log() now checks the passed debug level bitwise. - - $data->message will be null instead of random garbage, - if the IRC message has no colon (the message part), - - All methods that depend on ChannelSync mode, checks if it's enabled. - - Optimized the usage of time() for $this->_lastrx. - - updated the URL of a SmartIRC based bot (atbs). - - _loggedin is now set to false when the socket is dead, - required for proper working reconnect(). - - on a reconnect(), the logfile won't be overwritten anymore. - - updated phpdoc tags. - - all access to the channel array now uses strtolower() for the key. - - fixed typo in function name setChannelSynching(), - now it's called setChannelSyncing() with a BC wrapper. - - removed all SMARTIRC_ prefixes for debug output. - - changed isJoined($channel) to isJoined($channel, $nickname) - for checking if the specified user is joined. - - removed "destructors", because they don't free the memory. +* HOWTO: + - added a mini howto for using the class -new: - - added isOpped() isVoiced() isBanned(). - - added debug output and debug level for the messageparser. - - reconnect() uses now the channel key if one exists. - - added channel key syncing in _mode(). - - when an actionhandler message regex has a leading '/' then the regex is used as it is, - this allows complex perl regex's. - - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP. - - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT - (for firendly browserouput). When the script is called from a browser, - the BROWSEROUT will automatic be used (closed sf.net bug #708155). - - added error handling for socket_select() in _rawreceive(). - - added getMessage() to Net_SmartIRC_Error class. - - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING). - - added filename and linenumber to debug output. - - added key property to channel class. - - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM. - - added isError() for more advanced errorhandling, needed for encapsulation. - - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types. -</notes> +* DOCUMENTATION: + - added class documentation of the project + +* CREDITS: + - added credits file</notes> </release> - <release> - <version>0.5.1</version> - <state>stable</state> - <date>2003-01-17</date> - <notes> -v0.5.1: -------- -fixes: - - major bugs in ChannelSynching fixed. - - fsocks support fixed. - - setUseSocket() method fixed. - If false was passed as parameter, it tried to load the socket extension. - Also warnings are now suppressed with @ in front of dl(). - - fixed a typo in reconnect(). - - missing SMARTIRC_DEBUG_CHANNELSYNCHING constant added. - -changes: - - new design for HTML documentation used (PEAR template). - - moved all examples to their own directory (examples/). - - moved the documentation to docs/HTML/. - - added new file descriptions to README. - - removed not needed parts of DOCUMENTATION (most is now in the HTML version). - - updated the HTML documentation. - -new: - - example5/6/7.php added. - - setAutoRetry() method added. - Autoretrying of connecting to the IRC server, is now supported. - </notes> - </release> <release> - <version>0.5.0</version> - <date>2003-01-07</date> - <state>stable</state> - <notes> -v0.5.0 ------- -fixes: - - fixed critical bug in the main _rawreceive() for() loop, messages were lost. + <version>0.3.0</version> + <date>2002-10-23</date> + <state>beta</state> + <notes>v0.3.0 +----- +* phpSmartIRCclass.inc.php: + - added "Ping? Pong!" log message for debugging + - added real linux/windows syslog logging + to setlogdestination(). + - new method listen_for() makes it possible + to show irc related information on a homepage, like how many users + on a channel are. -changes: - - License changed from GPL to LGPL. - - updated in all files the copyright year. - - changed documentation tags in front of all methods to the phpDocumentator compatible format. - - improved connect() errorhandling. - - changed login() parameters to $nick, $realname, $usermode = 0, $username = null, $password = null. - - changed join() parameters to $channelarray, $key = null. - - changed kick() parameters to $channel, $nicknamearray, $reason = null. - - changed listenFor() parameters to $messagetype - return value is now the result, instead the of a reference to the result parameter. - - sendbuffer has now 3 queues: high, medium and low - high sends 2 messages, then 1 of medium - low is only send if high _and_ medium is empty. - - select() call for sockets is strongly optimized +* HOWTO: + - added how to run/call the selfwritten bot -new: - - phpDocumentator package tags. - - include() for messagehandler.php (needed for the new API). - - setChannelSynching() method, for enabling the channel synching. - - setCtcpVersion() method, for changing the ctcp version reply string. - - setReceiveTimeout() method, for changing the receive timeout. - - setTransmitTimeout() method, for changing the transmit timeout. - - setAutoReconnect() method, for enabling the autoreconnect feature. - - channel variable, a reference to _channels because $object->channel("#chan")->topic is not possible in PHP4 (ZE1). - - reconnect() method, it will reconnect and also join all channels. - - channel() method, getting a reference to the channel, only if channelsynching is on. - - added ident, host, messageex and rawmessageex variables to the Net_SmartIRC_data class. - - class Net_SmartIRC_user, stores info about one user, only used if channelsynching is on. - - class Net_SmartIRC_channel, stores info about one channel, only used if channelsynching is on. -</notes> +* DOCUMENTATION: + - added (missing) explaination for new methods + +* example2.php: + - new examplefile with the new listen_for() method</notes> </release> <release> - <version>0.4.0</version> - <date>2002-11-26</date> + <version>0.3.2</version> + <date>2002-11-05</date> <state>stable</state> - <notes> -v0.4.0 + <notes>v0.3.2 ------ * phpSmartIRCclass.inc.php: - - fixed serious socket bug - The buffer of the socket got full because only 512 bytes were read at once, - which caused losing some IRC messages that are comming fast like the MOTD. - Now it will read 10240 bytes at once, and doesn't loose any IRC message. - - fixed sendbuffer - The sendbuffer will only be sent, when the class is fully connected and - registered on the IRC network. Before if a nickname collision happened, + - Replaced all quotes by single quote where possible for speedup. + - Added _disconnecttime for doing a clean IRC quit. + - Added Zend IDE style documentation for parameter variables types + and method descriptions. + - Spaces in nickname and username will be automaticly removed. + - Nicknamecollisions are automaticly detected and nickname will be + changed to nickname with 3 random numbers. + - New method nicknameuse(). + - Fixed a serious fsock bug. + - Added new type TYPE_ERROR. + - Fixed wrong usage of & when calling methods with params that are + called by reference. + - Fixed a debug message "DEBUG: disconnected", now it will only + occur when debug mode is enabled. + - listen_for() will now do a quickdisconnect, for a big speedup. + - Changed logging system, now with debug levels, default is + DEBUG_NOTICE. + - Added benchmark system, now its possible to time things for doing + optimizations. + - New methods: benchmark(), benchmarktstart(), benchmarkend() + and show_benchmark() for the benchmark system + - Added microint(), for getting the microtime as float, needed for + the benchmarks. + - Added a couple of log() calls, for different debug levels. + - fsockets now runs in non blocking mode, because of broken? + getstatus for fsockets. + - Added mode() method, for chaning modes of a user or channel. + - Added op() and deop() method. Added ban() and unban() method + (thx for diff file to Peter Petermann). + +* DOCUMENTATION: + - added documentation for new logging system + - added the whole DEBUG_* list + +* HOWTO: + - changed parameter description for debug() + +* example.php: + - replaced all quotes by singlequotes where possible. + - fixed wrong usage of message() + +* example2.php: + - replaced all quotes by singlquotes where possible. + - added benchmark test to the example</notes> + </release> + <release> + <version>0.4.0</version> + <date>2002-11-26</date> + <state>stable</state> + <notes>v0.4.0 +------ +* phpSmartIRCclass.inc.php: + - fixed serious socket bug + The buffer of the socket got full because only 512 bytes were read at once, + which caused losing some IRC messages that are comming fast like the MOTD. + Now it will read 10240 bytes at once, and doesn't loose any IRC message. + - fixed sendbuffer + The sendbuffer will only be sent, when the class is fully connected and + registered on the IRC network. Before if a nickname collision happened, all sent IRC commands from the buffer were ignored by the IRC server. - fixed socket status Socket handling is now compatible with PHP 4.3 dev. @@ -574,128 +491,271 @@ * example.php: - changed user function parameter to new style ( &$irc and &$data ). - - added TYPE_NOTICE to query_test example. -</notes> + - added TYPE_NOTICE to query_test example.</notes> </release> <release> - <version>0.3.2</version> - <date>2002-11-05</date> + <version>0.5.0</version> + <date>2003-01-07</date> <state>stable</state> - <notes> -v0.3.2 + <notes>v0.5.0 ------ -* phpSmartIRCclass.inc.php: - - Replaced all quotes by single quote where possible for speedup. - - Added _disconnecttime for doing a clean IRC quit. - - Added Zend IDE style documentation for parameter variables types - and method descriptions. - - Spaces in nickname and username will be automaticly removed. - - Nicknamecollisions are automaticly detected and nickname will be - changed to nickname with 3 random numbers. - - New method nicknameuse(). - - Fixed a serious fsock bug. - - Added new type TYPE_ERROR. - - Fixed wrong usage of & when calling methods with params that are - called by reference. - - Fixed a debug message "DEBUG: disconnected", now it will only - occur when debug mode is enabled. - - listen_for() will now do a quickdisconnect, for a big speedup. - - Changed logging system, now with debug levels, default is - DEBUG_NOTICE. - - Added benchmark system, now its possible to time things for doing - optimizations. - - New methods: benchmark(), benchmarktstart(), benchmarkend() - and show_benchmark() for the benchmark system - - Added microint(), for getting the microtime as float, needed for - the benchmarks. - - Added a couple of log() calls, for different debug levels. - - fsockets now runs in non blocking mode, because of broken? - getstatus for fsockets. - - Added mode() method, for chaning modes of a user or channel. - - Added op() and deop() method. Added ban() and unban() method - (thx for diff file to Peter Petermann). +fixes: + - fixed critical bug in the main _rawreceive() for() loop, messages were lost. -* DOCUMENTATION: - - added documentation for new logging system - - added the whole DEBUG_* list +changes: + - License changed from GPL to LGPL. + - updated in all files the copyright year. + - changed documentation tags in front of all methods to the phpDocumentator compatible format. + - improved connect() errorhandling. + - changed login() parameters to $nick, $realname, $usermode = 0, $username = null, $password = null. + - changed join() parameters to $channelarray, $key = null. + - changed kick() parameters to $channel, $nicknamearray, $reason = null. + - changed listenFor() parameters to $messagetype + return value is now the result, instead the of a reference to the result parameter. + - sendbuffer has now 3 queues: high, medium and low + high sends 2 messages, then 1 of medium + low is only send if high _and_ medium is empty. + - select() call for sockets is strongly optimized -* HOWTO: - - changed parameter description for debug() +new: + - phpDocumentator package tags. + - include() for messagehandler.php (needed for the new API). + - setChannelSynching() method, for enabling the channel synching. + - setCtcpVersion() method, for changing the ctcp version reply string. + - setReceiveTimeout() method, for changing the receive timeout. + - setTransmitTimeout() method, for changing the transmit timeout. + - setAutoReconnect() method, for enabling the autoreconnect feature. + - channel variable, a reference to _channels because $object->channel("#chan")->topic is not possible in PHP4 (ZE1). + - reconnect() method, it will reconnect and also join all channels. + - channel() method, getting a reference to the channel, only if channelsynching is on. + - added ident, host, messageex and rawmessageex variables to the Net_SmartIRC_data class. + - class Net_SmartIRC_user, stores info about one user, only used if channelsynching is on. + - class Net_SmartIRC_channel, stores info about one channel, only used if channelsynching is on.</notes> + </release> + <release> + <version>0.5.1</version> + <date>2003-01-17</date> + <state>stable</state> + <notes>v0.5.1: +------- +fixes: + - major bugs in ChannelSynching fixed. + - fsocks support fixed. + - setUseSocket() method fixed. + If false was passed as parameter, it tried to load the socket extension. + Also warnings are now suppressed with @ in front of dl(). + - fixed a typo in reconnect(). + - missing SMARTIRC_DEBUG_CHANNELSYNCHING constant added. + +changes: + - new design for HTML documentation used (PEAR template). + - moved all examples to their own directory (examples/). + - moved the documentation to docs/HTML/. + - added new file descriptions to README. + - removed not needed parts of DOCUMENTATION (most is now in the HTML version). + - updated the HTML documentation. + +new: + - example5/6/7.php added. + - setAutoRetry() method added. + Autoretrying of connecting to the IRC server, is now supported.</notes> + </release> + <release> + <version>0.5.5</version> + <date>2003-07-23</date> + <state>stable</state> + <notes>v0.5.5: +------- +fixes: + - fixed a bug in _rawreceive() + messages were parsed wrong which caused problems with kick reasons. + (thx to sniper for reporting this). + - fixed bug in message() + CTCP ACTION messages had missing \001 at the end. + - fixed a bug in quit(), which caused quit messages not to be sent to the server. + - fixed reconnect() bug, it sent the channel join requests right after connect(), + and tried to join a channel without a name. + - fixes in ChannelSync code + When a user joins a channel after SmartIRC, no WHO info is updated in the user object. + Fixed wrong update of channel mode when rpl_channelmodeis received. + Fixed bug in _mode() method, which caused wrong handling of mode changes. + Topic updates are now tracked (thanks to sniper). + Fixed bug which caused fatal errors with ChannelSync enabled + (closes sf.net bug #705269). + Fixed bug in _event_mode(), unhandled modes were stored wrong. + Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick + of a namreply got cut (closes sf.net bug #747832). + - fixed bug in _checktimer() + Which caused problems when a timehandler is unregistered. + - fixed _gettye() + It wasn't recognizing SMARTIRC_TYPE_ACTION. + - removed if(!$obj) check for newly created objects (closes PHP bug #24622), + required for PHP 4.1.2 compatibility. -* example.php: - - replaced all quotes by singlequotes where possible. - - fixed wrong usage of message() +changes: + - removed all irc commands from SmartIRC.php + they have now their own file (SmartIRC/irccommands.php). + - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands. + - removed the 1. parameter (&$irc) of all message handlers, not needed anymore. + - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser, + added class Net_SmartIRC_ircuser. + - added prefix _event to all message handlers (needed because of class restructuring). + - tweaked filling of the ircdata objects. + - log() now checks the passed debug level bitwise. + - $data->message will be null instead of random garbage, + if the IRC message has no colon (the message part), + - All methods that depend on ChannelSync mode, checks if it's enabled. + - Optimized the usage of time() for $this->_lastrx. + - updated the URL of a SmartIRC based bot (atbs). + - _loggedin is now set to false when the socket is dead, + required for proper working reconnect(). + - on a reconnect(), the logfile won't be overwritten anymore. + - updated phpdoc tags. + - all access to the channel array now uses strtolower() for the key. + - fixed typo in function name setChannelSynching(), + now it's called setChannelSyncing() with a BC wrapper. + - removed all SMARTIRC_ prefixes for debug output. + - changed isJoined($channel) to isJoined($channel, $nickname) + for checking if the specified user is joined. + - removed "destructors", because they don't free the memory. -* example2.php: - - replaced all quotes by singlquotes where possible. - - added benchmark test to the example -</notes> +new: + - added isOpped() isVoiced() isBanned(). + - added debug output and debug level for the messageparser. + - reconnect() uses now the channel key if one exists. + - added channel key syncing in _mode(). + - when an actionhandler message regex has a leading '/' then the regex is used as it is, + this allows complex perl regex's. + - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP. + - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT + (for firendly browserouput). When the script is called from a browser, + the BROWSEROUT will automatic be used (closed sf.net bug #708155). + - added error handling for socket_select() in _rawreceive(). + - added getMessage() to Net_SmartIRC_Error class. + - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING). + - added filename and linenumber to debug output. + - added key property to channel class. + - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM. + - added isError() for more advanced errorhandling, needed for encapsulation. + - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types.</notes> </release> <release> - <version>0.3.0</version> - <date>2002-10-23</date> - <state>beta</state> - <notes> -v0.3.0 ------ -* phpSmartIRCclass.inc.php: - - added "Ping? Pong!" log message for debugging - - added real linux/windows syslog logging - to setlogdestination(). - - new method listen_for() makes it possible - to show irc related information on a homepage, like how many users - on a channel are. - -* HOWTO: - - added how to run/call the selfwritten bot + <version>0.5.5p1</version> + <date>2003-07-23</date> + <license>LGPL</license> + <state>stable</state> + <notes>v0.5.5: +------- +fixes: + - fixed a bug in _rawreceive() + messages were parsed wrong which caused problems with kick reasons. + (thx to sniper for reporting this). + - fixed bug in message() + CTCP ACTION messages had missing \001 at the end. + - fixed a bug in quit(), which caused quit messages not to be sent to the server. + - fixed reconnect() bug, it sent the channel join requests right after connect(), + and tried to join a channel without a name. + - fixes in ChannelSync code + When a user joins a channel after SmartIRC, no WHO info is updated in the user object. + Fixed wrong update of channel mode when rpl_channelmodeis received. + Fixed bug in _mode() method, which caused wrong handling of mode changes. + Topic updates are now tracked (thanks to sniper). + Fixed bug which caused fatal errors with ChannelSync enabled + (closes sf.net bug #705269). + Fixed bug in _event_mode(), unhandled modes were stored wrong. + Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick + of a namreply got cut (closes sf.net bug #747832). + - fixed bug in _checktimer() + Which caused problems when a timehandler is unregistered. + - fixed _gettye() + It wasn't recognizing SMARTIRC_TYPE_ACTION. + - removed if(!$obj) check for newly created objects (closes PHP bug #24622), + required for PHP 4.1.2 compatibility. -* DOCUMENTATION: - - added (missing) explaination for new methods +changes: + - removed all irc commands from SmartIRC.php + they have now their own file (SmartIRC/irccommands.php). + - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands. + - removed the 1. parameter (&$irc) of all message handlers, not needed anymore. + - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser, + added class Net_SmartIRC_ircuser. + - added prefix _event to all message handlers (needed because of class restructuring). + - tweaked filling of the ircdata objects. + - log() now checks the passed debug level bitwise. + - $data->message will be null instead of random garbage, + if the IRC message has no colon (the message part), + - All methods that depend on ChannelSync mode, checks if it's enabled. + - Optimized the usage of time() for $this->_lastrx. + - updated the URL of a SmartIRC based bot (atbs). + - _loggedin is now set to false when the socket is dead, + required for proper working reconnect(). + - on a reconnect(), the logfile won't be overwritten anymore. + - updated phpdoc tags. + - all access to the channel array now uses strtolower() for the key. + - fixed typo in function name setChannelSynching(), + now it's called setChannelSyncing() with a BC wrapper. + - removed all SMARTIRC_ prefixes for debug output. + - changed isJoined($channel) to isJoined($channel, $nickname) + for checking if the specified user is joined. + - removed "destructors", because they don't free the memory. -* example2.php: - - new examplefile with the new listen_for() method -</notes> +new: + - added isOpped() isVoiced() isBanned(). + - added debug output and debug level for the messageparser. + - reconnect() uses now the channel key if one exists. + - added channel key syncing in _mode(). + - when an actionhandler message regex has a leading '/' then the regex is used as it is, + this allows complex perl regex's. + - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP. + - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT + (for firendly browserouput). When the script is called from a browser, + the BROWSEROUT will automatic be used (closed sf.net bug #708155). + - added error handling for socket_select() in _rawreceive(). + - added getMessage() to Net_SmartIRC_Error class. + - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING). + - added filename and linenumber to debug output. + - added key property to channel class. + - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM. + - added isError() for more advanced errorhandling, needed for encapsulation. + - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types.</notes> </release> <release> - <version>0.2.6</version> - <date>2002-10-12</date> - <state>beta</state> + <version>1.0.0</version> + <date>2005-05-28</date> + <license>LGPL</license> + <state>stable</state> <notes> -v0.2.6 ------- -* phpSmartIRCclass.inc.php: - - phpSmartIRCclass.inc renamed to - phpSmartIRCclass.inc.php because of security reasons - - changed function_exists() to get_loaded_extensions() for - checking if the PHP build has real socket support - - log() changed to create Linux style formated logs - - new methods for logging (daemon style) - log() for add log entries setlogdestination() can be STDOUT or FILE - setlogfile() sets the file - - changed received data processing in rawreceive() +v1.0.0: +------- +Released as 1.0.0 because current PEAR rule require this for stable +packages, there are _no_ big changes in this release! -* HOWTO: - - added a mini howto for using the class +fixes: + - renamed Net_SmartIRC_base::Net_SmartIRC to + Net_SmartIRC_base::Net_SmartIRC_base + a PHP4 bug made it work, in PHP5 its fixed and doesn't + (closes PEAR bug #1466, sf.net patch #967067) + - fixed a bug in _rawreceive() + the parser checked if he found a colon (messagepart) but +1 was added, the + check never worked right (I found this bug while porting SmartIRC to C#) + - fixed bug in _gettype() + the regexs was too sloppy, sometimes it got confused, this can break easily + the ChannelSync code. + - fixed bug in _event_rpl_whoreply() + on some IRC networks, the channel info in who replies can't be used, they + return sometimes random channels, this can break ChannelSync code. + - fixed include paths in example scripts (closes PEAR bug #2042) -* DOCUMENTATION: - - added class documentation of the project +changes: + - applied load socket extension patch (sf.net patch #911993) from + Anatoly Techtonik <techtonik@users.sourceforge.net> + if the socket extension is not loaded, it will now try to load it for *nix + and windows. -* CREDITS: - - added credits file -</notes> - </release> - <release> - <version>0.2.5</version> - <date>2002-09-02</date> - <state>beta</state> - <notes> -v0.2.5 ------- -- improved socket handling -- bufferedsend fix -- new version number system -- cpu usage reduced -- added changelog file +new: + - added objListenFor() method + it works like listenFor() but returns an array of the received ircdata + objects (not just ircdata->message like listenFor() does) </notes> </release> </changelog>
http://cvs.php.net/diff.php/pear/Net_SmartIRC/package.xml?r1=1.11.2.6&r2=1.11.2.7&ty=u Index: pear/Net_SmartIRC/package.xml diff -u pear/Net_SmartIRC/package.xml:1.11.2.6 pear/Net_SmartIRC/package.xml:1.11.2.7 --- pear/Net_SmartIRC/package.xml:1.11.2.6 Wed Jul 23 15:32:19 2003 +++ pear/Net_SmartIRC/package.xml Fri May 27 19:33:00 2005 @@ -3,8 +3,7 @@ <package version="1.0"> <name>Net_SmartIRC</name> <summary>Net_SmartIRC is a PHP class for communication with IRC networks</summary> - <description> -Net_SmartIRC is a PHP class for communication with IRC networks, + <description>Net_SmartIRC is a PHP class for communication with IRC networks, which conforms to the RFC 2812 (IRC protocol). It's an API that handles all IRC protocol messages. This class is designed for creating IRC bots, chats and show irc related info on webpages. @@ -62,9 +61,7 @@ who whois whowas - quit - </description> - <license>LGPL</license> + quit</description> <maintainers> <maintainer> <user>meebey</user> @@ -80,86 +77,44 @@ </maintainer> </maintainers> <release> - <version>0.5.5p1</version> - <date>2003-07-23</date> + <version>1.0.0</version> + <date>2005-05-28</date> + <license>LGPL</license> <state>stable</state> <notes> -v0.5.5: +v1.0.0: ------- +Released as 1.0.0 because current PEAR rule require this for stable +packages, there are _no_ big changes in this release! + fixes: + - renamed Net_SmartIRC_base::Net_SmartIRC to + Net_SmartIRC_base::Net_SmartIRC_base + a PHP4 bug made it work, in PHP5 its fixed and doesn't + (closes PEAR bug #1466, sf.net patch #967067) - fixed a bug in _rawreceive() - messages were parsed wrong which caused problems with kick reasons. - (thx to sniper for reporting this). - - fixed bug in message() - CTCP ACTION messages had missing \001 at the end. - - fixed a bug in quit(), which caused quit messages not to be sent to the server. - - fixed reconnect() bug, it sent the channel join requests right after connect(), - and tried to join a channel without a name. - - fixes in ChannelSync code - When a user joins a channel after SmartIRC, no WHO info is updated in the user object. - Fixed wrong update of channel mode when rpl_channelmodeis received. - Fixed bug in _mode() method, which caused wrong handling of mode changes. - Topic updates are now tracked (thanks to sniper). - Fixed bug which caused fatal errors with ChannelSync enabled - (closes sf.net bug #705269). - Fixed bug in _event_mode(), unhandled modes were stored wrong. - Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick - of a namreply got cut (closes sf.net bug #747832). - - fixed bug in _checktimer() - Which caused problems when a timehandler is unregistered. - - fixed _gettye() - It wasn't recognizing SMARTIRC_TYPE_ACTION. - - removed if(!$obj) check for newly created objects (closes PHP bug #24622), - required for PHP 4.1.2 compatibility. + the parser checked if he found a colon (messagepart) but +1 was added, the + check never worked right (I found this bug while porting SmartIRC to C#) + - fixed bug in _gettype() + the regexs was too sloppy, sometimes it got confused, this can break easily + the ChannelSync code. + - fixed bug in _event_rpl_whoreply() + on some IRC networks, the channel info in who replies can't be used, they + return sometimes random channels, this can break ChannelSync code. + - fixed include paths in example scripts (closes PEAR bug #2042) changes: - - removed all irc commands from SmartIRC.php - they have now their own file (SmartIRC/irccommands.php). - - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands. - - removed the 1. parameter (&$irc) of all message handlers, not needed anymore. - - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser, - added class Net_SmartIRC_ircuser. - - added prefix _event to all message handlers (needed because of class restructuring). - - tweaked filling of the ircdata objects. - - log() now checks the passed debug level bitwise. - - $data->message will be null instead of random garbage, - if the IRC message has no colon (the message part), - - All methods that depend on ChannelSync mode, checks if it's enabled. - - Optimized the usage of time() for $this->_lastrx. - - updated the URL of a SmartIRC based bot (atbs). - - _loggedin is now set to false when the socket is dead, - required for proper working reconnect(). - - on a reconnect(), the logfile won't be overwritten anymore. - - updated phpdoc tags. - - all access to the channel array now uses strtolower() for the key. - - fixed typo in function name setChannelSynching(), - now it's called setChannelSyncing() with a BC wrapper. - - removed all SMARTIRC_ prefixes for debug output. - - changed isJoined($channel) to isJoined($channel, $nickname) - for checking if the specified user is joined. - - removed "destructors", because they don't free the memory. + - applied load socket extension patch (sf.net patch #911993) from + Anatoly Techtonik <techtonik@users.sourceforge.net> + if the socket extension is not loaded, it will now try to load it for *nix + and windows. new: - - added isOpped() isVoiced() isBanned(). - - added debug output and debug level for the messageparser. - - reconnect() uses now the channel key if one exists. - - added channel key syncing in _mode(). - - when an actionhandler message regex has a leading '/' then the regex is used as it is, - this allows complex perl regex's. - - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP. - - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT - (for firendly browserouput). When the script is called from a browser, - the BROWSEROUT will automatic be used (closed sf.net bug #708155). - - added error handling for socket_select() in _rawreceive(). - - added getMessage() to Net_SmartIRC_Error class. - - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING). - - added filename and linenumber to debug output. - - added key property to channel class. - - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM. - - added isError() for more advanced errorhandling, needed for encapsulation. - - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types. + - added objListenFor() method + it works like listenFor() but returns an array of the received ircdata + objects (not just ircdata->message like listenFor() does) </notes> - <provides type="class" name="Net_SmartIRC_irccommands" /> + <provides type="class" name="Net_SmartIRC_irccommands" extends="Net_SmartIRC_base" /> <provides type="function" name="Net_SmartIRC_irccommands::message" /> <provides type="function" name="Net_SmartIRC_irccommands::channel" /> <provides type="function" name="Net_SmartIRC_irccommands::join" /> @@ -182,19 +137,19 @@ <provides type="function" name="Net_SmartIRC_irccommands::whois" /> <provides type="function" name="Net_SmartIRC_irccommands::whowas" /> <provides type="function" name="Net_SmartIRC_irccommands::quit" /> - <provides type="class" name="Net_SmartIRC_messagehandler" /> + <provides type="class" name="Net_SmartIRC_messagehandler" extends="Net_SmartIRC_irccommands" /> <provides type="class" name="Net_SmartIRC_base" /> - <provides type="class" name="Net_SmartIRC" /> + <provides type="class" name="Net_SmartIRC" extends="Net_SmartIRC_messagehandler" /> <provides type="class" name="Net_SmartIRC_data" /> <provides type="class" name="Net_SmartIRC_actionhandler" /> <provides type="class" name="Net_SmartIRC_timehandler" /> <provides type="class" name="Net_SmartIRC_channel" /> <provides type="class" name="Net_SmartIRC_user" /> - <provides type="class" name="Net_SmartIRC_channeluser" /> - <provides type="class" name="Net_SmartIRC_ircuser" /> + <provides type="class" name="Net_SmartIRC_channeluser" extends="Net_SmartIRC_user" /> + <provides type="class" name="Net_SmartIRC_ircuser" extends="Net_SmartIRC_user" /> <provides type="class" name="Net_SmartIRC_listenfor" /> + <provides type="class" name="Net_SmartIRC_objListenFor" /> <provides type="class" name="Net_SmartIRC_Error" /> - <provides type="function" name="Net_SmartIRC_base::Net_SmartIRC" /> <provides type="function" name="Net_SmartIRC_base::setUseSockets" /> <provides type="function" name="Net_SmartIRC_base::setDebug" /> <provides type="function" name="Net_SmartIRC_base::setBenchmark" /> @@ -226,6 +181,7 @@ <provides type="function" name="Net_SmartIRC_base::isBanned" /> <provides type="function" name="Net_SmartIRC_base::listen" /> <provides type="function" name="Net_SmartIRC_base::listenFor" /> + <provides type="function" name="Net_SmartIRC_base::objListenFor" /> <provides type="function" name="Net_SmartIRC_base::registerActionhandler" /> <provides type="function" name="Net_SmartIRC_base::unregisterActionhandler" /> <provides type="function" name="Net_SmartIRC_base::unregisterActionid" /> @@ -234,6 +190,7 @@ <provides type="function" name="Net_SmartIRC_base::isError" /> <provides type="function" name="Net_SmartIRC_base::throwError" /> <provides type="function" name="Net_SmartIRC_listenfor::handler" /> + <provides type="function" name="Net_SmartIRC_objListenFor::handler" /> <provides type="function" name="Net_SmartIRC_Error::getMessage" /> <filelist> <file role="doc" baseinstalldir="Net" name="docs/DOCUMENTATION"/> @@ -365,172 +322,132 @@ </release> <changelog> <release> - <version>0.5.5</version> - <date>2003-07-23</date> - <state>stable</state> - <notes> -v0.5.5: -------- -fixes: - - fixed a bug in _rawreceive() - messages were parsed wrong which caused problems with kick reasons. - (thx to sniper for reporting this). - - fixed bug in message() - CTCP ACTION messages had missing \001 at the end. - - fixed a bug in quit(), which caused quit messages not to be sent to the server. - - fixed reconnect() bug, it sent the channel join requests right after connect(), - and tried to join a channel without a name. - - fixes in ChannelSync code - When a user joins a channel after SmartIRC, no WHO info is updated in the user object. - Fixed wrong update of channel mode when rpl_channelmodeis received. - Fixed bug in _mode() method, which caused wrong handling of mode changes. - Topic updates are now tracked (thanks to sniper). - Fixed bug which caused fatal errors with ChannelSync enabled - (closes sf.net bug #705269). - Fixed bug in _event_mode(), unhandled modes were stored wrong. - Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick - of a namreply got cut (closes sf.net bug #747832). - - fixed bug in _checktimer() - Which caused problems when a timehandler is unregistered. - - fixed _gettye() - It wasn't recognizing SMARTIRC_TYPE_ACTION. - - removed if(!$obj) check for newly created objects (closes PHP bug #24622), - required for PHP 4.1.2 compatibility. + <version>0.2.5</version> + <date>2002-09-02</date> + <state>beta</state> + <notes>v0.2.5 +------ +- improved socket handling +- bufferedsend fix +- new version number system +- cpu usage reduced +- added changelog file</notes> + </release> + <release> + <version>0.2.6</version> + <date>2002-10-12</date> + <state>beta</state> + <notes>v0.2.6 +------ +* phpSmartIRCclass.inc.php: + - phpSmartIRCclass.inc renamed to + phpSmartIRCclass.inc.php because of security reasons + - changed function_exists() to get_loaded_extensions() for + checking if the PHP build has real socket support + - log() changed to create Linux style formated logs + - new methods for logging (daemon style) + log() for add log entries setlogdestination() can be STDOUT or FILE + setlogfile() sets the file + - changed received data processing in rawreceive() -changes: - - removed all irc commands from SmartIRC.php - they have now their own file (SmartIRC/irccommands.php). - - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands. - - removed the 1. parameter (&$irc) of all message handlers, not needed anymore. - - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser, - added class Net_SmartIRC_ircuser. - - added prefix _event to all message handlers (needed because of class restructuring). - - tweaked filling of the ircdata objects. - - log() now checks the passed debug level bitwise. - - $data->message will be null instead of random garbage, - if the IRC message has no colon (the message part), - - All methods that depend on ChannelSync mode, checks if it's enabled. - - Optimized the usage of time() for $this->_lastrx. - - updated the URL of a SmartIRC based bot (atbs). - - _loggedin is now set to false when the socket is dead, - required for proper working reconnect(). - - on a reconnect(), the logfile won't be overwritten anymore. - - updated phpdoc tags. - - all access to the channel array now uses strtolower() for the key. - - fixed typo in function name setChannelSynching(), - now it's called setChannelSyncing() with a BC wrapper. - - removed all SMARTIRC_ prefixes for debug output. - - changed isJoined($channel) to isJoined($channel, $nickname) - for checking if the specified user is joined. - - removed "destructors", because they don't free the memory. +* HOWTO: + - added a mini howto for using the class -new: - - added isOpped() isVoiced() isBanned(). - - added debug output and debug level for the messageparser. - - reconnect() uses now the channel key if one exists. - - added channel key syncing in _mode(). - - when an actionhandler message regex has a leading '/' then the regex is used as it is, - this allows complex perl regex's. - - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP. - - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT - (for firendly browserouput). When the script is called from a browser, - the BROWSEROUT will automatic be used (closed sf.net bug #708155). - - added error handling for socket_select() in _rawreceive(). - - added getMessage() to Net_SmartIRC_Error class. - - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING). - - added filename and linenumber to debug output. - - added key property to channel class. - - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM. - - added isError() for more advanced errorhandling, needed for encapsulation. - - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types. -</notes> +* DOCUMENTATION: + - added class documentation of the project + +* CREDITS: + - added credits file</notes> </release> - <release> - <version>0.5.1</version> - <state>stable</state> - <date>2003-01-17</date> - <notes> -v0.5.1: -------- -fixes: - - major bugs in ChannelSynching fixed. - - fsocks support fixed. - - setUseSocket() method fixed. - If false was passed as parameter, it tried to load the socket extension. - Also warnings are now suppressed with @ in front of dl(). - - fixed a typo in reconnect(). - - missing SMARTIRC_DEBUG_CHANNELSYNCHING constant added. - -changes: - - new design for HTML documentation used (PEAR template). - - moved all examples to their own directory (examples/). - - moved the documentation to docs/HTML/. - - added new file descriptions to README. - - removed not needed parts of DOCUMENTATION (most is now in the HTML version). - - updated the HTML documentation. - -new: - - example5/6/7.php added. - - setAutoRetry() method added. - Autoretrying of connecting to the IRC server, is now supported. - </notes> - </release> <release> - <version>0.5.0</version> - <date>2003-01-07</date> - <state>stable</state> - <notes> -v0.5.0 ------- -fixes: - - fixed critical bug in the main _rawreceive() for() loop, messages were lost. + <version>0.3.0</version> + <date>2002-10-23</date> + <state>beta</state> + <notes>v0.3.0 +----- +* phpSmartIRCclass.inc.php: + - added "Ping? Pong!" log message for debugging + - added real linux/windows syslog logging + to setlogdestination(). + - new method listen_for() makes it possible + to show irc related information on a homepage, like how many users + on a channel are. -changes: - - License changed from GPL to LGPL. - - updated in all files the copyright year. - - changed documentation tags in front of all methods to the phpDocumentator compatible format. - - improved connect() errorhandling. - - changed login() parameters to $nick, $realname, $usermode = 0, $username = null, $password = null. - - changed join() parameters to $channelarray, $key = null. - - changed kick() parameters to $channel, $nicknamearray, $reason = null. - - changed listenFor() parameters to $messagetype - return value is now the result, instead the of a reference to the result parameter. - - sendbuffer has now 3 queues: high, medium and low - high sends 2 messages, then 1 of medium - low is only send if high _and_ medium is empty. - - select() call for sockets is strongly optimized +* HOWTO: + - added how to run/call the selfwritten bot -new: - - phpDocumentator package tags. - - include() for messagehandler.php (needed for the new API). - - setChannelSynching() method, for enabling the channel synching. - - setCtcpVersion() method, for changing the ctcp version reply string. - - setReceiveTimeout() method, for changing the receive timeout. - - setTransmitTimeout() method, for changing the transmit timeout. - - setAutoReconnect() method, for enabling the autoreconnect feature. - - channel variable, a reference to _channels because $object->channel("#chan")->topic is not possible in PHP4 (ZE1). - - reconnect() method, it will reconnect and also join all channels. - - channel() method, getting a reference to the channel, only if channelsynching is on. - - added ident, host, messageex and rawmessageex variables to the Net_SmartIRC_data class. - - class Net_SmartIRC_user, stores info about one user, only used if channelsynching is on. - - class Net_SmartIRC_channel, stores info about one channel, only used if channelsynching is on. -</notes> +* DOCUMENTATION: + - added (missing) explaination for new methods + +* example2.php: + - new examplefile with the new listen_for() method</notes> </release> <release> - <version>0.4.0</version> - <date>2002-11-26</date> + <version>0.3.2</version> + <date>2002-11-05</date> <state>stable</state> - <notes> -v0.4.0 + <notes>v0.3.2 ------ * phpSmartIRCclass.inc.php: - - fixed serious socket bug - The buffer of the socket got full because only 512 bytes were read at once, - which caused losing some IRC messages that are comming fast like the MOTD. - Now it will read 10240 bytes at once, and doesn't loose any IRC message. - - fixed sendbuffer - The sendbuffer will only be sent, when the class is fully connected and - registered on the IRC network. Before if a nickname collision happened, + - Replaced all quotes by single quote where possible for speedup. + - Added _disconnecttime for doing a clean IRC quit. + - Added Zend IDE style documentation for parameter variables types + and method descriptions. + - Spaces in nickname and username will be automaticly removed. + - Nicknamecollisions are automaticly detected and nickname will be + changed to nickname with 3 random numbers. + - New method nicknameuse(). + - Fixed a serious fsock bug. + - Added new type TYPE_ERROR. + - Fixed wrong usage of & when calling methods with params that are + called by reference. + - Fixed a debug message "DEBUG: disconnected", now it will only + occur when debug mode is enabled. + - listen_for() will now do a quickdisconnect, for a big speedup. + - Changed logging system, now with debug levels, default is + DEBUG_NOTICE. + - Added benchmark system, now its possible to time things for doing + optimizations. + - New methods: benchmark(), benchmarktstart(), benchmarkend() + and show_benchmark() for the benchmark system + - Added microint(), for getting the microtime as float, needed for + the benchmarks. + - Added a couple of log() calls, for different debug levels. + - fsockets now runs in non blocking mode, because of broken? + getstatus for fsockets. + - Added mode() method, for chaning modes of a user or channel. + - Added op() and deop() method. Added ban() and unban() method + (thx for diff file to Peter Petermann). + +* DOCUMENTATION: + - added documentation for new logging system + - added the whole DEBUG_* list + +* HOWTO: + - changed parameter description for debug() + +* example.php: + - replaced all quotes by singlequotes where possible. + - fixed wrong usage of message() + +* example2.php: + - replaced all quotes by singlquotes where possible. + - added benchmark test to the example</notes> + </release> + <release> + <version>0.4.0</version> + <date>2002-11-26</date> + <state>stable</state> + <notes>v0.4.0 +------ +* phpSmartIRCclass.inc.php: + - fixed serious socket bug + The buffer of the socket got full because only 512 bytes were read at once, + which caused losing some IRC messages that are comming fast like the MOTD. + Now it will read 10240 bytes at once, and doesn't loose any IRC message. + - fixed sendbuffer + The sendbuffer will only be sent, when the class is fully connected and + registered on the IRC network. Before if a nickname collision happened, all sent IRC commands from the buffer were ignored by the IRC server. - fixed socket status Socket handling is now compatible with PHP 4.3 dev. @@ -574,128 +491,271 @@ * example.php: - changed user function parameter to new style ( &$irc and &$data ). - - added TYPE_NOTICE to query_test example. -</notes> + - added TYPE_NOTICE to query_test example.</notes> </release> <release> - <version>0.3.2</version> - <date>2002-11-05</date> + <version>0.5.0</version> + <date>2003-01-07</date> <state>stable</state> - <notes> -v0.3.2 + <notes>v0.5.0 ------ -* phpSmartIRCclass.inc.php: - - Replaced all quotes by single quote where possible for speedup. - - Added _disconnecttime for doing a clean IRC quit. - - Added Zend IDE style documentation for parameter variables types - and method descriptions. - - Spaces in nickname and username will be automaticly removed. - - Nicknamecollisions are automaticly detected and nickname will be - changed to nickname with 3 random numbers. - - New method nicknameuse(). - - Fixed a serious fsock bug. - - Added new type TYPE_ERROR. - - Fixed wrong usage of & when calling methods with params that are - called by reference. - - Fixed a debug message "DEBUG: disconnected", now it will only - occur when debug mode is enabled. - - listen_for() will now do a quickdisconnect, for a big speedup. - - Changed logging system, now with debug levels, default is - DEBUG_NOTICE. - - Added benchmark system, now its possible to time things for doing - optimizations. - - New methods: benchmark(), benchmarktstart(), benchmarkend() - and show_benchmark() for the benchmark system - - Added microint(), for getting the microtime as float, needed for - the benchmarks. - - Added a couple of log() calls, for different debug levels. - - fsockets now runs in non blocking mode, because of broken? - getstatus for fsockets. - - Added mode() method, for chaning modes of a user or channel. - - Added op() and deop() method. Added ban() and unban() method - (thx for diff file to Peter Petermann). +fixes: + - fixed critical bug in the main _rawreceive() for() loop, messages were lost. -* DOCUMENTATION: - - added documentation for new logging system - - added the whole DEBUG_* list +changes: + - License changed from GPL to LGPL. + - updated in all files the copyright year. + - changed documentation tags in front of all methods to the phpDocumentator compatible format. + - improved connect() errorhandling. + - changed login() parameters to $nick, $realname, $usermode = 0, $username = null, $password = null. + - changed join() parameters to $channelarray, $key = null. + - changed kick() parameters to $channel, $nicknamearray, $reason = null. + - changed listenFor() parameters to $messagetype + return value is now the result, instead the of a reference to the result parameter. + - sendbuffer has now 3 queues: high, medium and low + high sends 2 messages, then 1 of medium + low is only send if high _and_ medium is empty. + - select() call for sockets is strongly optimized -* HOWTO: - - changed parameter description for debug() +new: + - phpDocumentator package tags. + - include() for messagehandler.php (needed for the new API). + - setChannelSynching() method, for enabling the channel synching. + - setCtcpVersion() method, for changing the ctcp version reply string. + - setReceiveTimeout() method, for changing the receive timeout. + - setTransmitTimeout() method, for changing the transmit timeout. + - setAutoReconnect() method, for enabling the autoreconnect feature. + - channel variable, a reference to _channels because $object->channel("#chan")->topic is not possible in PHP4 (ZE1). + - reconnect() method, it will reconnect and also join all channels. + - channel() method, getting a reference to the channel, only if channelsynching is on. + - added ident, host, messageex and rawmessageex variables to the Net_SmartIRC_data class. + - class Net_SmartIRC_user, stores info about one user, only used if channelsynching is on. + - class Net_SmartIRC_channel, stores info about one channel, only used if channelsynching is on.</notes> + </release> + <release> + <version>0.5.1</version> + <date>2003-01-17</date> + <state>stable</state> + <notes>v0.5.1: +------- +fixes: + - major bugs in ChannelSynching fixed. + - fsocks support fixed. + - setUseSocket() method fixed. + If false was passed as parameter, it tried to load the socket extension. + Also warnings are now suppressed with @ in front of dl(). + - fixed a typo in reconnect(). + - missing SMARTIRC_DEBUG_CHANNELSYNCHING constant added. + +changes: + - new design for HTML documentation used (PEAR template). + - moved all examples to their own directory (examples/). + - moved the documentation to docs/HTML/. + - added new file descriptions to README. + - removed not needed parts of DOCUMENTATION (most is now in the HTML version). + - updated the HTML documentation. + +new: + - example5/6/7.php added. + - setAutoRetry() method added. + Autoretrying of connecting to the IRC server, is now supported.</notes> + </release> + <release> + <version>0.5.5</version> + <date>2003-07-23</date> + <state>stable</state> + <notes>v0.5.5: +------- +fixes: + - fixed a bug in _rawreceive() + messages were parsed wrong which caused problems with kick reasons. + (thx to sniper for reporting this). + - fixed bug in message() + CTCP ACTION messages had missing \001 at the end. + - fixed a bug in quit(), which caused quit messages not to be sent to the server. + - fixed reconnect() bug, it sent the channel join requests right after connect(), + and tried to join a channel without a name. + - fixes in ChannelSync code + When a user joins a channel after SmartIRC, no WHO info is updated in the user object. + Fixed wrong update of channel mode when rpl_channelmodeis received. + Fixed bug in _mode() method, which caused wrong handling of mode changes. + Topic updates are now tracked (thanks to sniper). + Fixed bug which caused fatal errors with ChannelSync enabled + (closes sf.net bug #705269). + Fixed bug in _event_mode(), unhandled modes were stored wrong. + Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick + of a namreply got cut (closes sf.net bug #747832). + - fixed bug in _checktimer() + Which caused problems when a timehandler is unregistered. + - fixed _gettye() + It wasn't recognizing SMARTIRC_TYPE_ACTION. + - removed if(!$obj) check for newly created objects (closes PHP bug #24622), + required for PHP 4.1.2 compatibility. -* example.php: - - replaced all quotes by singlequotes where possible. - - fixed wrong usage of message() +changes: + - removed all irc commands from SmartIRC.php + they have now their own file (SmartIRC/irccommands.php). + - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands. + - removed the 1. parameter (&$irc) of all message handlers, not needed anymore. + - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser, + added class Net_SmartIRC_ircuser. + - added prefix _event to all message handlers (needed because of class restructuring). + - tweaked filling of the ircdata objects. + - log() now checks the passed debug level bitwise. + - $data->message will be null instead of random garbage, + if the IRC message has no colon (the message part), + - All methods that depend on ChannelSync mode, checks if it's enabled. + - Optimized the usage of time() for $this->_lastrx. + - updated the URL of a SmartIRC based bot (atbs). + - _loggedin is now set to false when the socket is dead, + required for proper working reconnect(). + - on a reconnect(), the logfile won't be overwritten anymore. + - updated phpdoc tags. + - all access to the channel array now uses strtolower() for the key. + - fixed typo in function name setChannelSynching(), + now it's called setChannelSyncing() with a BC wrapper. + - removed all SMARTIRC_ prefixes for debug output. + - changed isJoined($channel) to isJoined($channel, $nickname) + for checking if the specified user is joined. + - removed "destructors", because they don't free the memory. -* example2.php: - - replaced all quotes by singlquotes where possible. - - added benchmark test to the example -</notes> +new: + - added isOpped() isVoiced() isBanned(). + - added debug output and debug level for the messageparser. + - reconnect() uses now the channel key if one exists. + - added channel key syncing in _mode(). + - when an actionhandler message regex has a leading '/' then the regex is used as it is, + this allows complex perl regex's. + - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP. + - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT + (for firendly browserouput). When the script is called from a browser, + the BROWSEROUT will automatic be used (closed sf.net bug #708155). + - added error handling for socket_select() in _rawreceive(). + - added getMessage() to Net_SmartIRC_Error class. + - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING). + - added filename and linenumber to debug output. + - added key property to channel class. + - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM. + - added isError() for more advanced errorhandling, needed for encapsulation. + - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types.</notes> </release> <release> - <version>0.3.0</version> - <date>2002-10-23</date> - <state>beta</state> - <notes> -v0.3.0 ------ -* phpSmartIRCclass.inc.php: - - added "Ping? Pong!" log message for debugging - - added real linux/windows syslog logging - to setlogdestination(). - - new method listen_for() makes it possible - to show irc related information on a homepage, like how many users - on a channel are. - -* HOWTO: - - added how to run/call the selfwritten bot + <version>0.5.5p1</version> + <date>2003-07-23</date> + <license>LGPL</license> + <state>stable</state> + <notes>v0.5.5: +------- +fixes: + - fixed a bug in _rawreceive() + messages were parsed wrong which caused problems with kick reasons. + (thx to sniper for reporting this). + - fixed bug in message() + CTCP ACTION messages had missing \001 at the end. + - fixed a bug in quit(), which caused quit messages not to be sent to the server. + - fixed reconnect() bug, it sent the channel join requests right after connect(), + and tried to join a channel without a name. + - fixes in ChannelSync code + When a user joins a channel after SmartIRC, no WHO info is updated in the user object. + Fixed wrong update of channel mode when rpl_channelmodeis received. + Fixed bug in _mode() method, which caused wrong handling of mode changes. + Topic updates are now tracked (thanks to sniper). + Fixed bug which caused fatal errors with ChannelSync enabled + (closes sf.net bug #705269). + Fixed bug in _event_mode(), unhandled modes were stored wrong. + Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick + of a namreply got cut (closes sf.net bug #747832). + - fixed bug in _checktimer() + Which caused problems when a timehandler is unregistered. + - fixed _gettye() + It wasn't recognizing SMARTIRC_TYPE_ACTION. + - removed if(!$obj) check for newly created objects (closes PHP bug #24622), + required for PHP 4.1.2 compatibility. -* DOCUMENTATION: - - added (missing) explaination for new methods +changes: + - removed all irc commands from SmartIRC.php + they have now their own file (SmartIRC/irccommands.php). + - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands. + - removed the 1. parameter (&$irc) of all message handlers, not needed anymore. + - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser, + added class Net_SmartIRC_ircuser. + - added prefix _event to all message handlers (needed because of class restructuring). + - tweaked filling of the ircdata objects. + - log() now checks the passed debug level bitwise. + - $data->message will be null instead of random garbage, + if the IRC message has no colon (the message part), + - All methods that depend on ChannelSync mode, checks if it's enabled. + - Optimized the usage of time() for $this->_lastrx. + - updated the URL of a SmartIRC based bot (atbs). + - _loggedin is now set to false when the socket is dead, + required for proper working reconnect(). + - on a reconnect(), the logfile won't be overwritten anymore. + - updated phpdoc tags. + - all access to the channel array now uses strtolower() for the key. + - fixed typo in function name setChannelSynching(), + now it's called setChannelSyncing() with a BC wrapper. + - removed all SMARTIRC_ prefixes for debug output. + - changed isJoined($channel) to isJoined($channel, $nickname) + for checking if the specified user is joined. + - removed "destructors", because they don't free the memory. -* example2.php: - - new examplefile with the new listen_for() method -</notes> +new: + - added isOpped() isVoiced() isBanned(). + - added debug output and debug level for the messageparser. + - reconnect() uses now the channel key if one exists. + - added channel key syncing in _mode(). + - when an actionhandler message regex has a leading '/' then the regex is used as it is, + this allows complex perl regex's. + - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP. + - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT + (for firendly browserouput). When the script is called from a browser, + the BROWSEROUT will automatic be used (closed sf.net bug #708155). + - added error handling for socket_select() in _rawreceive(). + - added getMessage() to Net_SmartIRC_Error class. + - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING). + - added filename and linenumber to debug output. + - added key property to channel class. + - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM. + - added isError() for more advanced errorhandling, needed for encapsulation. + - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types.</notes> </release> <release> - <version>0.2.6</version> - <date>2002-10-12</date> - <state>beta</state> + <version>1.0.0</version> + <date>2005-05-28</date> + <license>LGPL</license> + <state>stable</state> <notes> -v0.2.6 ------- -* phpSmartIRCclass.inc.php: - - phpSmartIRCclass.inc renamed to - phpSmartIRCclass.inc.php because of security reasons - - changed function_exists() to get_loaded_extensions() for - checking if the PHP build has real socket support - - log() changed to create Linux style formated logs - - new methods for logging (daemon style) - log() for add log entries setlogdestination() can be STDOUT or FILE - setlogfile() sets the file - - changed received data processing in rawreceive() +v1.0.0: +------- +Released as 1.0.0 because current PEAR rule require this for stable +packages, there are _no_ big changes in this release! -* HOWTO: - - added a mini howto for using the class +fixes: + - renamed Net_SmartIRC_base::Net_SmartIRC to + Net_SmartIRC_base::Net_SmartIRC_base + a PHP4 bug made it work, in PHP5 its fixed and doesn't + (closes PEAR bug #1466, sf.net patch #967067) + - fixed a bug in _rawreceive() + the parser checked if he found a colon (messagepart) but +1 was added, the + check never worked right (I found this bug while porting SmartIRC to C#) + - fixed bug in _gettype() + the regexs was too sloppy, sometimes it got confused, this can break easily + the ChannelSync code. + - fixed bug in _event_rpl_whoreply() + on some IRC networks, the channel info in who replies can't be used, they + return sometimes random channels, this can break ChannelSync code. + - fixed include paths in example scripts (closes PEAR bug #2042) -* DOCUMENTATION: - - added class documentation of the project +changes: + - applied load socket extension patch (sf.net patch #911993) from + Anatoly Techtonik <techtonik@users.sourceforge.net> + if the socket extension is not loaded, it will now try to load it for *nix + and windows. -* CREDITS: - - added credits file -</notes> - </release> - <release> - <version>0.2.5</version> - <date>2002-09-02</date> - <state>beta</state> - <notes> -v0.2.5 ------- -- improved socket handling -- bufferedsend fix -- new version number system -- cpu usage reduced -- added changelog file +new: + - added objListenFor() method + it works like listenFor() but returns an array of the received ircdata + objects (not just ircdata->message like listenFor() does) </notes> </release> </changelog>