{"id":13435389,"url":"https://github.com/bitrix-expert/monolog-adapter","last_synced_at":"2026-01-23T05:24:01.724Z","repository":{"id":62494672,"uuid":"46681701","full_name":"bitrix-expert/monolog-adapter","owner":"bitrix-expert","description":"Monolog adapter for Bitrix CMS","archived":false,"fork":false,"pushed_at":"2018-05-25T15:21:14.000Z","size":116,"stargazers_count":65,"open_issues_count":5,"forks_count":29,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-06-26T18:31:25.607Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitrix-expert.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-11-22T21:44:25.000Z","updated_at":"2025-04-09T18:23:41.000Z","dependencies_parsed_at":"2022-11-02T11:17:49.396Z","dependency_job_id":null,"html_url":"https://github.com/bitrix-expert/monolog-adapter","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/bitrix-expert/monolog-adapter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrix-expert%2Fmonolog-adapter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrix-expert%2Fmonolog-adapter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrix-expert%2Fmonolog-adapter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrix-expert%2Fmonolog-adapter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitrix-expert","download_url":"https://codeload.github.com/bitrix-expert/monolog-adapter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrix-expert%2Fmonolog-adapter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28680690,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T04:33:33.518Z","status":"ssl_error","status_checked_at":"2026-01-23T04:33:30.433Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T03:00:35.327Z","updated_at":"2026-01-23T05:24:01.702Z","avatar_url":"https://github.com/bitrix-expert.png","language":"PHP","funding_links":[],"categories":["\u003ca id=\"repos-organization\"\u003eGithub, Bitbucket, etc\u003c/a\u003e"],"sub_categories":["Репозитории"],"readme":"# Monolog adapter for Bitrix CMS\n\n[![Build Status](https://travis-ci.org/bitrix-expert/monolog-adapter.svg)](https://travis-ci.org/bitrix-expert/monolog-adapter)\n[![Latest Stable Version](https://poser.pugx.org/bitrix-expert/monolog-adapter/v/stable)](https://packagist.org/packages/bitrix-expert/monolog-adapter) \n[![Total Downloads](https://poser.pugx.org/bitrix-expert/monolog-adapter/downloads)](https://packagist.org/packages/bitrix-expert/monolog-adapter) \n[![License](https://poser.pugx.org/bitrix-expert/monolog-adapter/license)](https://packagist.org/packages/bitrix-expert/monolog-adapter)\n\n[Monolog](https://github.com/Seldaek/monolog) adapter for Bitrix CMS:\n\n* Bitrix handler and formatter for Monolog.\n* Handler for logger uncaught exceptions of the Bitrix.\n* Configuration loggers with using the `.settings.php`.\n\n## Installation\n\nDownload the library using Composer:\n\n```bash\ncomposer require bitrix-expert/monolog-adapter\n```\n\nWrite in the [`init.php`](https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=43\u0026LESSON_ID=2916) file:\n\n```php\n\u003c?php\n\n\\Bex\\Monolog\\MonologAdapter::loadConfiguration();\n```\n\n## Usage\n\n### Configuring your loggers\n\nConfigurate the logger in the `.settings.php`:\n\n```php\nreturn array(\n    'exception_handling' =\u003e array(\n        'value' =\u003e array(\n            'log' =\u003e array(\n                'class_name' =\u003e '\\Bex\\Monolog\\ExceptionHandlerLog',\n                'settings' =\u003e array(\n                    'logger' =\u003e 'app'\n                ),\n            ),\n        ),\n        'readonly' =\u003e false\n    ),\n    'monolog' =\u003e array(\n        'value' =\u003e array(\n            'handlers' =\u003e array(\n                'default' =\u003e array(\n                    'class' =\u003e '\\Monolog\\Handler\\StreamHandler',\n                    'level' =\u003e 'DEBUG',\n                    'stream' =\u003e '/path/to/logs/app.log'\n                ),\n                'feedback_event_log' =\u003e array(\n                    'class' =\u003e '\\Bex\\Monolog\\Handler\\BitrixHandler',\n                    'level' =\u003e 'DEBUG',\n                    'event' =\u003e 'TYPE_FOR_EVENT_LOG',\n                    'module' =\u003e 'vendor.module'\n                ),\n            ),\n            'loggers' =\u003e array(\n                'app' =\u003e array(\n                    'handlers'=\u003e array('default'),\n                ),\n                'feedback' =\u003e array(\n                    'handlers'=\u003e array('feedback_event_log'),\n                )\n            )\n        ),\n        'readonly' =\u003e false\n    )\n);\n```\n\nUse rules property for filter logging uncaught exceptions by instanceof logic:\n```php\n'exception_handling' =\u003e array(\n    'value' =\u003e array(\n        'log' =\u003e array(\n            'class_name' =\u003e '\\Bex\\Monolog\\ExceptionHandlerLog',\n            'settings' =\u003e array(\n                'logger' =\u003e 'app',\n                'rules' =\u003e array(\n                    'instanceof' =\u003e '\\Vendor\\Exception\\UnloggedInterface', // or opposite: !instanceof\n                )\n            ),\n        ),\n    ),\n    'readonly' =\u003e false\n)\n```\n\nUse context property for change log debug data format:\n```php\n'exception_handling' =\u003e array(\n    'value' =\u003e array(\n        'log' =\u003e array(\n            'class_name' =\u003e '\\Bex\\Monolog\\ExceptionHandlerLog',\n            'settings' =\u003e array(\n                'logger' =\u003e 'app',\n                'context' =\u003e function ($exception) {\n                     return array(\n                         'file' =\u003e $exception-\u003egetFile(),\n                         'line' =\u003e $exception-\u003egetLine(),\n                         'trace' =\u003e $exception-\u003egetTrace(),\n                         'some_param' =\u003e $exception-\u003egetSomeParam(),\n                     );\n                 },\n            ),\n        ),\n    ),\n    'readonly' =\u003e false\n)\n```\n\n### Write logs\n\nWrite logs from your application. For example, write logs when created new message from the feedback form:\n\n```php\n\u003c?php\n\nuse Monolog\\Registry;\n\n$logger = Registry::getInstance('feedback');\n\n// Write info message with context: invalid message from feedback\n$logger-\u003einfo('Failed create new message on feedback form', array(\n    'item_id' =\u003e 21,\n    'Invalid data' =\u003e $addResult-\u003egetErrorMessages(), // error savings\n    'Form data' =\u003e $formRequest // data from feedback form\n));\n```\n\nThe result in the Control Panel of Bitrix:\n\n![Event Log](event-log.png)\n\n## Requirements\n\n* PHP \u003e= 5.3\n* Bitrix CMS \u003e= 16.5.6\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitrix-expert%2Fmonolog-adapter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitrix-expert%2Fmonolog-adapter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitrix-expert%2Fmonolog-adapter/lists"}