plugins/Meteor/MeteorPlugin.php

   1 <?php
   2 /**
   3  * StatusNet, the distributed open-source microblogging tool
   4  *
   5  * Plugin to do "real time" updates using Comet/Bayeux
   6  *
   7  * PHP version 5
   8  *
   9  * LICENCE: This program is free software: you can redistribute it and/or modify
  10  * it under the terms of the GNU Affero General Public License as published by
  11  * the Free Software Foundation, either version 3 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU Affero General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Affero General Public License
  20  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  21  *
  22  * @category  Plugin
  23  * @package   StatusNet
  24  * @author    Evan Prodromou <evan@status.net>
  25  * @copyright 2009 StatusNet, Inc.
  26  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  27  * @link      http://status.net/
  28  */
  29
  30 if (!defined('STATUSNET') && !defined('LACONICA')) {
  31     exit(1);
  32 }
  33
  34 require_once INSTALLDIR.'/plugins/Realtime/RealtimePlugin.php';
  35
  36 /**
  37  * Plugin to do realtime updates using Meteor
  38  *
  39  * @category Plugin
  40  * @package  StatusNet
  41  * @author   Evan Prodromou <evan@status.net>
  42  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  43  * @link     http://status.net/
  44  */
  45 class MeteorPlugin extends RealtimePlugin
  46 {
  47     public $webserver     = null;
  48     public $webport       = null;
  49     public $controlport   = null;
  50     public $controlserver = null;
  51     public $channelbase   = null;
  52     public $persistent    = true;
  53     protected $_socket    = null;
  54
  55     function __construct($webserver=null, $webport=4670, $controlport=4671, $controlserver=null, $channelbase='')
  56     {
  57         global $config;
  58
  59         $this->webserver     = (empty($webserver)) ? $config['site']['server'] : $webserver;
  60         $this->webport       = $webport;
  61         $this->controlport   = $controlport;
  62         $this->controlserver = (empty($controlserver)) ? $webserver : $controlserver;
  63         $this->channelbase   = $channelbase;
  64
  65         parent::__construct();
  66     }
  67
  68     /**
  69      * Pull settings from config file/database if set.
  70      */
  71     function initialize()
  72     {
  73         $settings = array('webserver',
  74                           'webport',
  75                           'controlport',
  76                           'controlserver',
  77                           'channelbase');
  78         foreach ($settings as $name) {
  79             $val = common_config('meteor', $name);
  80             if ($val !== false) {
  81                 $this->$name = $val;
  82             }
  83         }
  84
  85         return parent::initialize();
  86     }
  87
  88     function _getScripts()
  89     {
  90         $scripts = parent::_getScripts();
  91         $scripts[] = 'http://'.$this->webserver.(($this->webport == 80) ? '':':'.$this->webport).'/meteor.js';
  92         $scripts[] = $this->path('meteorupdater.min.js');
  93         return $scripts;
  94     }
  95
  96     function _updateInitialize($timeline, $user_id)
  97     {
  98         $script = parent::_updateInitialize($timeline, $user_id);
  99         return $script." MeteorUpdater.init(\"$this->webserver\", $this->webport, \"{$timeline}\");";
 100     }
 101
 102     function _connect()
 103     {
 104         $controlserver = (empty($this->controlserver)) ? $this->webserver : $this->controlserver;
 105
 106         $errno = $errstr = null;
 107         $timeout = 5;
 108         $flags = STREAM_CLIENT_CONNECT;
 109         if ($this->persistent) $flags |= STREAM_CLIENT_PERSISTENT;
 110
 111         // May throw an exception.
 112         $this->_socket = stream_socket_client("tcp://{$controlserver}:{$this->controlport}", $errno, $errstr, $timeout, $flags);
 113         if (!$this->_socket) {
 114             // TRANS: Exception. %1$s is the control server, %2$s is the control port.
 115             throw new Exception(sprintf(_m('Couldn\'t connect to %1$s on %2$s.'),$controlserver,$this->controlport));
 116         }
 117     }
 118
 119     function _publish($channel, $message)
 120     {
 121         $message = json_encode($message);
 122         $message = addslashes($message);
 123         $cmd = "ADDMESSAGE $channel $message\n";
 124         $cnt = fwrite($this->_socket, $cmd);
 125         $result = fgets($this->_socket);
 126         if (preg_match('/^ERR (.*)$/', $result, $matches)) {
 127             // TRANS: Exception. %s is the Meteor message that could not be added.
 128             throw new Exception(sprintf(_m('Error adding meteor message "%s"'),$matches[1]));
 129         }
 130         // TODO: parse and deal with result
 131     }
 132
 133     function _disconnect()
 134     {
 135         if (!$this->persistent) {
 136             $cnt = fwrite($this->_socket, "QUIT\n");
 137             @fclose($this->_socket);
 138         }
 139     }
 140
 141     // Meteord flips out with default '/' separator
 142
 143     function _pathToChannel($path)
 144     {
 145         if (!empty($this->channelbase)) {
 146             array_unshift($path, $this->channelbase);
 147         }
 148         return implode('-', $path);
 149     }
 150
 151     function onPluginVersion(&$versions)
 152     {
 153         $versions[] = array('name' => 'Meteor',
 154                             'version' => STATUSNET_VERSION,
 155                             'author' => 'Evan Prodromou',
 156                             'homepage' => 'http://status.net/wiki/Plugin:Meteor',
 157                             'rawdescription' =>
 158                             _m('Plugin to do "real time" updates using Comet/Bayeux.'));
 159         return true;
 160     }
 161 }