WildPHP » Scripts

Simple PHP IRC Logger

admin — Tue, 11 May 2010 01:14:18 +0000

Description

Simple PHP IRC Logger is a simple PHP IRC Bot class designed to connect to an IRC server, and generate HTML log files. It is based on a modified version of Simple PHP IRC Bot. This script is designed and intended to be built upon for your needs, so if you have any problems please ask in our forum. Please also follow some of the notes below for guidance. For future updates and scripts, don’t forget to subscribe.

Features and Functions

!join #channel – Joins the specified IRC channel
!part #channel – Leaves the specified IRC channel
!say #channel Message – Says message in the specified IRC channel
!restart – Quits and restarts the script. (Helpful while testing the script)
!shutdown – Quits and stops the script.

Usage and output:

!say #nystic_chat hello there
hello there

Enable/Disable Logging (PHP Script Variable)
Enable/Disable Logging Warning Message (PHP Script Variable)

Note the script in the current version of the script, all joined channels will be added to the single log file for the day.

Installation

Download or copy paste the script from this page
(Optional) If downloaded rename the file to bot.php ( Sorry, the blog will only allow me to upload it as log-bot.txt)
Edit the $config array in the script to the server settings, should be self explanatory
Download and install XAMPP
Place bot.php in the htdocs folder of your XAMPP installation
Don’t forget to start the Apache server by pressing the start button in the XAMPP Control Panel
Go to http://localhost/log-bot.php, and the bot should connect and join the channel you specified in about 30 seconds
If you have warning enabled the bot should say “Chat Logging has been [Enabled]” when entering the default room
If you have logging enabled an HTML file should appear in the same directory, it will be updated when anyone says something in the room

Code

Download log-bot.txt (Right click, Save As…)



* @copyright  2010, The Nystic Network
* @license    http://creativecommons.org/licenses/by/3.0/
* @link       http://wildphp.com (Visit for updated versions and more free scripts!)
* @version    1.0.0 (Last updated 04-04-2010)
*
*/

//So the bot doesn't stop.
set_time_limit(0);
ini_set('display_errors', 'on');

/* --- Varibles and Config Info --- */

//Sample connection data.
$config = array(
//General Config Info
'server' => 'chat.freenode.net',
'port'   => 6667,
'name'   => 'wildphp-bot',
'nick'   => 'wildphp-bot',
'pass'   => '',

//Logging Config Info
'channel' => '#nystic_chat',
'logging' => true,
'warning' => true,
);

/*
//Set your connection data.
$config = array(
//General Config Info
'server' => 'irc.example.com',
'port'   => 6667,
'name'   => 'real name',
'nick'   => 'user',
'pass'   => 'pass',

//Logging Config Info
'channel' => '#channel',
'logging' => true,
'warning' => true,
);
*/

/* --- IRCBot Class --- */

class IRCBot {

//This is going to hold our TCP/IP connection
var $socket;

//This is going to hold all of the messages both server and client
var $ex = array();
//var $logging = true;

/*
Construct item, opens the server connection, logs the bot in
@param array
*/

function __construct($config)
{
$this->socket = fsockopen($config['server'], $config['port']);
$this->login($config);
$this->main($config);
}

/*
Logs the bot in on the server
@param array
*/

function login($config)
{
$this->send_data('USER', $config['nick'].' wildphp.com '.$config['nick'].' :'.$config['name']);
$this->send_data('NICK', $config['nick']);
$this->join_channel($config['channel']);

if($config['logging']) {
$date = date("n-j-y");
$time = date('h:i:s A');
$logfile = fopen("$date-log.html","a");
fwrite($logfile,"
**************** Logging Started at $time ****************
");
fclose($logfile);

//Warn that logging has been enabled
if($config['warning']) {
$this->send_data('PRIVMSG '.$config['channel'].' :', "Chat Logging has been [Enabled]");
}
}
}

/*
This is the workhorse function, grabs the data from the server and displays on the browser
*/

function main($config)
{
$data = fgets($this->socket, 256);

echo nl2br($data);

flush();

$this->ex = explode(' ', $data);

if($this->ex[0] == 'PING')
{
$this->send_data('PONG', $this->ex[0]); //Plays ping-pong with the server to stay connected.
}

//Logs the chat
if($config['logging'])
{
$logtxt = $this->filter_log($this->ex[1], $this->ex[2], $this->ex[0], $this->get_msg($this->ex)); //Gets human readable text from irc data
if($logtxt != null) { //Writes to log if it is a message
$date = date("n-j-y");
$logfile = fopen("$date-log.html","a");
fwrite($logfile,"$logtxt
");
fclose($logfile);
}
}

$command = str_replace(array(chr(10), chr(13)), '', $this->ex[3]);

switch($command) //List of commands the bot responds to from a user.
{
case ':!join':
$this->join_channel($this->ex[4]);
break;

case ':!quit':
$this->send_data('QUIT', 'Wildphp.com Made Bot');
break;

case ':!op':
$this->op_user();
break;

case ':!deop':
$this->op_user('','', false);
break;

case ':!protect':
$this->protect_user();
break;

case ':!say':
$message = "";
for($i=4; $i <= (count($this->ex)); $i++)
{
$message .= $this->ex[$i]." ";
}

$this->send_data('PRIVMSG '.$config['channel'].' :', $message);
break;

case ':!restart':
//Warn that logging has been disabled
if($config['warning']) {
$this->send_data('PRIVMSG '.$config['channel'].' :', "Chat Logging has been [Disabled]");
}

echo "";
if($config['logging']) {
$date = date("n-j-y");
$time = date('h:i:s A');
$logfile = fopen("$date-log.html","a");
fwrite($logfile,"
**************** Logging Ended at $time ****************
");
fclose($logfile);
}
exit;
case ':!shutdown':
//Warn that logging has been disabled
if($config['warning']) {
$this->send_data('PRIVMSG '.$config['channel'].' :', "Chat Logging has been [Disabled]");
}

if($config['logging']) {
$date = date("n-j-y");
$time = date('h:i:s A');
$logfile = fopen("$date-log.html","a");
fwrite($logfile,"
**************** Logging Ended at $time ****************
");
fclose($logfile);
}
exit;
}

$this->main($config);
}

/* --- IRCBot Class's Functions --- */

function filter_log($type, $chan, $nick, $msg)
{
$nick = ltrim($nick, ":");
$nick = substr($nick, 0, strpos($nick, "!"));

$msg = ltrim($msg, ":");

if($type == "PRIVMSG")
{
return date("[H:i]")." &amp;amp;lt;".$nick."&amp;amp;gt; ".$msg;
}
return null    ;
}

function get_msg($arr)
{
$message = "";
for($i=3; $i <= (count($this->ex)); $i++)
{
$message .= $this->ex[$i]." ";
}
return $message;
}

function send_data($cmd, $msg = null) //displays stuff to the broswer and sends data to the server.
{
if($msg == null)
{
fputs($this->socket, $cmd."\r\n");
echo ''.$cmd.'
';
} else {

fputs($this->socket, $cmd.' '.$msg."\r\n");
echo ''.$cmd.' '.$msg.'
';
}

}

function join_channel($channel) //Joins a channel, used in the join function.
{
if(is_array($channel))
{
foreach($channel as $chan)
{
$this->send_data('JOIN', $chan);
}

} else {
$this->send_data('JOIN', $channel);
}
}

function protect_user($user = '')
{
if($user == '')
{
if(php_version() >= '5.3.0')
{
$user = strstr($this->ex[0], '!', true);
} else {
$length = strstr($this->ex[0], '!');
$user   = substr($this->ex[0], 0, $length);
}
}

$this->send_data('MODE', $this->ex[2] . ' +a ' . $user);
}

function op_user($channel = '', $user = '', $op = true) {
if($channel == '' || $user == '')
{
if($channel == '')
{
$channel = $this->ex[2];
}

if($user == '')
{

if(php_version() >= '5.3.0')
{
$user = strstr($this->ex[0], '!', true);
} else {
$length = strstr($this->ex[0], '!');
$user   = substr($this->ex[0], 0, $length);
}
}
}

if($op)
{
$this->send_data('MODE', $channel . ' +o ' . $user);
} else {
$this->send_data('MODE', $channel . ' -o ' . $user);
}
}
}

//Start the bot
$bot = new IRCBot($config);
?>

Warning

This script uses PHP sockets, and most shared hosting and some servers have it disabled by default. This script runs continuously so it is not recommended to run on shared hosting accounts. We recommend you run it locally using the instructions below.

Help/Support

If you are having any problems with the PHP bot, need help extending it, or just have an idea, feel free to make a post on our forum.

Conclusion

Thanks for trying out our Simple PHP IRC Logger. You can check out the base class here. If their are any bugs in the code please let us know right away. Also thanks to KillerAuzzie for the for tutorial/basecode.

Simple PHP IRC Bot

admin — Sun, 21 Mar 2010 03:40:14 +0000

Description

Simple PHP IRC Bot, is a simple PHP IRC Bot class designed to connect to an IRC server, run a few simple commands. This script is designed and intended to be built upon, perhaps you could build a PHP IRC Client, so please follow some of the notes below for guidance. This bot is based off a PHP IRC Bot tutorial done on our sister site. In the coming weeks more specialized PHP IRC Bots will be made from this script. It will be expanded and modified for many uses including channel logging and channel moderation, so don’t forget to subscribe.

Warning

Installation

Download or copy paste the script from this page
(Optional) If downloaded rename the file to bot.php ( Sorry, the blog will only allow me to upload it as bot.txt)
Edit the $config array in the script to the server settings, should be self explanatory
Download and install XAMPP
Place bot.php in the htdocs folder of your XAMPP installation
Don’t forget to start the Apache server by pressing the start button in the XAMPP Control Panel
Go to http://localhost/bot.php, and the bot should connect and join the channel you specified in about 30 seconds

Code

Download bot.txt (Right click, Save As…)



* @copyright  2010, The Nystic Network
* @license    http://creativecommons.org/licenses/by/3.0/
* @link       http://wildphp.com (Visit for updated versions and more free scripts!)
* @version    1.0.0 (Last updated 03-20-2010)
*
*/

//So the bot doesnt stop.
set_time_limit(0);
ini_set('display_errors', 'on');

//Sample connection data.
$config = array(
'server' => 'chat.freenode.net',
'port'   => 6667,
'channel' => '#nystic_chat',
'name'   => 'wildphp-bot',
'nick'   => 'wildphp-bot',
'pass'   => '',
);

/*
//Set your connection data.
$config = array(
'server' => 'example.com',
'port'   => 6667,
'channel' => '#channel',
'name'   => 'real name',
'nick'   => 'user',
'pass'   => 'pass',
);
*/

class IRCBot {

//This is going to hold our TCP/IP connection
var $socket;

//This is going to hold all of the messages both server and client
var $ex = array();

/*

Construct item, opens the server connection, logs the bot in
@param array

*/

function __construct($config)

{
$this->socket = fsockopen($config['server'], $config['port']);
$this->login($config);
$this->main($config);
}

/*

Logs the bot in on the server
@param array

*/

function login($config)
{
$this->send_data('USER', $config['nick'].' wildphp.com '.$config['nick'].' :'.$config['name']);
$this->send_data('NICK', $config['nick']);
$this->join_channel($config['channel']);
}

/*

This is the workhorse function, grabs the data from the server and displays on the browser

*/

function main($config)
{
$data = fgets($this->socket, 256);

echo nl2br($data);

flush();

$this->ex = explode(' ', $data);

if($this->ex[0] == 'PING')
{
$this->send_data('PONG', $this->ex[1]); //Plays ping-pong with the server to stay connected.
}

$command = str_replace(array(chr(10), chr(13)), '', $this->ex[3]);

switch($command) //List of commands the bot responds to from a user.
{
case ':!join':
$this->join_channel($this->ex[4]);
break;
case ':!part':
$this->send_data('PART '.$this->ex[4].' :', 'Wildphp.com Free IRC Bot Script');
break;

case ':!say':
$message = "";
for($i=5; $i <= (count($this->ex)); $i++)
{
$message .= $this->ex[$i]." ";
}

$this->send_data('PRIVMSG '.$this->ex[4].' :', $message);
break;

case ':!restart':
echo "";
exit;
case ':!shutdown':
$this->send_data('QUIT', 'Wildphp.com Free IRC Bot Script');
exit;
}

$this->main($config);
}

function send_data($cmd, $msg = null) //displays stuff to the broswer and sends data to the server.
{
if($msg == null)
{
fputs($this->socket, $cmd."\r\n");
echo ''.$cmd.'
';
} else {

fputs($this->socket, $cmd.' '.$msg."\r\n");
echo ''.$cmd.' '.$msg.'
';
}

}

function join_channel($channel) //Joins a channel, used in the join function.
{

if(is_array($channel))
{
foreach($channel as $chan)
{
$this->send_data('JOIN', $chan);
}

} else {
$this->send_data('JOIN', $channel);
}
}
}

//Start the bot
$bot = new IRCBot($config);
?>

Features and Functions

!join #channel – Joins the specified IRC channel
!part #channel – Leaves the specified IRC channel
!say #channel Message – Says message in the specified IRC channel
!restart – Quits and restarts the script. (Helpful while testing the script)
!shutdown – Quits and stops the script.

Usage and output:

!say #nystic_chat hello there
hello there

Code Lines of Note

Lines 24 – 48: This is where you set your connection data
Line 101: Prints all the output you see on the screen
Line 115-140: Contains all commands
Line 180: Starts the bot

Help/Support

If you are having any problems with the PHP bot, need help extending it, or just have an idea, feel free to make a post on our forum.

Extensions

Coding.layne build his own version of this PHP Bot. You can take a look at it here.

Conclusion

Thanks for trying out our PHP IRC bot. If their are any bugs in the code please let us know right away. Also thanks to KillerAuzzie for the for tutorial/basecode.