PHPackages victor78/yii2-messenger-target - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. victor78/yii2-messenger-target ActiveYii2-extension[Logging & Monitoring](/categories/logging) victor78/yii2-messenger-target ============================== The log target for any messenger. 0.0.5(8y ago)068MITPHPPHP >=7.0 Since Apr 29Pushed 8y ago1 watchersCompare [ Source](https://github.com/victor78/Yii2MessengerTarget)[ Packagist](https://packagist.org/packages/victor78/yii2-messenger-target)[ RSS](/packages/victor78-yii2-messenger-target/feed)WikiDiscussions master Synced yesterday READMEChangelogDependencies (3)Versions (6)Used By (0) Yii2MessengerTarget =================== [](#yii2messengertarget) MessengerTarget for Yii2 for sending logs as text and/or as files (of which archives) through messengers. Now this extension supports as messenger only Telegram. MessengerTarget для Yii2 для отправки логов как текст и/или как файлы(в том числе как архивы) через месенджеры. Сейчас расширение поддерживает в качестве месседжера только Телеграм. **English**: - [Installation](#installation) - [Configuration](#configuration) - [How to create telegram bot](#how-to-create-telegram-bot) - [How to take telegram chat id which will receive messages from the bot](#how-to-take-telegram-chat-id-which-will-receive-messages-from-the-bot) - [How to use](#how-to-use) - [Notes](#notes) **Русский**: - [Установка](https://github.com/victor78/Yii2MessengerTarget#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0) - [Настройка](https://github.com/victor78/Yii2MessengerTarget#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0) - [Как создать телеграм бота](https://github.com/victor78/Yii2MessengerTarget#%D0%9A%D0%B0%D0%BA-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D1%82%D1%8C-%D1%82%D0%B5%D0%BB%D0%B5%D0%B3%D1%80%D0%B0%D0%BC-%D0%B1%D0%BE%D1%82%D0%B0) - [Как получить id чата (id пользователя), который будет получать сообщения от бота](https://github.com/victor78/Yii2MessengerTarget#%D0%9A%D0%B0%D0%BA-%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-id-%D1%87%D0%B0%D1%82%D0%B0-id-%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8F-%D0%BA%D0%BE%D1%82%D0%BE%D1%80%D1%8B%D0%B9-%D0%B1%D1%83%D0%B4%D0%B5%D1%82-%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B0%D1%82%D1%8C-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F-%D0%BE%D1%82-%D0%B1%D0%BE%D1%82%D0%B0) - [Как использовать](https://github.com/victor78/Yii2MessengerTarget#%D0%9A%D0%B0%D0%BA-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D1%8C) - [Замечания](https://github.com/victor78/Yii2MessengerTarget#%D0%97%D0%B0%D0%BC%D0%B5%D1%87%D0%B0%D0%BD%D0%B8%D1%8F) Installation ------------ [](#installation) The preferred way to install this extension is through [composer](http://getcomposer.org/download/). Either run ``` php composer.phar require --prefer-dist victor78/yii2-messenger-target:"~0.0.4" ``` or add ``` "victor78/yii2-messenger-target": "~0.0.4" ``` to the require section of your composer.json. Configuration ------------- [](#configuration) ``` return [ 'components' => [ 'telegramPusher' => [ 'class' => 'Victor78\MessengerTarget\TelegramPusher', 'recipients' => [ //any element is not required //all messages of levels and categories will be received by these users: '*' => [ 'telegram_chat_id_0', //for example, user_id 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //messages which initiated by Yii::error('some message') or Yii::info('some message', 'error') //or during catching ErrorException //will be sent to these chats 'error' => [ 'telegram_chat_id_0', //for example, user_id 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //messages which initiated by Yii::warning('some message') or Yii::info('some message', 'warning') //will be sent to these chats 'warning' => [ 'telegram_chat_id_0', //for example, user_id 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //messages which initiated by Yii::debug('some message') or Yii::info('some message', 'trace') //will be sent to these chats 'trace' => [ 'telegram_chat_id_0', //for example, user_id 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //messages initiated by //Yii::info('info message', 'some_category_1') or //Yii::debug('trace message', 'some_category_1') or //Yii::warning('warning message', 'some_category_1') or //Yii::error('error message', 'some_category_1') //will be sent to these chats 'some_category_1' => [ 'telegram_chat_id_0', //for example, user_id 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //messages initiated by //Yii::info('info message', 'some_category_2') or //Yii::debug('trace message', 'some_category_2') or //Yii::warning('warning message', 'some_category_2') or //Yii::error('error message', 'some_category_2') //will be sent to these chats 'some_category_2' => [ 'telegram_chat_id_0', //for example, user_id 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], ], // level or category accroding to telegram bot through 'tokens' => [ //all elements are optional //'some_level_or_category' => 'telegram_bot_api_token' 'info' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'error' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'warning' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'trace' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'some_category_1' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'some_categiry_2' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', ], ] ], //.... 'log' => [ 'targets' => [ [ //SPECIFIC OPTIONS for Yii2MessengerTarget //required properties 'class' => 'Victor78\MessengerTarget\MessengerTarget', //required 'messenger' => 'telegramPusher', //name of configured component //optional 'archiverMethod' => 'zip', // default 'zip', also '7zip', 'tar', '.tar.gz', '.tar.bz2' 'enableArchiving' => true, //default true; set false to disable archiving of sending files 'password7zip' => 'password12345', //optional, only with type '7zip' 'viewBothInOneAs' => false, //false is default, choice 'file' or 'text' - if you want glue text and context (global PHP vars) and send it by one message ('text') or one file ('file'). // if viewBothInOneAs = false, you can choice view of text and context 'viewMessageAs' => 'text', //also 'file' and false 'viewContextAs' => 'file', //also 'text' and false //also if you want you can use your own archiver, which implements Victor78\Zipper\ZipperInterface 'archiver' => function(){ return new Some\Namespace\SomeArchiver(); }, //USUAL OPTIONS for log target //for example 'categories' => [ 'yii\db\*', 'yii\web\HttpException:*', ], 'levels' => ['error', 'warning', 'trace', 'info'], 'except' => [ 'yii\web\HttpException:404', ], 'logVars' => ['_SERVER'], ] ] ] ]; ``` ### How to create telegram bot [](#how-to-create-telegram-bot) 1. Message @botfather with the following text: `/newbot`If you don't know how to message by username, click the search field on your Telegram app and type `@botfather`, where you should be able to initiate a conversation. Be careful not to send it to the wrong contact, because some users has similar usernames to `botfather`. [![botfather initial conversation](https://camo.githubusercontent.com/c41f7100347d9e629a4d3211d836fcd02d749ddd2cc329a8d83c088f517ceca2/687474703a2f2f692e696d6775722e636f6d2f614932366978522e706e67)](https://camo.githubusercontent.com/c41f7100347d9e629a4d3211d836fcd02d749ddd2cc329a8d83c088f517ceca2/687474703a2f2f692e696d6775722e636f6d2f614932366978522e706e67) 2. @botfather replies with `Alright, a new bot. How are we going to call it? Please choose a name for your bot.` 3. Type whatever name you want for your bot. 4. @botfather replies with `Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.` 5. Type whatever username you want for your bot, minimum 5 characters, and must end with `bot`. For example: `telesample_bot` 6. @botfather replies with: ``` Done! Congratulations on your new bot. You will find it at telegram.me/telesample_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. Use this token to access the HTTP API: 123456789:AAG90e14-0f8-40183D-18491dDE For a description of the Bot API, see this page: https://core.telegram.org/bots/api ``` 7. Note down the 'token' mentioned above. 8. Type `/setprivacy` to @botfather. [![botfather later conversation](https://camo.githubusercontent.com/f5c5019b8512280ea872002f6b5a076207640b0568c40d8cafdf8de60a7658d2/687474703a2f2f692e696d6775722e636f6d2f745744567668342e706e67)](https://camo.githubusercontent.com/f5c5019b8512280ea872002f6b5a076207640b0568c40d8cafdf8de60a7658d2/687474703a2f2f692e696d6775722e636f6d2f745744567668342e706e67) 9. @botfather replies with `Choose a bot to change group messages settings.` 10. Type (or select) `@telesample_bot` (change to the username you set at step 5 above, but start it with `@`) 11. @botfather replies with ``` 'Enable' - your bot will only receive messages that either start with the '/' symbol or mention the bot by username. 'Disable' - your bot will receive all messages that people send to groups. Current status is: ENABLED ``` 12. Type (or select) `Disable` to let your bot receive all messages sent to a group. This step is up to you actually. 13. @botfather replies with `Success! The new status is: DISABLED. /help` ### How to take telegram chat id which will receive messages from the bot [](#how-to-take-telegram-chat-id-which-will-receive-messages-from-the-bot) Send the /my\_id to telegram bot @get\_id\_bot or use the [instruction](https://core.telegram.org/bots#deep-linking-example). How to use ---------- [](#how-to-use) It is enough to configure component right, and it will work. To test yout configuration, add it, for example, to some controller: ``` Yii::info('INFO MESSAGE'); Yii::debug('DEBUG MESSAGE'); Yii::warning('WARNING MESSAGE'); Yii::error('ERROR MESSAGE'); //also you can try create catching of Exception, for example: 1/0; ``` Notes ----- [](#notes) For archiving MessengerTarget use [yii2-zipper](https://github.com/victor78/yii2-zipper). - For zip type Zipper try to use console command zip or php zip extension, so one of them is required on server for zipping. - For tar, tar.gz, tar.bz2 Zipper try to use GNU tar and BSD tar, so one ofo them is required on server for these ways of arching. - For zipping by 7zip, the 7za utiliy is required on server. Установка --------- [](#установка) Предпочтительный способ установки расширения через [composer](http://getcomposer.org/download/). Либо запуск из консоли ``` php composer.phar require --prefer-dist victor78/yii2-messenger-target:"~0.0.4" ``` либо в composer.json в секции required ``` "victor78/yii2-messenger-target": "~0.0.4" ``` Настройка --------- [](#настройка) ``` return [ 'components' => [ 'telegramPusher' => [ 'class' => 'Victor78\MessengerTarget\TelegramPusher', 'recipients' => [ //не один элемент не является обязательным, но необходим хотя бы один //все сообщения будут отправлены в следующие чаты: '*' => [ 'telegram_chat_id_0', //id чата, например, id пользователя 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //сообщения которые инициированы Yii::error('some message') or Yii::info('some message', 'error') //или во время отлавливания исключения будет отправлены в данные чаты 'error' => [ 'telegram_chat_id_0', //id чата, например, id пользователя 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //сообщения, которые инициированы Yii::warning('some message') или Yii::info('some message', 'warning') //будут отправлены в следующие чаты 'warning' => [ 'telegram_chat_id_0', //id чата, например, id пользователя 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //сообщения, инициированные Yii::debug('some message') или Yii::info('some message', 'trace') //будут отправлены в следующие чаты 'trace' => [ 'telegram_chat_id_0', //id чата, например, id пользователя 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //сообщения, инициированные //Yii::info('info message', 'some_category_1') или //Yii::debug('trace message', 'some_category_1') или //Yii::warning('warning message', 'some_category_1') или //Yii::error('error message', 'some_category_1') // будут отправлены в данные чаты 'some_category_1' => [ 'telegram_chat_id_0', //id чата, например, id пользователя 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], //сообщения, инициированные //Yii::info('info message', 'some_category_1') или //Yii::debug('trace message', 'some_category_1') или //Yii::warning('warning message', 'some_category_1') или //Yii::error('error message', 'some_category_1') // будут отправлены в данные чаты 'some_category_2' => [ 'telegram_chat_id_0', //id чата, например, id пользователя 'telegram_chat_id_1', //... 'telegram_chat_id_N', ], ], // уровень или категория и соответствующий ей токен телеграм бота 'tokens' => [ //все элементы опциональны //'some_level_or_category' => 'telegram_bot_api_token' 'info' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'error' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'warning' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'trace' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'some_category_1' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'some_categiry_2' => 'NNNNNNNNN:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', ], ] ], //.... 'log' => [ 'targets' => [ [ //СПЕЦИФИЧЕСКИЕ для Yii2MessengerTarget ОПЦИИ //обязательные свойства 'class' => 'Victor78\MessengerTarget\MessengerTarget', 'messenger' => 'telegramPusher', //имя сконфигурированного компонента мессенджера //необязательные свойства 'archiverMethod' => 'zip', // по умолчанию 'zip', also '7zip', 'tar', '.tar.gz', '.tar.bz2' 'enableArchiving' => true, //по умолчанию true; установить false для отключения архивации отправляемых файлов 'password7zip' => 'password12345', //опционально, работает только с типом '7zip' 'viewBothInOneAs' => false, //false по умолчанию, выбрать 'file' или 'text' если хотите объединить текст и контекст (глобальные переменные PHP) и отправить их одним сообщением ('text') или одним файлом ('file'). // если viewBothInOneAs = false, вы можете выбрать вид текста и контекста 'viewMessageAs' => 'text', //ещё можно выбрать 'file' или false 'viewContextAs' => 'file', //ещё можно выбрать 'text' или false //При необходимости вы можете использовать свой архиватор, который реализует Victor78\Zipper\ZipperInterface 'archiver' => function(){ return new Some\Namespace\SomeArchiver(); }, //ОБЫЧНЫЕ ОПЦИИ для log target //любые обычные опции, например 'categories' => [ 'yii\db\*', 'yii\web\HttpException:*', ], 'levels' => ['error', 'warning', 'trace', 'info'], 'except' => [ 'yii\web\HttpException:404', ], 'logVars' => ['_SERVER'], ] ] ] ]; ``` ### Как создать телеграм бота [](#как-создать-телеграм-бота) 1. Напишите боту @botfather следующий текст (команду): `/newbot`Если вы не в курсе как отправить сообщение пользователю по его username, кликните по поиску вашего приложения Телеграм и наберите `@botfather`, где вы получите возможность начать переписку с данным пользователем (в данном случае - ботом). Будьте внимательны, поскольку некоторые пользователи используют схожий c `botfather` username. [![botfather initial conversation](https://camo.githubusercontent.com/c41f7100347d9e629a4d3211d836fcd02d749ddd2cc329a8d83c088f517ceca2/687474703a2f2f692e696d6775722e636f6d2f614932366978522e706e67)](https://camo.githubusercontent.com/c41f7100347d9e629a4d3211d836fcd02d749ddd2cc329a8d83c088f517ceca2/687474703a2f2f692e696d6775722e636f6d2f614932366978522e706e67) 2. @botfather ответит `Alright, a new bot. How are we going to call it? Please choose a name for your bot.` 3. Отправьте сообщение с именем бота в ответ. 4. @botfather ответит `Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.` 5. Отправьте в ответе username для бота - оно должно быть длинее 5 символов, заканчиваться на `bot`. Например: `telesample_bot` 6. @botfather ответит: ``` Done! Congratulations on your new bot. You will find it at telegram.me/telesample_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. Use this token to access the HTTP API: 123456789:AAG90e14-0f8-40183D-18491dDE For a description of the Bot API, see this page: https://core.telegram.org/bots/api ``` 7. Сохраните токен. 8. Отправьте боту @botfather сообщение `/setprivacy`. [![botfather later conversation](https://camo.githubusercontent.com/f5c5019b8512280ea872002f6b5a076207640b0568c40d8cafdf8de60a7658d2/687474703a2f2f692e696d6775722e636f6d2f745744567668342e706e67)](https://camo.githubusercontent.com/f5c5019b8512280ea872002f6b5a076207640b0568c40d8cafdf8de60a7658d2/687474703a2f2f692e696d6775722e636f6d2f745744567668342e706e67) 9. @botfather ответит `Choose a bot to change group messages settings.` 10. Наберите (или выберите) вашего бота `@telesample_bot` (выберите по username вашего бота) 11. @botfather ответит ``` 'Enable' - your bot will only receive messages that either start with the '/' symbol or mention the bot by username. 'Disable' - your bot will receive all messages that people send to groups. Current status is: ENABLED ``` 12. Наберите (или выберите) `Disable` чтобы позволить вашему боту работать у группах. 13. @botfather ответит `Success! The new status is: DISABLED. /help` ### Как получить id чата (id пользователя), который будет получать сообщения от бота [](#как-получить-id-чата-id-пользователя-который-будет-получать-сообщения-от-бота) Отправьте `/my_id` телеграм боту `@get_id_bot` или используйте [инструкцию](https://core.telegram.org/bots#deep-linking-example). Как использовать ---------------- [](#как-использовать) Достаточно настроить компонент верно, и логирование через мессенджер будет работать. Протестировать верно ли настроено логирование можно добавив следующий код, например, в контроллер: ``` Yii::info('INFO MESSAGE'); Yii::debug('DEBUG MESSAGE'); Yii::warning('WARNING MESSAGE'); Yii::error('ERROR MESSAGE'); //также можно можно инициировать исключение, например: 1/0; ``` Замечания --------- [](#замечания) Для архивации файлов MessengerTarget использует [yii2-zipper](https://github.com/victor78/yii2-zipper). - Для архивирования в чистый zip используется утилита zip или расширение PHP для zip, так что или утилита, или расширение должны быть установлены на сервере для упавки и разупаковки zip. - Для tar, tar.gz, tar.bz2 Zipper пытается использовать GNU tar или BSD tar, один из них должен быть установлен на сервере для этих типов архивов. - Для упаковки/разупаковки zip при помощи 7zip, на сервере должа быть установлена утилита 7za. ### Health Score 24 — LowBetter than 31% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community7 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 5 Last Release 2975d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/11695079?v=4)[Victor 78](/maintainers/victor78)[@victor78](https://github.com/victor78) --- Top Contributors [![victor78](https://avatars.githubusercontent.com/u/11695079?v=4)](https://github.com/victor78 "victor78 (10 commits)") --- Tags logyii2extensionyiiyii 2targetVictor78messenger logarchive logzip logtar logtar.gz logtelegramloglog telegram ### Embed Badge ![Health badge](/badges/victor78-yii2-messenger-target/health.svg) ``` [![Health](https://phpackages.com/badges/victor78-yii2-messenger-target/health.svg)](https://phpackages.com/packages/victor78-yii2-messenger-target) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)