PHPackages                             netlogix/errorhandler - 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. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. netlogix/errorhandler

ActiveNeos-package[Debugging &amp; Profiling](/categories/debugging)

netlogix/errorhandler
=====================

5.4.0(8mo ago)118.5k↓35.7%[1 PRs](https://github.com/netlogix/Netlogix.ErrorHandler/pulls)MITPHPPHP ^7.3 || ^8.0

Since Aug 13Pushed 8mo ago4 watchersCompare

[ Source](https://github.com/netlogix/Netlogix.ErrorHandler)[ Packagist](https://packagist.org/packages/netlogix/errorhandler)[ RSS](/packages/netlogix-errorhandler/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (27)Used By (0)

Netlogix ErrorHandler for Neos
==============================

[](#netlogix-errorhandler-for-neos)

This package allows you to generate static error pages by using the content of Neos pages. These static files will be used for error handling in Flow &amp; Neos depending on their configuration.

You can also use these files as ErrorDocument in your webserver.

Install package
---------------

[](#install-package)

`composer require netlogix/errorhandler`

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

[](#configuration)

### Option 1: Add error pages manually as document nodes.

[](#option-1-add-error-pages-manually-as-document-nodes)

Create a custom document node, which uses the `Netlogix.ErrorHandler.NodeTypes:Mixin.ErrorPage` mixin.

Every child page of this error page as well as child pages of siblings of this error age are covered by this error page.

Every error counts for its exact dimension and for the error codes configured within that page node.

A dynamic error page is omitted, if no error code is assigned.

There still needs to be a storage folder where cached error pages will be placed.

```
Netlogix:
  ErrorHandler:

    # File path where this error page should be saved to. Available variables are `site`, `dimensions` and `node`.
    destination: '${"/var/www/default/" + site + "/" + dimensions + "/" + node + ".html"}'
```

### Option 2: Provide error pages via yaml

[](#option-2-provide-error-pages-via-yaml)

Provide configuration for every site and status code you need:

```
Netlogix:
  ErrorHandler:
    pages:
      # siteNodeName of all Sites that you want to generate error pages for

      'my-site-without-dimensions':
        -
          # The status codes this error page is generated for
          matchingStatusCodes: [404, 410]

          # Dimensions to use for this error page. Use empty array if no dimensions are configured
          dimensions: []

          # Node identifier of documentNode to use for rendering
          source: '#550e8400-e29b-11d4-a716-446655440000'

          # File path where this error page should be saved to. Available variables are `site` and `dimensions`
          destination: '${"/var/www/default/mysite/errorpages/404.html"}'

        -
          # You can also configure path prefixes so some site areas have different error pages. Make sure to adjust the destination path accordingly.
          pathPrefixes: ['/some-special-path']

          # The status codes this error page is generated for
          matchingStatusCodes: [404, 410]

          # Dimensions to use for this error page. Use empty array if no dimensions are configured
          dimensions: []

          # Node identifier of documentNode to use for rendering
          source: '#f7c8d757-391a-4a85-bdb5-81df56d5e2c0'

          # File path where this error page should be saved to. Available variables are site and dimensions
          destination: '${"/var/www/default/mysite/errorpages/404-some-special-path.html"}'

      'my-site-with-dimensions':
        -
          matchingStatusCodes: [500]

          # The first path segment that determines the dimensions. Use empty string if no dimensions are configured
          dimensionPathSegment: 'en_US'

          # Dimensions to use for this error page. Use empty array if no dimensions are configured
          dimensions:
            language: ['en_US', 'en']

          source: '#550e8400-e29b-11d4-a716-446655440000'
          destination: '${"%FLOW_PATH_DATA%Persistent/ErrorPages/" + site + "-" + dimensions + "-500.html"}'
```

Generate error pages
--------------------

[](#generate-error-pages)

To generate the static error pages, run the following Flow command:

```
./flow errorpage:generate --verbose
```

This will loop all error pages and download them to their destination. Depending on how often the content of the configured Neos pages changes, you might want to do this during deployment or periodically using a cronjob.

Show current configuration
--------------------------

[](#show-current-configuration)

```
./flow errorpage:showconfiguration
```

This call responds in YAML format, although not all settings are actually given in YAML settings. Instead, the result will be the merged result of both, YAML configuration and node based configuration.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance61

Regular maintenance activity

Popularity27

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 62.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 ~84 days

Recently: every ~43 days

Total

23

Last Release

244d ago

Major Versions

3.0.0 → 4.0.02020-12-01

4.1.0 → 5.0.02021-02-01

4.1.1 → 5.0.12021-11-29

4.1.2 → 5.0.32022-06-14

5.3.1 → 6.0.0-alpha.12025-04-03

PHP version history (6 changes)1.0.0PHP ~7.0

4.0.0PHP ~7.2

5.0.0PHP ^7.2

5.0.1PHP ^7.2 || ^8.0

5.0.2PHP ^7.3 || ^8.0

6.0.0-alpha.1PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/667b5107f4c2ea180baa00166c2ee3f2a1b412ce22768d6e81bb09323d1c7fe0?d=identicon)[netlogix](/maintainers/netlogix)

![](https://www.gravatar.com/avatar/124704a0d41c6364ac5773df0c9bedc3a85f902f0826df5f12ff2a4b2a06d520?d=identicon)[paxuclus](/maintainers/paxuclus)

---

Top Contributors

[![paxuclus](https://avatars.githubusercontent.com/u/15905038?v=4)](https://github.com/paxuclus "paxuclus (38 commits)")[![stephanschuler](https://avatars.githubusercontent.com/u/1595908?v=4)](https://github.com/stephanschuler "stephanschuler (13 commits)")[![saschanowak](https://avatars.githubusercontent.com/u/1643495?v=4)](https://github.com/saschanowak "saschanowak (6 commits)")[![nlx-jonas](https://avatars.githubusercontent.com/u/106147659?v=4)](https://github.com/nlx-jonas "nlx-jonas (2 commits)")[![toni-bessel](https://avatars.githubusercontent.com/u/34022843?v=4)](https://github.com/toni-bessel "toni-bessel (2 commits)")

---

Tags

error-handlingneosneoscms

### Embed Badge

![Health badge](/badges/netlogix-errorhandler/health.svg)

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

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M2.6k](/packages/craftcms-cms)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19562.3M1.3k](/packages/drupal-core)[laradumps/laradumps-core

LaraDumps is a friendly app designed to boost your Laravel / PHP coding and debugging experience.

261.2M13](/packages/laradumps-laradumps-core)[concrete5/core

Concrete core subtree split

19159.3k48](/packages/concrete5-core)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

7310.3k29](/packages/open-dxp-opendxp)[inviqa/spryker-debug

Inviqa Spryker Debug Module

14148.8k](/packages/inviqa-spryker-debug)

PHPackages © 2026

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