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

ActiveTypo3-cms-extension[Logging & Monitoring](/categories/logging)

networkteam/sentry-client
=========================

A Sentry client for TYPO3. It forwards errors and exceptions to Sentry - https://sentry.io/

5.2.1(1y ago)371.0M—8.3%37[4 PRs](https://github.com/networkteam/sentry_client/pulls)3GPL-2.0-or-laterPHPPHP ^8.0CI failing

Since Feb 7Pushed 1y ago7 watchersCompare

[ Source](https://github.com/networkteam/sentry_client)[ Packagist](https://packagist.org/packages/networkteam/sentry-client)[ Docs](https://networkteam.com)[ RSS](/packages/networkteam-sentry-client/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (36)Used By (3)

Sentry Client for TYPO3
=======================

[](#sentry-client-for-typo3)

[![ci](https://github.com/networkteam/sentry_client/actions/workflows/ci.yml/badge.svg)](https://github.com/networkteam/sentry_client/actions/workflows/ci.yml/badge.svg)[![Latest release on GitHub](https://camo.githubusercontent.com/7f17c27b5fe66444e27911ff1ae4c165fb9c27b6aac666b3370ebfb16a8eae3c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e6574776f726b7465616d2f73656e7472795f636c69656e743f6c6f676f3d676974687562)](https://camo.githubusercontent.com/7f17c27b5fe66444e27911ff1ae4c165fb9c27b6aac666b3370ebfb16a8eae3c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e6574776f726b7465616d2f73656e7472795f636c69656e743f6c6f676f3d676974687562)[![Downloads per month](https://camo.githubusercontent.com/ac197be41ee9e2ce9c04ad3a0effc7688b28aad26ca4de4992df9c9e4272d204/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6e6574776f726b7465616d2f73656e7472792d636c69656e743f7374796c653d706c6173746963)](https://camo.githubusercontent.com/ac197be41ee9e2ce9c04ad3a0effc7688b28aad26ca4de4992df9c9e4272d204/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6e6574776f726b7465616d2f73656e7472792d636c69656e743f7374796c653d706c6173746963)

TYPO3 logs error messages and exceptions to logfiles and the backend log module. This extension sends them to [Sentry](https://sentry.io/), a SaaS/self-hosted application which aggregates them and informs you by mail. In Sentry you see a error messages with additional information like stacktrace, HTTP headers and submitted request/form data.

Technical decisions
-------------------

[](#technical-decisions)

Exceptions through database outages (imagine a mysql server restart) should not be reported, so the db connection is checked before. Exceptions may be excluded via regexp on their message (won't fix this error => exclude it). TYPO3 throws a lot of PHP Notices and they are not really interesting in production, they are excluded by default.

Installation
------------

[](#installation)

```
$ composer require networkteam/sentry-client
```

The [TER version](https://typo3.org/extensions/repository/view/sentry_client) will not receive updates anymore. Feel free to send us a crate of beer and we will make a new TER release.

Configuration
-------------

[](#configuration)

**File: system/settings.php or system/additional.php**

Register the exception handlers.

```
$GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'] = Networkteam\SentryClient\ProductionExceptionHandler::class;
$GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'] = Networkteam\SentryClient\DebugExceptionHandler::class;
```

The DebugExceptionHandler is also used in production environment when `SYS/displayErrors` is enabled and your IP matches `SYS/devIPmask`.

Optional: Forward non-exceptional errors to Sentry, that normally are logged only. Consider using LogLevel::WARN

```
$GLOBALS['TYPO3_CONF_VARS']['LOG']['writerConfiguration'] = [
    \TYPO3\CMS\Core\Log\LogLevel::ERROR => [
        \Networkteam\SentryClient\SentryLogWriter::class => [],
    ],
];
```

Optional: Set sentry/sentry options ()

```
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['sentry_client']['options']['server_name'] = 'web3';
```

### Environment variables

[](#environment-variables)

Since Sentry SDK 2.x there are [environment variables](https://docs.sentry.io/platforms/php/configuration/options/#common-options) which can be used, for example in a .htaccess file:

```
SetEnv SENTRY_DSN http://public_key@your-sentry-server.com/project-id
SetEnv SENTRY_RELEASE 1.0.7
SetEnv SENTRY_ENVIRONMENT Staging

```

### Feature Toggles

[](#feature-toggles)

- Ignore database connection errors (they should better be handled by a monitoring system)
- Report user information: Select one of `none` | `userid`
- Ignore exception message regular expression
- Ignore LogWriter Components

How to test if the extension works?
-----------------------------------

[](#how-to-test-if-the-extension-works)

```
page = PAGE
page.20 = USER
page.20 {
  userFunc = Networkteam\SentryClient\Client->captureException
}
```

This triggers an error that will be reported.

### Request ID

[](#request-id)

If the web server has set a request ID header `X-Request-Id`, this is transmitted as a tag to trace errors to logs.

Issue tracker
-------------

[](#issue-tracker)

This extension is managed on GitHub. Feel free to get in touch at [https://github.com/networkteam/sentry\_client](https://github.com/networkteam/sentry_client)

Help
----

[](#help)

There is a Slack channel #ext-sentry\_client

Changelog
---------

[](#changelog)

### 5.1.0

[](#510)

- Use sentry/sentry ^4.6

### 5.0.0

[](#500)

- New option "disableDatabaseLogging": When enabled, exceptions are not written to database table sys\_log
- Introduce Sentry Integrations
- Allow passing sentry/sentry options via `EXTCONF`
- Ignore exceptions, that are ignore in TYPO3 core
- Use `sentry/sentry` instead of `sentry/sdk` (Thanks to @derhansen)
- !!! Option "logWriterLogLevel" removed. LogWriter needs to be configured in `system/additional.php`
- !!! Option "messageBlacklistRegex" renamed to "ignoreMessageRegex"
- !!! Option "logWriterComponentBlacklist" renamed to "logWriterComponentIgnorelist"
- !!! The old option names still work
- !!! Drop support for TYPO3 v10
- !!! Drop support for non-composer usage

### 4.2.0

[](#420)

- Add log message interpolation (Thanks to @sascha-egerer)
- Add Fingerprint to log messages
- Deprecated: Usage of DebugExceptionHandler

### 4.1.0

[](#410)

- Client IP is anonymized with `IpAnonymizationUtility::anonymizeIp()`. Thanks to @extcode
- Add `X-Request-Id` as tag. Thanks to @bergo
- Small code optimizations. Thanks to @tlueder and @LeoniePhiline

### 4.0.0

[](#400)

- Add stacktrace to LogWriter messages for message grouping in Sentry
- Add LogWriter component ignorelist
- Add v11.5 support
- Drop v9.5 support

### 3.0..3.1

[](#3031)

- Add experimental LogWriter
- Remove setting activatePageNotFoundHandling
- Ignore PageNotFoundException by default
- Support TYPO3 proxy setting
- Use sentry/sdk:3.1

### 2.0..3.0

[](#2030)

- Use sentry/sdk:2.0
- Remove setting productionOnly
- Remove setting reportWithDevIP
- Rename setting activatePageNotFoundHandlingActive to activatePageNotFoundHandling
- Report E\_ALL ^ E\_NOTICE
- Strip project root
- Show event id in FE

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance48

Moderate activity, may be stable

Popularity53

Moderate usage in the ecosystem

Community34

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 56% 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 ~101 days

Recently: every ~108 days

Total

27

Last Release

383d ago

Major Versions

1.4.1 → 2.0.02018-09-27

2.1.1 → 3.0.02019-12-22

3.1.0 → 4.0.02021-10-18

4.3.0 → 5.0.02023-09-13

### Community

Maintainers

![](https://www.gravatar.com/avatar/790179df9a15d9175b9ec8fdc2df5c4c660a52a4fb6d429376cf66b66b0a595c?d=identicon)[chlu](/maintainers/chlu)

![](https://www.gravatar.com/avatar/8e2a03e451b8ad5281ca437e00e44b1a50752d576afaba66db97d503beab31f2?d=identicon)[christophlehmann](/maintainers/christophlehmann)

![](https://www.gravatar.com/avatar/7cbf52f8dce27737b73b79ac2c958434339f3dcf704b17a040956ed9a33eb4ef?d=identicon)[networkteam](/maintainers/networkteam)

---

Top Contributors

[![christophlehmann](https://avatars.githubusercontent.com/u/4953689?v=4)](https://github.com/christophlehmann "christophlehmann (42 commits)")[![derhansen](https://avatars.githubusercontent.com/u/2629896?v=4)](https://github.com/derhansen "derhansen (7 commits)")[![ger4003](https://avatars.githubusercontent.com/u/1758522?v=4)](https://github.com/ger4003 "ger4003 (5 commits)")[![susannemoog](https://avatars.githubusercontent.com/u/321804?v=4)](https://github.com/susannemoog "susannemoog (3 commits)")[![cweiske](https://avatars.githubusercontent.com/u/59036?v=4)](https://github.com/cweiske "cweiske (3 commits)")[![peterkraume](https://avatars.githubusercontent.com/u/4234704?v=4)](https://github.com/peterkraume "peterkraume (2 commits)")[![brotkrueml](https://avatars.githubusercontent.com/u/2566282?v=4)](https://github.com/brotkrueml "brotkrueml (2 commits)")[![bmack](https://avatars.githubusercontent.com/u/165630?v=4)](https://github.com/bmack "bmack (2 commits)")[![achimfritz](https://avatars.githubusercontent.com/u/2152991?v=4)](https://github.com/achimfritz "achimfritz (2 commits)")[![tlueder](https://avatars.githubusercontent.com/u/5957131?v=4)](https://github.com/tlueder "tlueder (1 commits)")[![bergo](https://avatars.githubusercontent.com/u/619785?v=4)](https://github.com/bergo "bergo (1 commits)")[![extcode](https://avatars.githubusercontent.com/u/1134172?v=4)](https://github.com/extcode "extcode (1 commits)")[![jrenggli](https://avatars.githubusercontent.com/u/743094?v=4)](https://github.com/jrenggli "jrenggli (1 commits)")[![LeoniePhiline](https://avatars.githubusercontent.com/u/22329650?v=4)](https://github.com/LeoniePhiline "LeoniePhiline (1 commits)")[![sascha-egerer](https://avatars.githubusercontent.com/u/1651414?v=4)](https://github.com/sascha-egerer "sascha-egerer (1 commits)")[![abeutel](https://avatars.githubusercontent.com/u/434679?v=4)](https://github.com/abeutel "abeutel (1 commits)")

---

Tags

phpsentrysentry-clienttypo3typo3-extensionmonitoringsentryextensiontypo3

### Embed Badge

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

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

###  Alternatives

[pagemachine/typo3-formlog

Form log for TYPO3

23225.3k6](/packages/pagemachine-typo3-formlog)[typo3/testing-framework

The TYPO3 testing framework provides base classes for unit, functional and acceptance testing.

675.0M775](/packages/typo3-testing-framework)[mito/yii2-sentry

Yii 2 extension for Sentry

92377.7k](/packages/mito-yii2-sentry)[leuchtfeuer/locate

Locate - The users country, preferred language and other facts will be detected. Depending on configurable rules the user can be redirected to other languages or pages. Locate also provides geo blocking for configurable pages in configurable countries.

1182.8k](/packages/leuchtfeuer-locate)[netresearch/contexts

Multi-channel content visibility for TYPO3 - by Netresearch

1117.4k1](/packages/netresearch-contexts)[leuchtfeuer/secure-downloads

"Secure Download": Apply TYPO3 access rights to ALL file assets (PDFs, TGZs or JPGs etc. - configurable) - protect them from direct access.

22234.7k1](/packages/leuchtfeuer-secure-downloads)

PHPackages © 2026

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