PHPackages                             m12/flow-rollbar - 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. m12/flow-rollbar

ActiveNeos-package[Logging & Monitoring](/categories/logging)

m12/flow-rollbar
================

Rollbar.com error reporting for Flow/Neos projects

v0.3.1(9y ago)62.4k1[1 issues](https://github.com/million12/Flow.Plugin.Rollbar/issues)MITPHP

Since Oct 20Pushed 7y ago1 watchersCompare

[ Source](https://github.com/million12/Flow.Plugin.Rollbar)[ Packagist](https://packagist.org/packages/m12/flow-rollbar)[ RSS](/packages/m12-flow-rollbar/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (4)Dependencies (4)Versions (5)Used By (0)

Rollbar.com error reporting inside Flow/Neos
============================================

[](#rollbarcom-error-reporting-inside-flowneos)

Report errors and unhandled exceptions to [Rollbar.com](https://rollbar.com/)service in your [Flow/Neos](https://www.neos.io/) project.

It is especially useful on Production environment, where you don't want to have any exceptions or errors unnoticed.

Features
========

[](#features)

- Error and exception logging:
    - on server-side (PHP, both web requests and CLI requests)
    - on front-end (JS) for public site and Neos admin areas (content module and all other modules, like Media, Workspaces etc)
- Enabled by default for Production only, can be enabled for Development too.
- Sending environment and currently authenticated account identifier, if present.
- Tested with Flow 3.3, Neos 2.3 and PHP 7.0 (should work on PHP 5.6 up).

Installation
============

[](#installation)

Install it with composer:

```
composer require m12/flow-rollbar

```

Configuration
=============

[](#configuration)

Configure your settings in `Configuration/Settings.yaml`. You can disable Rollbar error reporting for front-end JavaScript or enable/disable it for prod/dev environement.

The following are the **defaults**:

```
M12:
  Rollbar:
    # Enables Rollbar reporting for Production context
    enableForProduction: true
    # Enables Rollbar reporting for Development context
    enableForDevelopment: false

    # Enables Rollbar on the front-end, in the browser
    # @see rollbarJsSettings below
    enableForFrontend: true

    # Server-side configuration
    #
    # You can add here any setting option described in rollbar-php
    # docs: https://github.com/rollbar/rollbar-php
    #
    # Note: the `root`, `environment` and `person_fn` options are automatically filled.
    rollbarSettings:
      access_token: your POST_SERVER_ITEM access token here
      batch_size: 10

    # Front-end side configuration
    #
    # You can add here any option available in
    # https://rollbar.com/docs/notifier/rollbar.js/ .
    #
    # Note: the `payload.environment` and `payload.person` options are automatically filled.
    rollbarJsSettings:
      accessToken: your POST_CLIENT_ITEM access token here
      captureUncaught: true
      captureUnhandledRejections: true
      payload: {}

    # Path to Rollbar html/js template
    templatePath: 'resource://M12.Rollbar/Private/Templates/Rollbar.html'

    # Assuming FLOW_CONTEXT contains sub-context, should it be sent in the `environment` key?
    # When set to false *and* sub-context *is* present, whole FLOW_CONTEXT will be sent as a separate metadata.
    includeSubContextInEnvironment: false

```

Server-side error reporting
---------------------------

[](#server-side-error-reporting)

Configure it in `rollbarSettings`. You'll need at least provide the API access token app (the `post_server_item` from your Rollbar app) to `rollbarSettings.access_token`. You can add here any setting option described in rollbar-php doc: .

Frontend (javascript) error reporting
-------------------------------------

[](#frontend-javascript-error-reporting)

Configure it in `rollbarJsSettings`. At least `accessToken` value needs to be provided (the `post_client_item` from your Rollbar app). You can add here any setting option described in rollbar JS doc: .

### Neos

[](#neos)

Frontend integration in Neos works out-of-the box, both for the public site and all Neos CMS admin areas (content module and other sub-modules, i.e. Media, History etc).

To enable Rollbar **only** on Neos CMS admin panel, you could add the following line to your .ts code:

```
prototype(TYPO3.Neos:Page) {
	head {
		rollbar = TYPO3.TypoScript:Template {
			@if.onlyRenderWhenNotInLiveWorkspace = ${node.context.workspace.name != 'live'}
		}
	}
}

```

**Note**: the implementation of front-end side of things can be a bit tricky. Views are configured to override Neos' `Default.html` layout to render Rollbar config and JS snippet on all Neos back-end (sub)modules. Beware of that if you have overridden the default Neos layout it in your setup. Apart of that, we have a bit of .ts code (automatically included) to add Rollbar snippet to the page HEAD section, both when in Neos content module or in live site.

### Flow

[](#flow)

Front-end integration requires adding a Rollbar snippet to your template (or perhaps layout, so it's shared amongst all different views).

Add Rollbar snippet to your front-end layout code using `` tag. Remember to add `rollbar` namespace at the very top of the file.

Rollbar recommends adding it at the very top of the HEAD section, at least before any other .js code. Your code could look something like that:

```
{namespace rollbar=M12\Rollbar\ViewHelpers}

	...

```

Authors
=======

[](#authors)

Author: Marcin Ryzycki ()

License
=======

[](#license)

MIT

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70.8% 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 ~1 days

Total

4

Last Release

3536d ago

### Community

Maintainers

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

---

Top Contributors

[![ryzy](https://avatars.githubusercontent.com/u/994940?v=4)](https://github.com/ryzy "ryzy (17 commits)")[![kdambekalns](https://avatars.githubusercontent.com/u/95873?v=4)](https://github.com/kdambekalns "kdambekalns (7 commits)")

### Embed Badge

![Health badge](/badges/m12-flow-rollbar/health.svg)

```
[![Health](https://phpackages.com/badges/m12-flow-rollbar/health.svg)](https://phpackages.com/packages/m12-flow-rollbar)
```

###  Alternatives

[rollbar/rollbar-laravel

Rollbar error monitoring integration for Laravel projects

14410.9M10](/packages/rollbar-rollbar-laravel)[jenssegers/rollbar

Rollbar error monitoring integration for Laravel projects

3301.1M2](/packages/jenssegers-rollbar)[rollbar/rollbar-php-symfony-bundle

Bundle for Symfony that integrates Rollbar tracker

291.4M](/packages/rollbar-rollbar-php-symfony-bundle)[baibaratsky/yii2-rollbar

Rollbar for Yii2

36133.0k](/packages/baibaratsky-yii2-rollbar)[neos/media

The Media package

101.2M53](/packages/neos-media)

PHPackages © 2026

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