PHPackages                             webpractik/sentry - 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. webpractik/sentry

ActiveLibrary[Logging & Monitoring](/categories/logging)

webpractik/sentry
=================

Module sending logs to sentry

v2.1.4(1y ago)208.8k↓50%5MITPHPPHP >=7.2

Since Jul 5Pushed 1y agoCompare

[ Source](https://github.com/webpractik/webpractik.sentry)[ Packagist](https://packagist.org/packages/webpractik/sentry)[ RSS](/packages/webpractik-sentry/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (11)Used By (0)

webpractik.sentry
=================

[](#webpractiksentry)

Описание
--------

[](#описание)

Модуль для отправки PHP ошибок Bitrix в Sentry
Класс модуля отнаследован от Bitrix\\Main\\Diag\\FileExceptionHandlerLog

Требования
----------

[](#требования)

- Composer
- Версия PHP >= 7.2

Установка
---------

[](#установка)

Установка пакета

```
composer require webpractik/sentry
```

Настройка
---------

[](#настройка)

### Подключение composer autoload

[](#подключение-composer-autoload)

В файле `init.php` требуется подключить composer autoload, если этого еще не сделано

```
require_once($_SERVER['DOCUMENT_ROOT'] . '/vendor/autoload.php');
```

### Определение переменных

[](#определение-переменных)

Для установки окружения и URL sentry в .env файле нужно определить две переменные:

```
APP_ENV=production
SENTRY_DSN=https://@sentry.io/
```

> Чтобы при разработке на локальной версии сайта ошибки не отправлялись в Sentry, нужно в переменной APP\_ENV указать значение 'local'. На production-сервер должно быть установлено 'production'

### Получение переменных из .env файла

[](#получение-переменных-из-env-файла)

Вместе с пакетом зависимостью устанавливается библиотека `vlucas/phpdotenv`, посредством которой можно получить переменные из `.env` (по умолчанию) файла

Для этого в `init.php` нужно прописать:

```
if (class_exists('Dotenv\\Dotenv')) {
    $env = Dotenv\Dotenv::createImmutable($_SERVER['DOCUMENT_ROOT']);
    // Если на проекте используется другое имя файла, его можно задать вторым параметром
    // пример, $env = Dotenv\Dotenv::createImmutable($_SERVER['DOCUMENT_ROOT'], '.environment');
    try {
        $env->load();
    } catch (InvalidFileException | InvalidPathException $e) {
    }
}
```

В метод `createImmutable` нужно указать путь к файлу .env (или .environment)

> В примере указана проверка на существование класса Dotenv, чтобы при первом деплое на production-сервер не вызвать ошибку (пока не отработает composer install)

**Если у вас уже установлен Laravel**, то может возникнуть ошибка конфликта версий пакета `vlucas/phpdotenv`, проверьте что установили подходящий.
Подключение для старой (^3.3) версии пакета тоже отличается:

```
if (class_exists('Dotenv\\Dotenv')) {
    $env = Dotenv\Dotenv::create($_SERVER['DOCUMENT_ROOT']); // изменение тут, в старой версии нет метода createImmutable
    // Если на проекте используется другое имя файла, его можно задать вторым параметром
    // пример, $env = Dotenv\Dotenv::create($_SERVER['DOCUMENT_ROOT'], '.environment');
    try {
        $env->load();
    } catch (InvalidFileException | InvalidPathException $e) {
    }
}
```

### Настройка Bitrix

[](#настройка-bitrix)

Чтобы наш обработчик перехватывал ошибки, нужно его прописать в файле `bitrix/.settings.php`, в секцию
`[exception_handling][value][log]`

```
'class_name' => '\\Webpractik\\Sentry\\SentryException'

```

Например:

```
'exception_handling' =>
    array (
        'value' =>
            array (
                'debug' => ,
                'handled_errors_types' => ,
                'exception_errors_types' => ,
                'ignore_silence' => ,
                'assertion_throws_exception' => ,
                'assertion_error_type' => ,
                'log' =>
                    array (
                        'settings' =>
                            array (
                                'file' => '/error.log',
                                'log_size' => ,
                            ),
                        'class_name' => '\\Webpractik\\Sentry\\SentryException',
                    ),
            ),
        'readonly' => ,
    ),

```

Миграция с версии 1.0
---------------------

[](#миграция-с-версии-10)

1. Удалить ключи `extension` и `required_file` из файла `bitrix/.settings.php`
2. В `class_name` изменить класс на `'\\Webpractik\\Sentry\\SentryException'`
3. Деактивировать и удалить модуль в админ панели
4. В файле `composer.json` изменить версию пакета `webpractik/sentry` на ^2.0
5. Выполнить в консоли `composer update webpractik/sentry`
6. Сбросить кеш загрузчика composer, если возникнут ошибки `composer dump-autoload`

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 81.3% 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 ~207 days

Recently: every ~335 days

Total

10

Last Release

644d ago

Major Versions

v1.0 → v2.0.02020-03-19

PHP version history (2 changes)v2.0.0PHP >=7.1

v2.1.0PHP >=7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/c141e494b1e0e011a6ff59fce1807616886ee906e9fbdb581811920e0bde5e8c?d=identicon)[webpractik](/maintainers/webpractik)

---

Top Contributors

[![varrcan](https://avatars.githubusercontent.com/u/23196073?v=4)](https://github.com/varrcan "varrcan (13 commits)")[![mnlght](https://avatars.githubusercontent.com/u/34452808?v=4)](https://github.com/mnlght "mnlght (3 commits)")

---

Tags

bitrixsentrylogbitrixsentry

### Embed Badge

![Health badge](/badges/webpractik-sentry/health.svg)

```
[![Health](https://phpackages.com/badges/webpractik-sentry/health.svg)](https://phpackages.com/packages/webpractik-sentry)
```

###  Alternatives

[sentry/sentry

PHP SDK for Sentry (http://sentry.io)

1.9k227.1M273](/packages/sentry-sentry)[sentry/sentry-laravel

Laravel SDK for Sentry (https://sentry.io)

1.3k114.3M154](/packages/sentry-sentry-laravel)[sentry/sdk

This is a meta package of sentry/sentry. We recommend using sentry/sentry directly.

328134.8M151](/packages/sentry-sdk)[phptek/sentry

Sentry.io integration for SilverStripe. Binds Sentry.io to SilverStripe's error & exception handling subsystem.

15203.5k3](/packages/phptek-sentry)[bitrix-expert/monolog-adapter

Monolog adapter for Bitrix CMS

6566.3k](/packages/bitrix-expert-monolog-adapter)[facile-it/sentry-module

This module allows integration of Sentry Client into laminas and mezzio

19372.5k](/packages/facile-it-sentry-module)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)