root/trunk/Phergie/Event/Handler/AdminCommand.php @ 11

<?php

/**
* @see Phergie_Event_Handler
*/
require_once 'Phergie/Event/Handler.php';

/**
 * Handles admin rights
 *
 * Users are defined in the ini file in the AdminCommand.admins entry
 * The syntax is a double-quoted, coma-separated list of hostmasks, i.e. :
 * <code>AdminCommand.admins = "John!Doe@*.aol.com,Bob!*"</code>
 *
 * Each hostmask can comprise a nick, a user and a host part, structured as such :
 *   nick!user@host
 *
 * A wildcard can be used to match anything,
 * for example those are valid (but different) matches for : John!Doe@35.43.2.aol.com
 *
 * <code>
 *   John*
 *   *Doe@*.aol.com
 *   John!*@*
 *   *!*@35.43.2.aol.com
 * </code>
 */
abstract class Phergie_Event_Handler_AdminCommand extends Phergie_Event_Handler
{
    protected $_admins = null;

    public function isAdmin(Phergie_Event_Request $event)
    {
        if ($this->_admins === null) {
            $this->initialize();
        }
        $mask = $event->getNick() .'!'. $event->getUsername() .'@'. $event->getHost();
        // Try to match mask against admin masks
        foreach ($this->_admins as $admin) {
            if (preg_match('{^'.$admin.'$}', $mask)) {
                return true;
            }
        }
        return false;
    }

    protected function initialize()
    {
        $admins = explode(',', $this->getIni('AdminCommand.admins'));
        $this->_admins = array();
        foreach ($admins as $admin) {
            // Find out which chars are present in the config mask and exclude them from the regex match
            $excluded = '';
            if (strpos($admin, '!')!==false) {
                $excluded .= '!';
            }
            if (strpos($admin, '@')!==false) {
                $excluded .= '@';
            }

            // Escape regex meta characters
            $admin = str_replace(
                array('\\', '^', '$', '.', '[', ']', '|', '(', ')', '?', '+', '{', '}'),
                array('\\\\', '\\^', '\\$', '\\.', '\\[', '\\]', '\\|', '\\(', '\\)', '\\?', '\\+', '\\{', '\\}'),
                $admin
            );
            // Replace * so that they match correctly in a regex
            $this->_admins[] = str_replace('*', ($excluded === '' ? '.*' : '[^'.$excluded.']*'), $admin);
        }
    }
}