FM / Handler

/home/techb158/dev.balacoffee.com/vendor/monolog/monolog/src/Monolog/Handler/

/home/techb158/dev.balacoffee.com/vendor/monolog/monolog/src/Monolog/Handler

Name	Size	Mode	Actions
Curl/	-	0755	rm
FingersCrossed/	-	0755	rm
Slack/	-	0755	rm
SyslogUdp/	-	0755	rm
AbstractHandler.php	2651	0644	edit dl rm
AbstractProcessingHandler.php	1914	0644	edit dl rm
AbstractSyslogHandler.php	3540	0644	edit dl rm
AmqpHandler.php	5101	0644	edit dl rm
BrowserConsoleHandler.php	9501	0644	edit dl rm
BufferHandler.php	4644	0644	edit dl rm
ChromePHPHandler.php	5250	0644	edit dl rm
CouchDBHandler.php	2103	0644	edit dl rm
CubeHandler.php	5399	0644	edit dl rm
DeduplicationHandler.php	6063	0644	edit dl rm
DoctrineCouchDBHandler.php	1128	0644	edit dl rm
DynamoDbHandler.php	2482	0644	edit dl rm
ElasticaHandler.php	3328	0644	edit dl rm
ElasticsearchHandler.php	6511	0644	edit dl rm
ErrorLogHandler.php	2587	0644	edit dl rm
FallbackGroupHandler.php	1761	0644	edit dl rm
FilterHandler.php	6863	0644	edit dl rm
FingersCrossedHandler.php	8469	0644	edit dl rm
FirePHPHandler.php	5288	0644	edit dl rm
FleepHookHandler.php	3593	0644	edit dl rm
FlowdockHandler.php	3622	0644	edit dl rm
FormattableHandlerInterface.php	845	0644	edit dl rm
FormattableHandlerTrait.php	1281	0644	edit dl rm
GelfHandler.php	1399	0644	edit dl rm
GroupHandler.php	3234	0644	edit dl rm
Handler.php	1247	0644	edit dl rm
HandlerInterface.php	3032	0644	edit dl rm
HandlerWrapper.php	3358	0644	edit dl rm
IFTTTHandler.php	2183	0644	edit dl rm
InsightOpsHandler.php	2106	0644	edit dl rm
LogEntriesHandler.php	1925	0644	edit dl rm
LogglyHandler.php	4098	0644	edit dl rm
LogmaticHandler.php	2716	0644	edit dl rm
MailHandler.php	2341	0644	edit dl rm
MandrillHandler.php	2473	0644	edit dl rm
MissingExtensionException.php	473	0644	edit dl rm
MongoDBHandler.php	2545	0644	edit dl rm
NativeMailerHandler.php	4971	0644	edit dl rm
NewRelicHandler.php	6211	0644	edit dl rm
NoopHandler.php	880	0644	edit dl rm
NullHandler.php	1337	0644	edit dl rm
OverflowHandler.php	4533	0644	edit dl rm
PHPConsoleHandler.php	10540	0644	edit dl rm
ProcessableHandlerInterface.php	1197	0644	edit dl rm
ProcessableHandlerTrait.php	1737	0644	edit dl rm
ProcessHandler.php	5215	0644	edit dl rm
PsrHandler.php	2440	0644	edit dl rm
PushoverHandler.php	8085	0644	edit dl rm
RedisHandler.php	3020	0644	edit dl rm
RedisPubSubHandler.php	1820	0644	edit dl rm
RollbarHandler.php	3412	0644	edit dl rm
RotatingFileHandler.php	6389	0644	edit dl rm
SamplingHandler.php	4338	0644	edit dl rm
SendGridHandler.php	2871	0644	edit dl rm
SlackHandler.php	7020	0644	edit dl rm
SlackWebhookHandler.php	3923	0644	edit dl rm
SocketHandler.php	12283	0644	edit dl rm
SqsHandler.php	1746	0644	edit dl rm
StreamHandler.php	7062	0644	edit dl rm
SwiftMailerHandler.php	3669	0644	edit dl rm
SymfonyMailerHandler.php	3533	0644	edit dl rm
SyslogHandler.php	1907	0644	edit dl rm
SyslogUdpHandler.php	4497	0644	edit dl rm
TelegramBotHandler.php	8414	0644	edit dl rm
TestHandler.php	6750	0644	edit dl rm
WebRequestRecognizerTrait.php	524	0644	edit dl rm
WhatFailureGroupHandler.php	1949	0644	edit dl rm
ZendMonitorHandler.php	3137	0644	edit dl rm

Edit: /home/techb158/dev.balacoffee.com/vendor/monolog/monolog/src/Monolog/Handler/TelegramBotHandler.php (8414B)

<?php declare(strict_types=1);

/*
 * This file is part of the Monolog package.
 *
 * (c) Jordi Boggiano <j.boggiano@seld.be>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Monolog\Handler;

use RuntimeException;
use Monolog\Logger;
use Monolog\Utils;

/**
 * Handler send logs to Telegram using Telegram Bot API.
 *
 * How to use:
 *  1) Create telegram bot with https://telegram.me/BotFather
 *  2) Create a telegram channel where logs will be recorded.
 *  3) Add created bot from step 1 to the created channel from step 2.
 *
 * Use telegram bot API key from step 1 and channel name with '@' prefix from step 2 to create instance of TelegramBotHandler
 *
 * @link https://core.telegram.org/bots/api
 *
 * @author Mazur Alexandr <alexandrmazur96@gmail.com>
 *
 * @phpstan-import-type Record from \Monolog\Logger
 */
class TelegramBotHandler extends AbstractProcessingHandler
{
    private const BOT_API = 'https://api.telegram.org/bot';

/**
     * The available values of parseMode according to the Telegram api documentation
     */
    private const AVAILABLE_PARSE_MODES = [
        'HTML',
        'MarkdownV2',
        'Markdown', // legacy mode without underline and strikethrough, use MarkdownV2 instead
    ];

/**
     * The maximum number of characters allowed in a message according to the Telegram api documentation
     */
    private const MAX_MESSAGE_LENGTH = 4096;

/**
     * Telegram bot access token provided by BotFather.
     * Create telegram bot with https://telegram.me/BotFather and use access token from it.
     * @var string
     */
    private $apiKey;

/**
     * Telegram channel name.
     * Since to start with '@' symbol as prefix.
     * @var string
     */
    private $channel;

/**
     * The kind of formatting that is used for the message.
     * See available options at https://core.telegram.org/bots/api#formatting-options
     * or in AVAILABLE_PARSE_MODES
     * @var ?string
     */
    private $parseMode;

/**
     * Disables link previews for links in the message.
     * @var ?bool
     */
    private $disableWebPagePreview;

/**
     * Sends the message silently. Users will receive a notification with no sound.
     * @var ?bool
     */
    private $disableNotification;

/**
     * True - split a message longer than MAX_MESSAGE_LENGTH into parts and send in multiple messages.
     * False - truncates a message that is too long.
     * @var bool
     */
    private $splitLongMessages;

/**
     * Adds 1-second delay between sending a split message (according to Telegram API to avoid 429 Too Many Requests).
     * @var bool
     */
    private $delayBetweenMessages;

/**
     * @param string $apiKey Telegram bot access token provided by BotFather
     * @param string $channel Telegram channel name
     * @param bool $splitLongMessages Split a message longer than MAX_MESSAGE_LENGTH into parts and send in multiple messages
     * @param bool $delayBetweenMessages Adds delay between sending a split message according to Telegram API
     * @throws MissingExtensionException
     */
    public function __construct(
        string $apiKey,
        string $channel,
               $level = Logger::DEBUG,
        bool   $bubble = true,
        string $parseMode = null,
        bool   $disableWebPagePreview = null,
        bool   $disableNotification = null,
        bool   $splitLongMessages = false,
        bool   $delayBetweenMessages = false
    )
    {
        if (!extension_loaded('curl')) {
            throw new MissingExtensionException('The curl extension is needed to use the TelegramBotHandler');
        }

parent::__construct($level, $bubble);

$this->apiKey = $apiKey;
        $this->channel = $channel;
        $this->setParseMode($parseMode);
        $this->disableWebPagePreview($disableWebPagePreview);
        $this->disableNotification($disableNotification);
        $this->splitLongMessages($splitLongMessages);
        $this->delayBetweenMessages($delayBetweenMessages);
    }

public function setParseMode(string $parseMode = null): self
    {
        if ($parseMode !== null && !in_array($parseMode, self::AVAILABLE_PARSE_MODES)) {
            throw new \InvalidArgumentException('Unknown parseMode, use one of these: ' . implode(', ', self::AVAILABLE_PARSE_MODES) . '.');
        }

$this->parseMode = $parseMode;

return $this;
    }

public function disableWebPagePreview(bool $disableWebPagePreview = null): self
    {
        $this->disableWebPagePreview = $disableWebPagePreview;

return $this;
    }

public function disableNotification(bool $disableNotification = null): self
    {
        $this->disableNotification = $disableNotification;

return $this;
    }

/**
     * True - split a message longer than MAX_MESSAGE_LENGTH into parts and send in multiple messages.
     * False - truncates a message that is too long.
     * @param bool $splitLongMessages
     * @return $this
     */
    public function splitLongMessages(bool $splitLongMessages = false): self
    {
        $this->splitLongMessages = $splitLongMessages;

return $this;
    }

/**
     * Adds 1-second delay between sending a split message (according to Telegram API to avoid 429 Too Many Requests).
     * @param bool $delayBetweenMessages
     * @return $this
     */
    public function delayBetweenMessages(bool $delayBetweenMessages = false): self
    {
        $this->delayBetweenMessages = $delayBetweenMessages;

return $this;
    }

/**
     * {@inheritDoc}
     */
    public function handleBatch(array $records): void
    {
        /** @var Record[] $messages */
        $messages = [];

foreach ($records as $record) {
            if (!$this->isHandling($record)) {
                continue;
            }

if ($this->processors) {
                /** @var Record $record */
                $record = $this->processRecord($record);
            }

$messages[] = $record;
        }

if (!empty($messages)) {
            $this->send((string)$this->getFormatter()->formatBatch($messages));
        }
    }

/**
     * @inheritDoc
     */
    protected function write(array $record): void
    {
        $this->send($record['formatted']);
    }

/**
     * Send request to @link https://api.telegram.org/bot on SendMessage action.
     * @param string $message
     */
    protected function send(string $message): void
    {
        $messages = $this->handleMessageLength($message);

foreach ($messages as $key => $msg) {
            if ($this->delayBetweenMessages && $key > 0) {
                sleep(1);
            }

$this->sendCurl($msg);
        }
    }

protected function sendCurl(string $message): void
    {
        $ch = curl_init();
        $url = self::BOT_API . $this->apiKey . '/SendMessage';
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
            'text' => $message,
            'chat_id' => $this->channel,
            'parse_mode' => $this->parseMode,
            'disable_web_page_preview' => $this->disableWebPagePreview,
            'disable_notification' => $this->disableNotification,
        ]));

$result = Curl\Util::execute($ch);
        if (!is_string($result)) {
            throw new RuntimeException('Telegram API error. Description: No response');
        }
        $result = json_decode($result, true);

if ($result['ok'] === false) {
            throw new RuntimeException('Telegram API error. Description: ' . $result['description']);
        }
    }

/**
     * Handle a message that is too long: truncates or splits into several
     * @param string $message
     * @return string[]
     */
    private function handleMessageLength(string $message): array
    {
        $truncatedMarker = ' (...truncated)';
        if (!$this->splitLongMessages && strlen($message) > self::MAX_MESSAGE_LENGTH) {
            return [Utils::substr($message, 0, self::MAX_MESSAGE_LENGTH - strlen($truncatedMarker)) . $truncatedMarker];
        }

return str_split($message, self::MAX_MESSAGE_LENGTH);
    }
}

cmd: