TrackManiaControl/core/ManiaControl.php

841 lines
21 KiB
PHP

<?php
namespace ManiaControl;
use ManiaControl\Admin\ActionsMenu;
use ManiaControl\Admin\AuthenticationManager;
use ManiaControl\Admin\ColorManager;
use ManiaControl\Bills\BillManager;
use ManiaControl\Callbacks\CallbackListener;
use ManiaControl\Callbacks\CallbackManager;
use ManiaControl\Callbacks\Callbacks;
use ManiaControl\Callbacks\CallQueueManager;
use ManiaControl\Callbacks\EchoManager;
use ManiaControl\Callbacks\TimerListener;
use ManiaControl\Callbacks\TimerManager;
use ManiaControl\Commands\CommandListener;
use ManiaControl\Commands\CommandManager;
use ManiaControl\Communication\CommunicationAnswer;
use ManiaControl\Communication\CommunicationListener;
use ManiaControl\Communication\CommunicationManager;
use ManiaControl\Communication\CommunicationMethods;
use ManiaControl\Configurator\Configurator;
use ManiaControl\Database\Database;
use ManiaControl\Files\AsynchronousFileReader;
use ManiaControl\Files\FileUtil;
use ManiaControl\General\UsageInformationAble;
use ManiaControl\General\UsageInformationTrait;
use ManiaControl\Manialinks\ManialinkManager;
use ManiaControl\Manialinks\ToggleInterfaceManager;
use ManiaControl\Maps\MapManager;
use ManiaControl\Players\Player;
use ManiaControl\Players\PlayerManager;
use ManiaControl\Plugins\PluginManager;
use ManiaControl\Script\ModeScriptEventManager;
use ManiaControl\Server\Server;
use ManiaControl\Settings\SettingManager;
use ManiaControl\Statistics\StatisticManager;
use ManiaControl\Update\ChangeLog;
use ManiaControl\Update\UpdateManager;
use ManiaControl\Utils\CommandLineHelper;
use ManiaControl\Utils\SystemUtil;
use Maniaplanet\DedicatedServer\Connection;
use Maniaplanet\DedicatedServer\Xmlrpc\AuthenticationException;
use Maniaplanet\DedicatedServer\Xmlrpc\TransportException;
/**
* ManiaControl Server Controller for ManiaPlanet Server
*
* @author ManiaControl Team <mail@maniacontrol.com>
* @copyright 2014-2020 ManiaControl Team
* @license http://www.gnu.org/licenses/ GNU General Public License, Version 3
*/
class ManiaControl implements CallbackListener, CommandListener, TimerListener, CommunicationListener, UsageInformationAble {
use UsageInformationTrait;
/*
* Constants
*/
const VERSION = '0.256';
const ISTRACKMANIACONTROL = True;
const API_VERSION = '2038-01-19';
const MIN_DEDIVERSION = '2020-07-01_00_00';
const SCRIPT_TIMEOUT = 40;
const URL_WEBSERVICE = 'https://ws.maniacontrol.com/';
const SETTING_PERMISSION_SHUTDOWN = 'Shutdown ManiaControl';
const SETTING_PERMISSION_REBOOT = 'Reboot ManiaControl';
/*
* Public properties
*/
/** @var SettingManager $settingManager
* @see getSettingManager()
* @deprecated use getSettingManager()
*/
public $settingManager = null;
/*
* Private properties
*/
/** @var ActionsMenu $actionsMenu
* @see getActionsMenu()
*/
private $actionsMenu = null;
/** @var AuthenticationManager $authenticationManager
* @see getAuthenticationManager()
*/
private $authenticationManager = null;
/** @var CallbackManager $callbackManager
* @see getCallbackManager()
*/
private $callbackManager = null;
/** @var CallQueueManager $callQueueManager
* @see getCallQueueManager()
*/
private $callQueueManager = null;
/** @var Chat $chat
* @see getChat()
*/
private $chat = null;
/** @var ChangeLog $changeLog
* @see getChangeLog()
*/
private $changeLog = null;
/** @var ColorManager $colorManager
* @see getColorManager()
*/
private $colorManager = null;
/** @var \SimpleXMLElement $config
* @see getConfig()
*/
private $config = null;
/** @var Configurator $configurator
* @see getConfigurator()
*/
private $configurator = null;
/** @var Connection $client
* @see getClient()
*/
private $client = null;
/** @var CommandManager $commandManager
* @see getCommandManager()
*/
private $commandManager = null;
/** @var Database $database
* @see getDatabase()
*/
private $database = null;
/** @var ManialinkManager $manialinkManager
* @see getManialinkManager
*/
private $manialinkManager = null;
/** @var ToggleInterfaceManager $toggleInterfaceManager
* @see getToggleInterfaceManager
*/
private $toggleInterfaceManager = null;
/** @var MapManager $mapManager
* @see getMapManager()
*/
private $mapManager = null;
/** @var PlayerManager $playerManager
* @see getPlayerManager()
*/
private $playerManager = null;
/** @var PluginManager $pluginManager
* @see getPluginManager()
*/
private $pluginManager = null;
/** @var Server $server
* @see getServer()
*/
private $server = null;
/** @var StatisticManager $statisticManager
* @see getStatisticManager()
*/
private $statisticManager = null;
/** @var UpdateManager $updateManager
* @see getUpdateManager()
*/
private $updateManager = null;
/** @var ErrorHandler $errorHandler
* @see getErrorHandler()
*/
private $errorHandler = null;
/** @var TimerManager $timerManager
* @see getTimerManager()
*/
private $timerManager = null;
/** @var AsynchronousFileReader $fileReader
* @see getFileReader()
*/
private $fileReader = null;
/** @var BillManager $billManager
* @see getBillManager()
*/
private $billManager = null;
/** @var EchoManager $echoManager */
private $echoManager = null;
/** @var CommunicationManager $communicationManager */
private $communicationManager = null;
/** @var ModeScriptEventManager $modeScriptEventManager */
private $modeScriptEventManager = null;
private $dedicatedServerBuildVersion = "";
private $requestQuitMessage = null;
private $startTime = -1;
/**
* Construct a new ManiaControl instance
*/
public function __construct() {
Logger::log('Loading ManiaControl v' . self::VERSION . ' ...');
$this->errorHandler = new ErrorHandler($this);
$this->loadConfig();
// Load ManiaControl Modules
$this->callbackManager = new CallbackManager($this);
$this->callQueueManager = new CallQueueManager($this);
$this->modeScriptEventManager = new ModeScriptEventManager($this);
$this->echoManager = new EchoManager($this);
$this->communicationManager = new CommunicationManager($this);
$this->timerManager = new TimerManager($this);
$this->database = new Database($this);
$this->fileReader = new AsynchronousFileReader($this);
$this->billManager = new BillManager($this);
$this->settingManager = new SettingManager($this);
$this->statisticManager = new StatisticManager($this);
$this->manialinkManager = new ManialinkManager($this);
$this->toggleInterfaceManager = new ToggleInterfaceManager($this);
$this->actionsMenu = new ActionsMenu($this);
$this->chat = new Chat($this);
$this->commandManager = new CommandManager($this);
$this->server = new Server($this);
$this->authenticationManager = new AuthenticationManager($this);
$this->playerManager = new PlayerManager($this);
$this->colorManager = new ColorManager($this);
$this->mapManager = new MapManager($this);
$this->configurator = new Configurator($this);
$this->pluginManager = new PluginManager($this);
$this->updateManager = new UpdateManager($this);
$this->changeLog = new ChangeLog($this);
$this->getErrorHandler()->init();
// Permissions
$this->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_SHUTDOWN, AuthenticationManager::AUTH_LEVEL_SUPERADMIN);
$this->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_REBOOT, AuthenticationManager::AUTH_LEVEL_SUPERADMIN);
// Commands
$this->getCommandManager()->registerCommandListener('version', $this, 'commandVersion', false, 'Shows ManiaControl version.');
$this->getCommandManager()->registerCommandListener('reboot', $this, 'commandReboot', true, 'Reboots ManiaControl.');
$this->getCommandManager()->registerCommandListener('restart', $this, 'commandRestart', true, 'Restarts ManiaControl.');
$this->getCommandManager()->registerCommandListener('shutdown', $this, 'commandShutdown', true, 'Shuts ManiaControl down.');
// Check connection every 30 seconds
$this->getTimerManager()->registerTimerListening($this, 'checkConnection', 1000 * 30);
// Communication Methods
$this->getCommunicationManager()->registerCommunicationListener(CommunicationMethods::REBOOT_MANIA_CONTROL, $this, function ($data) {
//Delay Shutdown to send answer first
$this->getTimerManager()->registerOneTimeListening($this, function () use ($data) {
if (is_object($data) && property_exists($data, "message")) {
$this->reboot($data->message);
} else {
$this->reboot();
}
}, 3000);
return new CommunicationAnswer();
});
}
/**
* Load the Config XML-File
*/
private function loadConfig() {
$configId = CommandLineHelper::getParameter('-config');
$configFileName = ($configId ? $configId : 'server.xml');
$config = FileUtil::loadConfig($configFileName);
if (!$config) {
$this->quit("Error loading Configuration XML-File! ('{$configFileName}')", true);
}
if ($config->count() < 3) {
$this->quit("Your Configuration File ('{$configFileName}') doesn't seem to be maintained properly. Please check it again!", true);
}
$this->config = $config;
}
/**
* Quit ManiaControl and log the given message
*
* @param string $message
* @param bool $errorPrefix
*/
public function quit($message = null, $errorPrefix = false) {
if ($this->getClient()) {
if ($this->getCallbackManager()) {
// OnShutdown callback
$this->getCallbackManager()->triggerCallback(Callbacks::ONSHUTDOWN);
}
if ($chat = $this->getChat()) {
// Announce quit
try {
$chat->sendInformation('ManiaControl shutting down.');
} catch (TransportException $e) {
}
}
// Hide UI
try {
$this->getClient()->sendHideManialinkPage();
} catch (TransportException $e) {
}
// Delete client
$this->client = null;
}
SystemUtil::quit($message, $errorPrefix);
}
/**
* Return the client
*
* @return Connection
*/
public function getClient() {
return $this->client;
}
/**
* Return the callback manager
*
* @return CallbackManager
*/
public function getCallbackManager() {
return $this->callbackManager;
}
/**
* Return the call queue manager
*
* @return CallQueueManager
*/
public function getCallQueueManager() {
return $this->callQueueManager;
}
/**
* Return the echo manager
*
* @return EchoManager
*/
public function getEchoManager() {
return $this->echoManager;
}
/**
* Return the socket manager
*
* @return CommunicationManager
*/
public function getCommunicationManager() {
return $this->communicationManager;
}
/**
* Return the chat
*
* @return Chat
*/
public function getChat() {
return $this->chat;
}
/**
* Return the changelog
*
* @return ChangeLog
*/
public function getChangeLog() {
return $this->changeLog;
}
/**
* Return the error handler
*
* @return ErrorHandler
*/
public function getErrorHandler() {
return $this->errorHandler;
}
/**
* Return the authentication manager
*
* @return AuthenticationManager
*/
public function getAuthenticationManager() {
return $this->authenticationManager;
}
/**
* Return the command manager
*
* @return CommandManager
*/
public function getCommandManager() {
return $this->commandManager;
}
/**
* Return the timer manager
*
* @return TimerManager
*/
public function getTimerManager() {
return $this->timerManager;
}
/**
* Print a message to console and log
*
* @param string $message
* @param bool $stripCodes
* @deprecated
* @see Logger::log()
*/
public function log($message, $stripCodes = false) {
Logger::log($message, $stripCodes);
}
/**
* Return the actions menu
*
* @return ActionsMenu
*/
public function getActionsMenu() {
return $this->actionsMenu;
}
/**
* Return the config
*
* @return \SimpleXMLElement
*/
public function getConfig() {
return $this->config;
}
/**
* Return the configurator
*
* @return Configurator
*/
public function getConfigurator() {
return $this->configurator;
}
/**
* Return the database
*
* @return Database
*/
public function getDatabase() {
return $this->database;
}
/**
* Return the manialink manager
*
* @return ManialinkManager
*/
public function getManialinkManager() {
return $this->manialinkManager;
}
/**
* Return the ToggleInterface manager
*
* @return ToggleInterfaceManager
*/
public function getToggleInterfaceManager() {
return $this->toggleInterfaceManager;
}
/**
* Return the map manager
*
* @return MapManager
*/
public function getMapManager() {
return $this->mapManager;
}
/**
* Return the player manager
*
* @return PlayerManager
*/
public function getPlayerManager() {
return $this->playerManager;
}
/**
* Return the color manager
*
* @return ColorManager
*/
public function getColorManager() {
return $this->colorManager;
}
/**
* Return the setting manager
*
* @return SettingManager
*/
public function getSettingManager() {
return $this->settingManager;
}
/**
* Return the statistic manager
*
* @return StatisticManager
*/
public function getStatisticManager() {
return $this->statisticManager;
}
/**
* Return the bill manager
*
* @return BillManager
*/
public function getBillManager() {
return $this->billManager;
}
/**
* @return ModeScriptEventManager
*/
public function getModeScriptEventManager() {
return $this->modeScriptEventManager;
}
/**
* Check connection
*/
public function checkConnection() {
if ($this->getClient()->getIdleTime() > 180) {
$this->getClient()->getServerName();
}
}
/**
* Handle Version Command
*
* @param array $chatCallback
* @param Player $player
*/
public function commandVersion(array $chatCallback, Player $player) {
$message = 'This server is using TrackManiaControl v' . ManiaControl::VERSION . '!';
$this->getChat()->sendInformation($message, $player);
}
/**
* Handle Reboot AdminCommand
*
* @param array $chatCallback
* @param Player $player
*/
public function commandReboot(array $chatCallback, Player $player) {
if (!$this->getAuthenticationManager()->checkPermission($player, self::SETTING_PERMISSION_REBOOT)) {
$this->getAuthenticationManager()->sendNotAllowed($player);
return;
}
$this->reboot("ManiaControl Reboot requested by '{$player->login}'!");
}
/**
* Handle Restart AdminCommand
*
* @param array $chatCallback
* @param Player $player
*/
public function commandRestart(array $chatCallback, Player $player) {
if (!$this->getAuthenticationManager()->checkPermission($player, self::SETTING_PERMISSION_REBOOT)) {
$this->getAuthenticationManager()->sendNotAllowed($player);
return;
}
$message = $this->getChat()->formatMessage(
'The command %s got disabled, reboot ManiaControl with %s instead!',
'//restart',
'//reboot'
);
$this->getChat()->sendError($message, $player);
}
/**
* @deprecated
* Restart ManiaControl
*
* @param string $message
*/
public function restart($message = null) {
$this->reboot($message);
}
/**
* Reboot ManiaControl
*
* @param string $message
*/
public function reboot($message = null) {
// Trigger callback on Reboot
$this->getCallbackManager()->triggerCallback(Callbacks::ONREBOOT);
// Announce reboot
try {
$this->getChat()->sendInformation('Rebooting ManiaControl...', null, true, false);
} catch (TransportException $e) {
}
Logger::log('Rebooting ManiaControl... ' . $message);
// Start new instance
if (!defined('PHP_UNIT_TEST')) {
SystemUtil::reboot();
}
// Quit old instance
$this->quit('Quitting ManiaControl to reboot.');
}
/**
* Handle Shutdown Command
*
* @param array $chat
* @param Player $player
*/
public function commandShutdown(array $chat, Player $player) {
if (!$this->getAuthenticationManager()->checkPermission($player, self::SETTING_PERMISSION_SHUTDOWN)) {
$this->getAuthenticationManager()->sendNotAllowed($player);
return;
}
$this->requestQuit("ManiaControl Shutdown requested by '{$player->login}'!");
}
/**
* Request ManiaControl to quit
*
* @param mixed $message
*/
public function requestQuit($message = true) {
$this->requestQuitMessage = $message;
}
/**
* Run ManiaControl
*
* @param int $runTime Time in Seconds until its terminating (used for PHPUnit Tests)
*/
public function run($runTime = -1) {
Logger::log('Starting ManiaControl v' . self::VERSION . '!');
try {
// Manage SIGTERM signal
if (extension_loaded('pcntl')) {
pcntl_signal(SIGTERM, function() {
$this->quit("Stop signal received from the OS.", false);
});
}
// Connect to server
$this->connect();
// Check if the version of the server is high enough
$version = $this->getClient()->getVersion();
$this->dedicatedServerBuildVersion = $version->build;
if ($this->dedicatedServerBuildVersion < self::MIN_DEDIVERSION) {
$this->quit("The Server has Version '{$this->dedicatedServerBuildVersion}', while at least '" . self::MIN_DEDIVERSION . "' is required!", true);
}
// Listen for shutdown
$this->getCallbackManager()->registerCallbackListener(CallbackManager::CB_MP_SERVERSTOP, $this, 'handleServerStopCallback');
// OnInit callback
$this->getCallbackManager()->triggerCallback(Callbacks::ONINIT);
// Load plugins
$this->getPluginManager()->loadPlugins();
$this->getUpdateManager()->getPluginUpdateManager()->checkPluginsUpdate();
// AfterInit callback
$this->getCallbackManager()->triggerCallback(Callbacks::AFTERINIT);
// Loading finished
Logger::log('Loading completed!');
Logger::log('Link: ' . $this->getServer()->getJoinLink());
$this->getChat()->sendInformation('TrackManiaControl v' . self::VERSION . ' successfully started!');
$this->startTime = time();
// Main loop
while (!$this->requestQuitMessage) {
$this->loop();
//Used for PHPUnit Tests
if ($runTime > 0) {
if (time() > ($this->startTime + $runTime)) {
$this->requestQuit("Run Time Exceeded");
}
}
}
// Shutdown
$this->quit($this->requestQuitMessage);
} catch (TransportException $exception) {
Logger::logError('Connection interrupted!');
$this->getErrorHandler()->handleException($exception);
SystemUtil::quit($exception->getMessage(), true);
}
}
/**
* Connect to ManiaPlanet server
* Public only for PHPUnit Tests
*/
public function connect() {
// Load remote client
$serverConfig = $this->getServer()->loadConfig();
Logger::log("Connecting to Server at {$serverConfig->host}:{$serverConfig->port}...");
try {
$this->client = new Connection($serverConfig->host, $serverConfig->port, self::SCRIPT_TIMEOUT, $serverConfig->user, $serverConfig->pass, self::API_VERSION);
} catch (TransportException $exception) {
$message = "Couldn't connect to the server: '{$exception->getMessage()}'";
$this->quit($message, true);
} catch (AuthenticationException $exception) {
$message = "Couldn't authenticate on Server with User '{$serverConfig->user}' & Pass '{$serverConfig->pass}'! " . $exception->getMessage();
$this->quit($message, true);
}
// Enable callback system
$this->getClient()->enableCallbacks(true);
// Wait for server to be ready
if (!$this->getServer()->waitForStatus(4)) {
$this->quit("Server couldn't get ready!");
}
// Connect finished
Logger::log('Server Connection successfully established!');
// Hide old widgets
$this->getClient()->sendHideManialinkPage();
// Enable script callbacks
$this->getServer()->getScriptManager()->enableScriptCallbacks();
}
/**
* Get The Build Version of the Dedicated Server
*
* @return string
*/
public function getDedicatedServerBuildVersion() {
return $this->dedicatedServerBuildVersion;
}
/**
* Return the server
*
* @return Server
*/
public function getServer() {
return $this->server;
}
/**
* Return the plugin manager
*
* @return PluginManager
*/
public function getPluginManager() {
return $this->pluginManager;
}
/**
* Return the update manager
*
* @return UpdateManager
*/
public function getUpdateManager() {
return $this->updateManager;
}
/**
* Perform the Main Loop
*/
private function loop() {
$loopStart = microtime(true);
//Trigger a Callback on entering the Loop
$this->getCallbackManager()->triggerCallback(Callbacks::PRELOOP, $loopStart);
// Extend script timeout
if (!defined('PHP_UNIT_TEST')) {
set_time_limit(self::SCRIPT_TIMEOUT);
}
// Manage callbacks
$this->getCallbackManager()->manageCallbacks();
// Manage queued calls
$this->getCallQueueManager()->manageCallQueue();
// Manage async file reader
$this->getFileReader()->appendData();
// Yield for next tick
$loopEnd = microtime(true);
$loopDuration = $loopEnd - $loopStart;
$sleepTime = (int) (2500 - $loopDuration * 1000000);
if ($sleepTime > 0) {
usleep($sleepTime);
}
//Trigger a Callback after the Loop
$this->getCallbackManager()->triggerCallback(Callbacks::AFTERLOOP, $loopDuration);
}
/**
* Return the file reader
*
* @return AsynchronousFileReader
*/
public function getFileReader() {
return $this->fileReader;
}
/**
* Handle Server Stop Callback
*/
public function handleServerStopCallback() {
$this->requestQuit('The Server has been shut down!');
}
}