telegram-bot-php / core

src/lib/Entities/InlineKeyboardButton.php

Indentation +37 added lines, -37 removed lines

@@ -35,49 +35,49 @@
 class InlineKeyboardButton extends KeyboardButton
 {
 
-	/**
-	 * Creates instance of InlineKeyboardButton
-	 *
-	 * @param string $string
-	 * @return InlineKeyboardButton
-	 */
-	public static function make(string $string): InlineKeyboardButton
-	{
-		return new self($string);
-	}
+    /**
+     * Creates instance of InlineKeyboardButton
+     *
+     * @param string $string
+     * @return InlineKeyboardButton
+     */
+    public static function make(string $string): InlineKeyboardButton
+    {
+        return new self($string);
+    }
 
-	/**
-	 * @param string $data
-	 * @return $this
-	 */
-	public function CallbackData(string $data): InlineKeyboardButton
-	{
-		$this->raw_data['callback_data'] = $data;
+    /**
+     * @param string $data
+     * @return $this
+     */
+    public function CallbackData(string $data): InlineKeyboardButton
+    {
+        $this->raw_data['callback_data'] = $data;
 
-		return $this;
-	}
+        return $this;
+    }
 
-	/**
-	 * @param string $data
-	 * @return $this
-	 */
-	public function Url(string $data): InlineKeyboardButton
-	{
-		$this->raw_data['url'] = $data;
+    /**
+     * @param string $data
+     * @return $this
+     */
+    public function Url(string $data): InlineKeyboardButton
+    {
+        $this->raw_data['url'] = $data;
 
-		return $this;
-	}
+        return $this;
+    }
 
-	/**
-	 * @param string $url
-	 * @return $this
-	 */
-	public function WebApp(string $url): KeyboardButton
-	{
-		$this->raw_data['web_app'] = new WebAppInfo(['url' => $url]);
+    /**
+     * @param string $url
+     * @return $this
+     */
+    public function WebApp(string $url): KeyboardButton
+    {
+        $this->raw_data['web_app'] = new WebAppInfo(['url' => $url]);
 
-		return $this;
-	}
+        return $this;
+    }
 
     /**
      * Check if the passed data array could be an InlineKeyboardButton.

src/lib/Util/CrossData.php

Indentation +29 added lines, -29 removed lines

@@ -12,37 +12,37 @@
 class CrossData
 {
 
-	/**
-	 * get CrossData
-	 *
-	 * @param string $key
-	 * @return string|array|bool|null
-	 */
-	public static function get(string $key): string|array|bool|null
-	{
-		$data = json_decode(getenv('TG_CROSS_DATA'), true);
-		$block = 'TG_CROSS_DATA' . $key;
+    /**
+     * get CrossData
+     *
+     * @param string $key
+     * @return string|array|bool|null
+     */
+    public static function get(string $key): string|array|bool|null
+    {
+        $data = json_decode(getenv('TG_CROSS_DATA'), true);
+        $block = 'TG_CROSS_DATA' . $key;
 
-		if (!isset($data[$key])) {
-			return null;
-		}
+        if (!isset($data[$key])) {
+            return null;
+        }
 
-		return getenv($data[$block]);
-	}
+        return getenv($data[$block]);
+    }
 
-	/**
-	 * put CrossData
-	 *
-	 * @param string $key
-	 * @param mixed $value
-	 * @return void
-	 */
-	public static function put(string $key, mixed $value): void
-	{
-		$data = json_decode(getenv('TG_CROSS_DATA'), true);
-		$data[$key] = 'TG_CROSS_DATA_' . $key;
-		putenv($data[$key] . '=' . $value);
-		putenv(json_encode($data));
-	}
+    /**
+     * put CrossData
+     *
+     * @param string $key
+     * @param mixed $value
+     * @return void
+     */
+    public static function put(string $key, mixed $value): void
+    {
+        $data = json_decode(getenv('TG_CROSS_DATA'), true);
+        $data[$key] = 'TG_CROSS_DATA_' . $key;
+        putenv($data[$key] . '=' . $value);
+        putenv(json_encode($data));
+    }
 
 }
\ No newline at end of file

src/lib/WebhookHandler.php

Indentation +240 added lines, -240 removed lines

@@ -18,245 +18,245 @@
 abstract class WebhookHandler extends Telegram
 {
 
-	/**
-	 * @var ?Update
-	 */
-	protected ?Update $update;
-
-	/**
-	 * @var array<Plugin>
-	 */
-	private array $plugins = [];
-
-	/**
-	 * @var bool
-	 */
-	private bool $isActive = false;
-
-	/**
-	 * The default configuration of the webhook.
-	 *
-	 * @var array
-	 */
-	private array $config = [
-		'autoload_env_file' => false,
-		'env_file_path' => null,
-	];
-
-	/**
-	 * Webhook constructor.
-	 *
-	 * @param string $api_key The API key of the bot. Leave it blank for autoload from .env file.
-	 */
-	public function __construct(string $api_key = '')
-	{
-		parent::__construct($api_key);
-
-		if (!Telegram::validateToken(self::getApiKey())) {
-			throw new InvalidBotTokenException();
-		}
-	}
-
-	/**
-	 * Initialize the receiver.
-	 *
-	 * @return void
-	 */
-	public function init(): void
-	{
-		$this->config['env_file_path'] = $_SERVER['DOCUMENT_ROOT'] . '/.env';
-	}
-
-	/**
-	 * Add a plugin to the receiver
-	 *
-	 * @param array<Plugin> $plugins
-	 */
-	public function addPlugin(array $plugins): void
-	{
-		foreach ($plugins as $plugin) {
-			if (!is_subclass_of($plugin, Plugin::class)) {
-				throw new \RuntimeException(
-					sprintf('The plugin %s must be an instance of %s', get_class($plugin), Plugin::class)
-				);
-			}
-			$this->plugins[] = $plugin;
-		}
-	}
-
-	/**
-	 * Match the update with the given plugins
-	 *
-	 * @param array<Plugin> $plugins
-	 * @param ?Update $update The update to match
-	 * @return void
-	 */
-	public function loadPluginsWith(array $plugins, Update $update = null): void
-	{
-		$update = $update ?? ($this->update ?? Telegram::getUpdate());
-
-		foreach ($plugins as $plugin) {
-			if (!is_subclass_of($plugin, Plugin::class)) {
-				throw new \InvalidArgumentException(
-					sprintf('The plugin %s must be an instance of %s', get_class($plugin), Plugin::class)
-				);
-			}
-		}
-
-		if ($update instanceof Update) {
-			$this->spreadUpdateWith($update, $plugins);
-		}
-	}
-
-	/**
-	 * Match the message to the plugins
-	 *
-	 * @param ?Update $update The update to match
-	 * @return void
-	 */
-	public function loadPlugins(Update $update = null): void
-	{
-		$update = $update ?? ($this->update ?? Telegram::getUpdate());
-		$this->loadPluginsWith($this->plugins, $update);
-	}
-
-	/**
-	 * Load the environment's
-	 *
-	 * @param string $path
-	 * @retrun void
-	 */
-	public function loadFileOfEnv(string $path): void
-	{
-		DotEnv::load($path);
-	}
-
-	/**
-	 * Update the configuration
-	 *
-	 * @param array $configuration
-	 * @return void
-	 */
-	public function updateConfiguration(array $configuration): void
-	{
-		$this->config = array_merge($this->config, $configuration);
-	}
-
-	/**
-	 * Resolve the request.
-	 *
-	 * @param ?Update $update The custom to work with
-	 * @param array $config The configuration of the receiver
-	 *
-	 * @retrun void
-	 */
-	public function resolve(Update $update = null, array $config = []): void
-	{
-		$method = '__process';
-		if (!method_exists($this, $method)) {
-			throw new \RuntimeException(sprintf('The method %s does not exist', $method));
-		}
-
-		if (is_array($config)) $this->updateConfiguration($config);
-
-		if (!empty($update)) $this->update = $update;
-		else $this->update = Telegram::getUpdate() !== false ? Telegram::getUpdate() : null;
-
-		if (empty($this->update)) {
-			TelegramLog::error(
-				'The update is empty, the request is not processed'
-			);
-			return;
-		}
-
-		try {
-
-			Common::arrest($this, $method, $this->update);
-
-		} catch (\RuntimeException $exception) {
-
-			$e = $exception->getPrevious();
-			TelegramLog::error(($message = sprintf(
-				'%s(%d): %s\n%s', $e->getFile(), $e->getLine(), $e->getMessage(), $e->getTraceAsString()
-			)));
-
-			if (defined('TG_ADMIN_ID') && TG_ADMIN_ID && defined('DEBUG_MODE') && DEBUG_MODE) {
-				file_put_contents(
-					($file = getcwd() . '/' . uniqid('error_') . '.log'),
-					$message . PHP_EOL . PHP_EOL . $update->getRawData(false)
-				);
-				Request::sendMessage([
-					'chat_id' => TG_ADMIN_ID,
-					'text' => $message,
-				]);
-				Request::sendDocument([
-					'chat_id' => TG_ADMIN_ID,
-					'document' => $file,
-				]);
-				unlink($file);
-			}
-		}
-	}
-
-	/**
-	 * This function will get update and spread it to the plugins
-	 *
-	 * @param Update $update
-	 * @param array<Plugin> $plugins
-	 * @return void
-	 */
-	private function spreadUpdateWith(Update $update, array $plugins): void
-	{
-		$this->isActive = true;
-
-		foreach ($plugins as $plugin) {
-			/** @var Plugin $plugin */
-			(new $plugin())->__execute($this, $update);
-			if ($this->isActive === false) break;
-		}
-
-		$this->isActive = false;
-	}
-
-	/**
-	 * Kill the speeding process
-	 *
-	 * @return void
-	 */
-	public function kill(): void
-	{
-		$this->isActive = false;
-	}
-
-	/**
-	 * Use this method on the webhook class to get the updates
-	 *
-	 * @param Update $update
-	 * @return void
-	 */
-	abstract public function __process(Update $update): void;
-
-	/**
-	 * put CrossData into the plugins
-	 *
-	 * @param string $key
-	 * @param mixed $value
-	 * @return void
-	 */
-	public function putCrossData(string $key, mixed $value): void
-	{
-		CrossData::put($key, $value);
-	}
-
-	/**
-	 * get CrossData from the plugins
-	 *
-	 * @param string $key
-	 * @return string|array|bool|null
-	 */
-	public function getCrossData(string $key): string|array|bool|null
-	{
-		return CrossData::get($key);
-	}
+    /**
+     * @var ?Update
+     */
+    protected ?Update $update;
+
+    /**
+     * @var array<Plugin>
+     */
+    private array $plugins = [];
+
+    /**
+     * @var bool
+     */
+    private bool $isActive = false;
+
+    /**
+     * The default configuration of the webhook.
+     *
+     * @var array
+     */
+    private array $config = [
+        'autoload_env_file' => false,
+        'env_file_path' => null,
+    ];
+
+    /**
+     * Webhook constructor.
+     *
+     * @param string $api_key The API key of the bot. Leave it blank for autoload from .env file.
+     */
+    public function __construct(string $api_key = '')
+    {
+        parent::__construct($api_key);
+
+        if (!Telegram::validateToken(self::getApiKey())) {
+            throw new InvalidBotTokenException();
+        }
+    }
+
+    /**
+     * Initialize the receiver.
+     *
+     * @return void
+     */
+    public function init(): void
+    {
+        $this->config['env_file_path'] = $_SERVER['DOCUMENT_ROOT'] . '/.env';
+    }
+
+    /**
+     * Add a plugin to the receiver
+     *
+     * @param array<Plugin> $plugins
+     */
+    public function addPlugin(array $plugins): void
+    {
+        foreach ($plugins as $plugin) {
+            if (!is_subclass_of($plugin, Plugin::class)) {
+                throw new \RuntimeException(
+                    sprintf('The plugin %s must be an instance of %s', get_class($plugin), Plugin::class)
+                );
+            }
+            $this->plugins[] = $plugin;
+        }
+    }
+
+    /**
+     * Match the update with the given plugins
+     *
+     * @param array<Plugin> $plugins
+     * @param ?Update $update The update to match
+     * @return void
+     */
+    public function loadPluginsWith(array $plugins, Update $update = null): void
+    {
+        $update = $update ?? ($this->update ?? Telegram::getUpdate());
+
+        foreach ($plugins as $plugin) {
+            if (!is_subclass_of($plugin, Plugin::class)) {
+                throw new \InvalidArgumentException(
+                    sprintf('The plugin %s must be an instance of %s', get_class($plugin), Plugin::class)
+                );
+            }
+        }
+
+        if ($update instanceof Update) {
+            $this->spreadUpdateWith($update, $plugins);
+        }
+    }
+
+    /**
+     * Match the message to the plugins
+     *
+     * @param ?Update $update The update to match
+     * @return void
+     */
+    public function loadPlugins(Update $update = null): void
+    {
+        $update = $update ?? ($this->update ?? Telegram::getUpdate());
+        $this->loadPluginsWith($this->plugins, $update);
+    }
+
+    /**
+     * Load the environment's
+     *
+     * @param string $path
+     * @retrun void
+     */
+    public function loadFileOfEnv(string $path): void
+    {
+        DotEnv::load($path);
+    }
+
+    /**
+     * Update the configuration
+     *
+     * @param array $configuration
+     * @return void
+     */
+    public function updateConfiguration(array $configuration): void
+    {
+        $this->config = array_merge($this->config, $configuration);
+    }
+
+    /**
+     * Resolve the request.
+     *
+     * @param ?Update $update The custom to work with
+     * @param array $config The configuration of the receiver
+     *
+     * @retrun void
+     */
+    public function resolve(Update $update = null, array $config = []): void
+    {
+        $method = '__process';
+        if (!method_exists($this, $method)) {
+            throw new \RuntimeException(sprintf('The method %s does not exist', $method));
+        }
+
+        if (is_array($config)) $this->updateConfiguration($config);
+
+        if (!empty($update)) $this->update = $update;
+        else $this->update = Telegram::getUpdate() !== false ? Telegram::getUpdate() : null;
+
+        if (empty($this->update)) {
+            TelegramLog::error(
+                'The update is empty, the request is not processed'
+            );
+            return;
+        }
+
+        try {
+
+            Common::arrest($this, $method, $this->update);
+
+        } catch (\RuntimeException $exception) {
+
+            $e = $exception->getPrevious();
+            TelegramLog::error(($message = sprintf(
+                '%s(%d): %s\n%s', $e->getFile(), $e->getLine(), $e->getMessage(), $e->getTraceAsString()
+            )));
+
+            if (defined('TG_ADMIN_ID') && TG_ADMIN_ID && defined('DEBUG_MODE') && DEBUG_MODE) {
+                file_put_contents(
+                    ($file = getcwd() . '/' . uniqid('error_') . '.log'),
+                    $message . PHP_EOL . PHP_EOL . $update->getRawData(false)
+                );
+                Request::sendMessage([
+                    'chat_id' => TG_ADMIN_ID,
+                    'text' => $message,
+                ]);
+                Request::sendDocument([
+                    'chat_id' => TG_ADMIN_ID,
+                    'document' => $file,
+                ]);
+                unlink($file);
+            }
+        }
+    }
+
+    /**
+     * This function will get update and spread it to the plugins
+     *
+     * @param Update $update
+     * @param array<Plugin> $plugins
+     * @return void
+     */
+    private function spreadUpdateWith(Update $update, array $plugins): void
+    {
+        $this->isActive = true;
+
+        foreach ($plugins as $plugin) {
+            /** @var Plugin $plugin */
+            (new $plugin())->__execute($this, $update);
+            if ($this->isActive === false) break;
+        }
+
+        $this->isActive = false;
+    }
+
+    /**
+     * Kill the speeding process
+     *
+     * @return void
+     */
+    public function kill(): void
+    {
+        $this->isActive = false;
+    }
+
+    /**
+     * Use this method on the webhook class to get the updates
+     *
+     * @param Update $update
+     * @return void
+     */
+    abstract public function __process(Update $update): void;
+
+    /**
+     * put CrossData into the plugins
+     *
+     * @param string $key
+     * @param mixed $value
+     * @return void
+     */
+    public function putCrossData(string $key, mixed $value): void
+    {
+        CrossData::put($key, $value);
+    }
+
+    /**
+     * get CrossData from the plugins
+     *
+     * @param string $key
+     * @return string|array|bool|null
+     */
+    public function getCrossData(string $key): string|array|bool|null
+    {
+        return CrossData::get($key);
+    }
 
 }
\ No newline at end of file

src/lib/Plugin.php

Indentation +124 added lines, -124 removed lines

@@ -15,129 +15,129 @@
 class Plugin
 {
 
-	/**
-	 * The Update types
-	 *
-	 * @var array
-	 */
-	protected array $update_types = [
-		'Message',
-		'EditedMessage',
-		'ChannelPost',
-		'EditedChannelPost',
-		'InlineQuery',
-		'ChosenInlineResult',
-		'CallbackQuery',
-		'ShippingQuery',
-		'PreCheckoutQuery',
-	];
-
-	/**
-	 * @var WebhookHandler
-	 */
-	protected WebhookHandler $hook;
-
-	/**
-	 * @var \Generator
-	 */
-	protected \Generator $returns;
-
-	/**
-	 * @var bool
-	 */
-	protected bool $kill_on_yield = false;
-
-	/**
-	 * Check for the exit of the plugin.
-	 *
-	 * @param \Generator $return
-	 * @return void
-	 */
-	public function __checkExit(\Generator $return): void
-	{
-		if ($return->valid()) {
-			if ($return->current() !== null && $this->kill_on_yield === true) {
-				$this->kill();
-			}
-		}
-
-		if ($return->valid()) {
-			$return->next();
-			$this->__checkExit($return);
-		}
-	}
-
-	/**
-	 * Identify the update type. e.g. Message, EditedMessage, etc.
-	 *
-	 * @param Update $update
-	 * @return string|null
-	 */
-	public function __identify(Update $update): ?string
-	{
-		$type = $update->getUpdateType();
-
-		if ($type === null) {
-			return null;
-		}
-
-		return str_replace('_', '', ucwords($type, '_'));
-	}
-
-	/**
-	 * Execute the plugin.
-	 *
-	 * @param WebhookHandler $receiver
-	 * @param Update $update
-	 * @return void
-	 */
-	public function __execute(WebhookHandler $receiver, Update $update): void
-	{
-		$this->hook = $receiver;
-
-		if (method_exists($this, 'onReceivedUpdate')) {
-			$return = $this->onReceivedUpdate($update);
-			$this->__checkExit($return);
-		}
-
-		$type = $this->__identify($update);
-		if (method_exists($this, ($method = 'on' . $type)) && $type !== null) {
-			$return = $this->$method($update);
-			$this->__checkExit($return);
-		}
-	}
-
-	/**
-	 * Kill the plugin.
-	 *
-	 * @return void
-	 */
-	public function kill(): void
-	{
-		$this->hook->kill();
-	}
-
-	/**
-	 * put CrossData into the plugins
-	 *
-	 * @param string $key
-	 * @param mixed $value
-	 * @return void
-	 */
-	public function putCrossData(string $key, mixed $value): void
-	{
-		CrossData::put($key, $value);
-	}
-
-	/**
-	 * get CrossData from the plugins
-	 *
-	 * @param string $key
-	 * @return string|array|bool|null
-	 */
-	public function getCrossData(string $key): string|array|bool|null
-	{
-		return CrossData::get($key);
-	}
+    /**
+     * The Update types
+     *
+     * @var array
+     */
+    protected array $update_types = [
+        'Message',
+        'EditedMessage',
+        'ChannelPost',
+        'EditedChannelPost',
+        'InlineQuery',
+        'ChosenInlineResult',
+        'CallbackQuery',
+        'ShippingQuery',
+        'PreCheckoutQuery',
+    ];
+
+    /**
+     * @var WebhookHandler
+     */
+    protected WebhookHandler $hook;
+
+    /**
+     * @var \Generator
+     */
+    protected \Generator $returns;
+
+    /**
+     * @var bool
+     */
+    protected bool $kill_on_yield = false;
+
+    /**
+     * Check for the exit of the plugin.
+     *
+     * @param \Generator $return
+     * @return void
+     */
+    public function __checkExit(\Generator $return): void
+    {
+        if ($return->valid()) {
+            if ($return->current() !== null && $this->kill_on_yield === true) {
+                $this->kill();
+            }
+        }
+
+        if ($return->valid()) {
+            $return->next();
+            $this->__checkExit($return);
+        }
+    }
+
+    /**
+     * Identify the update type. e.g. Message, EditedMessage, etc.
+     *
+     * @param Update $update
+     * @return string|null
+     */
+    public function __identify(Update $update): ?string
+    {
+        $type = $update->getUpdateType();
+
+        if ($type === null) {
+            return null;
+        }
+
+        return str_replace('_', '', ucwords($type, '_'));
+    }
+
+    /**
+     * Execute the plugin.
+     *
+     * @param WebhookHandler $receiver
+     * @param Update $update
+     * @return void
+     */
+    public function __execute(WebhookHandler $receiver, Update $update): void
+    {
+        $this->hook = $receiver;
+
+        if (method_exists($this, 'onReceivedUpdate')) {
+            $return = $this->onReceivedUpdate($update);
+            $this->__checkExit($return);
+        }
+
+        $type = $this->__identify($update);
+        if (method_exists($this, ($method = 'on' . $type)) && $type !== null) {
+            $return = $this->$method($update);
+            $this->__checkExit($return);
+        }
+    }
+
+    /**
+     * Kill the plugin.
+     *
+     * @return void
+     */
+    public function kill(): void
+    {
+        $this->hook->kill();
+    }
+
+    /**
+     * put CrossData into the plugins
+     *
+     * @param string $key
+     * @param mixed $value
+     * @return void
+     */
+    public function putCrossData(string $key, mixed $value): void
+    {
+        CrossData::put($key, $value);
+    }
+
+    /**
+     * get CrossData from the plugins
+     *
+     * @param string $key
+     * @return string|array|bool|null
+     */
+    public function getCrossData(string $key): string|array|bool|null
+    {
+        return CrossData::get($key);
+    }
 
 }
\ No newline at end of file