2013-11-09 17:24:03 +01:00
|
|
|
<?php
|
|
|
|
|
2013-11-12 15:48:25 +01:00
|
|
|
namespace ManiaControl\Callbacks;
|
|
|
|
|
|
|
|
use ManiaControl\ManiaControl;
|
2013-11-09 17:24:03 +01:00
|
|
|
|
|
|
|
/**
|
2014-01-09 20:38:45 +01:00
|
|
|
* Class for managing Server and ManiaControl Callbacks
|
2013-11-09 17:24:03 +01:00
|
|
|
*
|
2014-05-02 17:50:30 +02:00
|
|
|
* @author ManiaControl Team <mail@maniacontrol.com>
|
|
|
|
* @copyright 2014 ManiaControl Team
|
2014-04-24 21:55:47 +02:00
|
|
|
* @license http://www.gnu.org/licenses/ GNU General Public License, Version 3
|
2013-11-09 17:24:03 +01:00
|
|
|
*/
|
2013-11-12 15:48:25 +01:00
|
|
|
class CallbackManager {
|
2014-04-12 12:14:37 +02:00
|
|
|
/*
|
2013-11-09 17:24:03 +01:00
|
|
|
* Constants
|
|
|
|
*/
|
|
|
|
// ManiaControl callbacks
|
2014-05-11 16:02:29 +02:00
|
|
|
// TODO: move into Callbacks interface
|
2014-05-24 16:39:12 +02:00
|
|
|
/** @deprecated Use Callbacks Interface */
|
|
|
|
const CB_ONINIT = 'Callbacks.OnInit';
|
|
|
|
/** @deprecated Use Callbacks Interface */
|
|
|
|
const CB_AFTERINIT = 'Callbacks.AfterInit';
|
|
|
|
/** @deprecated Use Callbacks Interface */
|
|
|
|
const CB_ONSHUTDOWN = 'Callbacks.OnShutdown';
|
2014-04-24 21:55:47 +02:00
|
|
|
|
2013-11-09 17:24:03 +01:00
|
|
|
// ManiaPlanet callbacks
|
2014-04-24 21:55:47 +02:00
|
|
|
const CB_MP_SERVERSTART = 'ManiaPlanet.ServerStart';
|
|
|
|
const CB_MP_SERVERSTOP = 'ManiaPlanet.ServerStop';
|
|
|
|
const CB_MP_BEGINMATCH = 'ManiaPlanet.BeginMatch';
|
|
|
|
const CB_MP_ENDMATCH = 'ManiaPlanet.EndMatch';
|
|
|
|
const CB_MP_MAPLISTMODIFIED = 'ManiaPlanet.MapListModified';
|
|
|
|
const CB_MP_ECHO = 'ManiaPlanet.Echo';
|
|
|
|
const CB_MP_BILLUPDATED = 'ManiaPlanet.BillUpdated';
|
|
|
|
const CB_MP_PLAYERCHAT = 'ManiaPlanet.PlayerChat';
|
|
|
|
const CB_MP_PLAYERCONNECT = 'ManiaPlanet.PlayerConnect';
|
|
|
|
const CB_MP_PLAYERDISCONNECT = 'ManiaPlanet.PlayerDisconnect';
|
2013-11-09 17:24:03 +01:00
|
|
|
const CB_MP_PLAYERMANIALINKPAGEANSWER = 'ManiaPlanet.PlayerManialinkPageAnswer';
|
2014-04-24 21:55:47 +02:00
|
|
|
const CB_MP_PLAYERINFOCHANGED = 'ManiaPlanet.PlayerInfoChanged';
|
|
|
|
const CB_MP_PLAYERALLIESCHANGED = 'ManiaPlanet.PlayerAlliesChanged';
|
|
|
|
const CB_MP_VOTEUPDATED = 'ManiaPlanet.VoteUpdated';
|
|
|
|
const CB_MP_STATUSCHANGED = 'ManiaPlanet.StatusChanged';
|
|
|
|
const CB_MP_MODESCRIPTCALLBACK = 'ManiaPlanet.ModeScriptCallback';
|
|
|
|
const CB_MP_MODESCRIPTCALLBACKARRAY = 'ManiaPlanet.ModeScriptCallbackArray';
|
|
|
|
const CB_MP_TUNNELDATARECEIVED = 'ManiaPlanet.TunnelDataReceived';
|
|
|
|
|
2013-11-09 17:24:03 +01:00
|
|
|
// TrackMania callbacks
|
2014-04-24 21:55:47 +02:00
|
|
|
const CB_TM_PLAYERCHECKPOINT = 'TrackMania.PlayerCheckpoint';
|
|
|
|
const CB_TM_PLAYERFINISH = 'TrackMania.PlayerFinish';
|
2013-11-09 17:24:03 +01:00
|
|
|
const CB_TM_PLAYERINCOHERENCE = 'TrackMania.PlayerIncoherence';
|
2014-04-24 21:55:47 +02:00
|
|
|
|
2014-03-19 21:58:11 +01:00
|
|
|
/*
|
2014-04-12 12:14:37 +02:00
|
|
|
* Public Properties
|
2014-03-19 21:58:11 +01:00
|
|
|
*/
|
2014-04-24 17:41:05 +02:00
|
|
|
public $libXmlRpcCallbacks = null;
|
2014-05-24 16:39:12 +02:00
|
|
|
public $shootManiaCallbacks = null;
|
2014-04-24 17:41:05 +02:00
|
|
|
|
2014-03-19 21:58:11 +01:00
|
|
|
/*
|
2014-04-12 12:14:37 +02:00
|
|
|
* Private Properties
|
2013-11-09 17:24:03 +01:00
|
|
|
*/
|
2013-11-10 02:55:08 +01:00
|
|
|
private $maniaControl = null;
|
2014-05-13 01:18:47 +02:00
|
|
|
private $callbackListenings = array();
|
|
|
|
private $scriptCallbackListenings = array();
|
2014-01-09 20:38:45 +01:00
|
|
|
|
2013-11-09 17:24:03 +01:00
|
|
|
/**
|
2014-01-09 20:38:45 +01:00
|
|
|
* Construct a new Callbacks Manager
|
2013-11-10 02:55:08 +01:00
|
|
|
*
|
2014-05-13 01:18:47 +02:00
|
|
|
* @param ManiaControl $maniaControl
|
2013-11-09 17:24:03 +01:00
|
|
|
*/
|
2013-11-10 02:55:08 +01:00
|
|
|
public function __construct(ManiaControl $maniaControl) {
|
|
|
|
$this->maniaControl = $maniaControl;
|
2014-04-24 21:55:47 +02:00
|
|
|
|
2014-03-19 21:58:11 +01:00
|
|
|
$this->shootManiaCallbacks = new ShootManiaCallbacks($maniaControl, $this);
|
2014-05-13 01:18:47 +02:00
|
|
|
$this->libXmlRpcCallbacks = new LibXmlRpcCallbacks($maniaControl, $this);
|
2013-11-09 17:24:03 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-01-09 20:38:45 +01:00
|
|
|
* Register a new Callback Listener
|
2013-11-12 15:48:25 +01:00
|
|
|
*
|
2014-05-13 01:18:47 +02:00
|
|
|
* @param string $callbackName
|
|
|
|
* @param CallbackListener $listener
|
|
|
|
* @param string $method
|
2013-11-12 15:48:25 +01:00
|
|
|
* @return bool
|
2013-11-09 17:24:03 +01:00
|
|
|
*/
|
2013-11-12 15:48:25 +01:00
|
|
|
public function registerCallbackListener($callbackName, CallbackListener $listener, $method) {
|
2014-05-13 01:18:47 +02:00
|
|
|
if (is_array($callbackName)) {
|
|
|
|
$success = true;
|
|
|
|
foreach ($callbackName as $callback) {
|
|
|
|
if (!$this->registerCallbackListener($callback, $listener, $method)) {
|
|
|
|
$success = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return $success;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!Listening::checkValidCallback($listener, $method)) {
|
|
|
|
$listenerClass = get_class($listener);
|
|
|
|
trigger_error("Given Listener '{$listenerClass}' can't handle Callback '{$callbackName}': No callable Method '{$method}'!");
|
2013-11-12 15:48:25 +01:00
|
|
|
return false;
|
2013-11-09 17:24:03 +01:00
|
|
|
}
|
2014-05-13 01:18:47 +02:00
|
|
|
|
|
|
|
if (!array_key_exists($callbackName, $this->callbackListenings)) {
|
|
|
|
$this->callbackListenings[$callbackName] = array();
|
2013-11-12 15:48:25 +01:00
|
|
|
}
|
2014-05-13 01:18:47 +02:00
|
|
|
|
|
|
|
$listening = new Listening($listener, $method);
|
|
|
|
array_push($this->callbackListenings[$callbackName], $listening);
|
|
|
|
|
2013-11-12 15:48:25 +01:00
|
|
|
return true;
|
2013-11-09 17:24:03 +01:00
|
|
|
}
|
|
|
|
|
2013-11-25 19:46:29 +01:00
|
|
|
/**
|
2014-01-09 20:38:45 +01:00
|
|
|
* Register a new Script Callback Listener
|
2013-11-25 19:46:29 +01:00
|
|
|
*
|
2014-04-24 21:55:47 +02:00
|
|
|
* @param string $callbackName
|
2014-01-09 20:38:45 +01:00
|
|
|
* @param CallbackListener $listener
|
2014-04-24 21:55:47 +02:00
|
|
|
* @param string $method
|
2013-11-25 19:46:29 +01:00
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function registerScriptCallbackListener($callbackName, CallbackListener $listener, $method) {
|
2014-05-13 01:18:47 +02:00
|
|
|
if (is_array($callbackName)) {
|
|
|
|
$success = true;
|
|
|
|
foreach ($callbackName as $callback) {
|
|
|
|
if (!$this->registerScriptCallbackListener($callback, $listener, $method)) {
|
|
|
|
$success = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return $success;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!Listening::checkValidCallback($listener, $method)) {
|
|
|
|
$listenerClass = get_class($listener);
|
|
|
|
trigger_error("Given Listener '{$listenerClass}' can't handle Script Callback '{$callbackName}': No callable Method '{$method}'!");
|
2013-11-25 19:46:29 +01:00
|
|
|
return false;
|
|
|
|
}
|
2014-05-13 01:18:47 +02:00
|
|
|
|
|
|
|
if (!array_key_exists($callbackName, $this->scriptCallbackListenings)) {
|
|
|
|
$this->scriptCallbackListenings[$callbackName] = array();
|
2013-11-25 19:46:29 +01:00
|
|
|
}
|
2014-05-13 01:18:47 +02:00
|
|
|
|
|
|
|
$listening = new Listening($listener, $method);
|
|
|
|
array_push($this->scriptCallbackListenings[$callbackName], $listening);
|
|
|
|
|
2013-11-25 19:46:29 +01:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2013-12-14 23:27:15 +01:00
|
|
|
/**
|
2014-05-13 01:18:47 +02:00
|
|
|
* Unregister a Callback Listener
|
2013-12-14 23:27:15 +01:00
|
|
|
*
|
2014-01-09 20:38:45 +01:00
|
|
|
* @param CallbackListener $listener
|
2013-12-14 23:27:15 +01:00
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function unregisterCallbackListener(CallbackListener $listener) {
|
2014-05-13 01:18:47 +02:00
|
|
|
return $this->removeCallbackListener($this->callbackListenings, $listener);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Remove the Callback Listener from the given Listeners Array
|
|
|
|
*
|
|
|
|
* @param array $listeningsArray
|
|
|
|
* @param CallbackListener $listener
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
private function removeCallbackListener(array &$listeningsArray, CallbackListener $listener) {
|
2013-12-14 23:27:15 +01:00
|
|
|
$removed = false;
|
2014-05-13 01:18:47 +02:00
|
|
|
foreach ($listeningsArray as &$listenings) {
|
|
|
|
foreach ($listenings as $key => &$listening) {
|
|
|
|
/** @var Listening $listening */
|
|
|
|
if ($listening->listener === $listener) {
|
|
|
|
unset($listenings[$key]);
|
2014-05-07 23:00:21 +02:00
|
|
|
$removed = true;
|
2014-01-19 23:18:48 +01:00
|
|
|
}
|
2013-12-14 23:27:15 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
return $removed;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-05-13 01:18:47 +02:00
|
|
|
* Unregister a Script Callback Listener
|
2013-12-14 23:27:15 +01:00
|
|
|
*
|
2014-01-09 20:38:45 +01:00
|
|
|
* @param CallbackListener $listener
|
2013-12-14 23:27:15 +01:00
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function unregisterScriptCallbackListener(CallbackListener $listener) {
|
2014-05-13 01:18:47 +02:00
|
|
|
return $this->removeCallbackListener($this->scriptCallbackListenings, $listener);
|
2013-12-14 23:27:15 +01:00
|
|
|
}
|
|
|
|
|
2013-11-12 15:48:25 +01:00
|
|
|
/**
|
2014-01-09 20:38:45 +01:00
|
|
|
* Trigger internal Callbacks and manage Server Callbacks
|
2013-11-12 15:48:25 +01:00
|
|
|
*/
|
|
|
|
public function manageCallbacks() {
|
2014-01-31 00:04:40 +01:00
|
|
|
// Manage Timings
|
2014-01-30 22:35:32 +01:00
|
|
|
$this->maniaControl->timerManager->manageTimings();
|
2014-04-24 21:55:47 +02:00
|
|
|
|
2014-01-09 20:38:45 +01:00
|
|
|
// Server Callbacks
|
2014-01-30 22:35:32 +01:00
|
|
|
if (!$this->maniaControl->client) {
|
2014-01-19 23:18:48 +01:00
|
|
|
return;
|
|
|
|
}
|
2014-04-24 21:55:47 +02:00
|
|
|
|
2013-11-09 17:24:03 +01:00
|
|
|
// Handle callbacks
|
2014-05-13 01:18:47 +02:00
|
|
|
$callbacks = $this->maniaControl->client->executeCallbacks();
|
2014-05-02 17:50:30 +02:00
|
|
|
foreach ($callbacks as $callback) {
|
2014-03-19 21:58:11 +01:00
|
|
|
$this->handleCallback($callback);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Handle the given Callback
|
|
|
|
*
|
|
|
|
* @param array $callback
|
|
|
|
*/
|
|
|
|
private function handleCallback(array $callback) {
|
|
|
|
$callbackName = $callback[0];
|
2014-05-02 17:50:30 +02:00
|
|
|
switch ($callbackName) {
|
2014-03-19 21:58:11 +01:00
|
|
|
case 'ManiaPlanet.BeginMatch':
|
2014-05-09 12:19:06 +02:00
|
|
|
$this->triggerCallback($callbackName, $callback);
|
2014-05-02 17:50:30 +02:00
|
|
|
break;
|
2014-03-19 21:58:11 +01:00
|
|
|
case 'ManiaPlanet.BeginMap':
|
|
|
|
$this->maniaControl->mapManager->handleBeginMap($callback);
|
|
|
|
$this->triggerCallback($callbackName, $callback);
|
|
|
|
break;
|
2014-05-09 12:14:25 +02:00
|
|
|
case 'ManiaPlanet.EndMatch':
|
|
|
|
$this->triggerCallback($callbackName, $callback);
|
2014-05-02 17:50:30 +02:00
|
|
|
break;
|
2014-03-19 21:58:11 +01:00
|
|
|
case 'ManiaPlanet.EndMap':
|
|
|
|
$this->maniaControl->mapManager->handleEndMap($callback);
|
|
|
|
$this->triggerCallback($callbackName, $callback);
|
|
|
|
break;
|
|
|
|
case self::CB_MP_MODESCRIPTCALLBACK:
|
|
|
|
$this->handleScriptCallback($callback);
|
|
|
|
$this->triggerCallback($callbackName, $callback);
|
|
|
|
break;
|
|
|
|
case self::CB_MP_MODESCRIPTCALLBACKARRAY:
|
|
|
|
$this->handleScriptCallback($callback);
|
|
|
|
$this->triggerCallback($callbackName, $callback);
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
$this->triggerCallback($callbackName, $callback);
|
|
|
|
break;
|
2013-11-09 17:24:03 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-05-02 17:50:30 +02:00
|
|
|
/**
|
|
|
|
* Trigger a specific Callback
|
|
|
|
*
|
|
|
|
* @param string $callbackName
|
|
|
|
*/
|
|
|
|
public function triggerCallback($callbackName) {
|
2014-05-13 01:18:47 +02:00
|
|
|
if (!array_key_exists($callbackName, $this->callbackListenings)) {
|
2014-05-02 17:50:30 +02:00
|
|
|
return;
|
|
|
|
}
|
2014-05-13 01:18:47 +02:00
|
|
|
|
2014-05-02 17:50:30 +02:00
|
|
|
$params = func_get_args();
|
2014-05-13 01:18:47 +02:00
|
|
|
$params = array_slice($params, 1, null, true);
|
|
|
|
|
|
|
|
foreach ($this->callbackListenings[$callbackName] as $listening) {
|
|
|
|
/** @var Listening $listening */
|
|
|
|
$listening->triggerCallbackWithParams($params);
|
2014-05-02 17:50:30 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2013-11-09 17:24:03 +01:00
|
|
|
/**
|
2014-01-09 20:38:45 +01:00
|
|
|
* Handle the given Script Callback
|
2013-11-09 17:24:03 +01:00
|
|
|
*
|
2014-01-09 20:38:45 +01:00
|
|
|
* @param array $callback
|
2013-11-09 17:24:03 +01:00
|
|
|
*/
|
2013-11-12 15:48:25 +01:00
|
|
|
private function handleScriptCallback(array $callback) {
|
2013-11-25 19:46:29 +01:00
|
|
|
$scriptCallbackData = $callback[1];
|
|
|
|
$scriptCallbackName = $scriptCallbackData[0];
|
2014-03-19 21:58:11 +01:00
|
|
|
$this->triggerScriptCallback($scriptCallbackName, $scriptCallbackData);
|
2014-04-24 21:55:47 +02:00
|
|
|
$this->triggerCallback(Callbacks::SCRIPTCALLBACK, $scriptCallbackName, $scriptCallbackData[1]);
|
2013-11-09 17:24:03 +01:00
|
|
|
}
|
2014-05-02 17:50:30 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Trigger a specific Script Callback
|
|
|
|
*
|
|
|
|
* @param string $callbackName
|
|
|
|
*/
|
|
|
|
public function triggerScriptCallback($callbackName) {
|
2014-05-13 01:18:47 +02:00
|
|
|
if (!array_key_exists($callbackName, $this->scriptCallbackListenings)) {
|
2014-05-02 17:50:30 +02:00
|
|
|
return;
|
|
|
|
}
|
2014-05-13 01:18:47 +02:00
|
|
|
|
2014-05-02 17:50:30 +02:00
|
|
|
$params = func_get_args();
|
2014-05-13 01:18:47 +02:00
|
|
|
$params = array_slice($params, 1, null, true);
|
|
|
|
|
|
|
|
foreach ($this->scriptCallbackListenings[$callbackName] as $listening) {
|
|
|
|
/** @var Listening $listening */
|
|
|
|
$listening->triggerCallbackWithParams($params);
|
2014-05-02 17:50:30 +02:00
|
|
|
}
|
|
|
|
}
|
2013-11-09 17:24:03 +01:00
|
|
|
}
|