<?php /** * StatusNet - the distributed open-source microblogging tool * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>. * * Extends the bot class (Phergie_Bot) to allow connection and access to * sockets and to allow StatusNet to 'drive' the bot * * @category Phergie * @package Phergie_StatusnetBot * @author Luke Fitzgerald <lw.fitzgerald@googlemail.com> * @copyright 2010 StatusNet, Inc. * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0 * @link http://status.net/ */ class Phergie_StatusnetBot extends Phergie_Bot { /** * Set up bot and connect to servers * * @return void */ public function connect() { $ui = $this->getUi(); $ui->setEnabled($this->getConfig('ui.enabled')); $this->loadPlugins(); $this->loadConnections(); } /** * Transmit raw command to server using driver * * Handles construction of command strings and their transmission to the * server. * * @param string $command Command to send * @param string|array $args Optional string or array of sequential * arguments * * @return string Command string that was sent * @throws Phergie_Driver_Exception */ public function send($command, $args = '') { return $this->getDriver()->send($command, $args); } /** * Handle incoming data on the socket using the handleEvents * method of the Processor * * @return void */ public function handleEvents() { $this->getProcessor()->handleEvents(); } /** * Close the current connection and reconnect to the server * * @return void */ public function reconnect() { $driver = $this->getDriver(); $sockets = $driver->getSockets(); // Close any existing connections try { $driver->forceQuit(); } catch (Phergie_Driver_Exception $e){} try { $driver->doConnect(); } catch (Phergie_Driver_Exception $e){ $driver->forceQuit(); throw $e; } } /** * Get the sockets used by the bot * * @return array Array of socket resources */ public function getSockets() { return $this->getDriver()->getSockets(); } }