/phergie-irc-generator

PHP generator for messages conforming to the IRC protocol

Primary LanguagePHPBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

phergie/phergie-irc-generator

A PHP-based generator for messages conforming to the IRC protocol as described in RFC 1459.

Build Status

Install

The recommended method of installation is through composer.

{
    "minimum-stability": "dev",
    "require": {
        "phergie/phergie-irc-generator": "1.0.0"
    }
}

Design goals

  • Minimal dependencies: PHP 5.3.3+
  • Simple easy-to-understand API

Usage

<?php
$generator = new \Phergie\Irc\Generator();
$messages = $generator->ircPass('password')
    . $generator->ircNick('nick')
    . $generator->ircUser('username', 'hostname', 'servername', 'realname')
    . $generator->ircJoin('#channel1,#channel2')
    . $generator->ircPrivsmg('#channel1', 'Hello world!');
echo $messages;

/*
Output:
PASS :password
NICK :nick
USER username hostname servername :realname
JOIN :#channel1,#channel2
PRIVMSG #channel1 :Hello world!

*/

Tests

To run the unit test suite:

cd tests
curl -s https://getcomposer.org/installer | php
php composer.phar install
./vendor/bin/phpunit Phergie/Irc/GeneratorTest.php

License

Released under the BSD License. See LICENSE.

Community

Check out #phergie on irc.freenode.net.