PHPackages                             brookinsconsulting/bcerrorpagesbundle - 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. [CLI & Console](/categories/cli)
4. /
5. brookinsconsulting/bcerrorpagesbundle

ActiveLibrary[CLI & Console](/categories/cli)

brookinsconsulting/bcerrorpagesbundle
=====================================

BC Error Pages Bundle for Symfony 3. Provides a basic solution to override the default Symfony error pages template code and styles with designer friendly alternatives. Great for developers seeking to override default error pages in Symfony.

1181PHP

Since Mar 7Pushed 9y ago1 watchersCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

BC Error Pages
==============

[](#bc-error-pages)

This bundle implements a solution to override the default Symfony error pages template code and styles with designer friendly alternatives. Great for developers seeking to override default error pages in Symfony.

Version
=======

[](#version)

- The current version of BC Error Pages is 0.1.0
- Last Major update: February 24, 2017

Copyright
=========

[](#copyright)

- BC Error Pages is copyright 1999 - 2017 Brookins Consulting
- See: [COPYRIGHT.md](COPYRIGHT.md) for more information on the terms of the copyright and license

License
=======

[](#license)

BC Error Pages is licensed under the GNU General Public License.

The complete license agreement is included in the [LICENSE](LICENSE) file.

BC Error Pages is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License or at your option a later version.

BC Error Pages is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The GNU GPL gives you the right to use, modify and redistribute BC Error Pages under certain conditions. The GNU GPL license is distributed with the software, see the file doc/LICENSE.

It is also available at

You should have received a copy of the GNU General Public License along with BC Error Pages in doc/LICENSE. If not, see .

Using BC Error Pages under the terms of the GNU GPL is free (as in freedom).

For more information or questions please contact:

Requirements
============

[](#requirements)

The following requirements exists for using BC Error Pages:

### Symfony version

[](#symfony-version)

- Make sure you use Symfony version 2.8+ (required) or higher.
- Designed and tested with Symfony 3.2.x

### PHP version

[](#php-version)

- Make sure you have PHP 5.6 or higher.

Features
========

[](#features)

### Error Page Templates

[](#error-page-templates)

- layout:base.html.twig
- Exception:error(\*).html.twig

### Command

[](#command)

- bc:ep:install - installs global template overrides via symlink (These are installed via composer by default)

### Composer Script Handler

[](#composer-script-handler)

- runs the bc:ep:install command upon composer package installation, installs assets and clears caches

### Dependencies

[](#dependencies)

- This solution does not depend on eZ Platform in any way
- This solution depends on symfony/symfony
- This solution depends on symfony/filesystem

Use case requirements
=====================

[](#use-case-requirements)

This solution was created to provide for a simple basis to customize ugly yet informative Symfony error pages with a bc branded styled replacement.

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

[](#installation)

### Bundle post install/update command script installation

[](#bundle-post-installupdate-command-script-installation)

Within your project's / website's root composer.json file add the following composer scripts block to provide for automatic error page template and assets installation.

```
"scripts": {
    "symfony-scripts": [
        "Incenteev\\ParameterHandler\\ScriptHandler::buildParameters",
        "BrookinsConsulting\\BcErrorPagesBundle\\Composer\\ScriptHandler::installErrorPagesInApp",
        "Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::clearCache",
        "Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::installAssets"
    ],
    "post-install-cmd": [
        "@symfony-scripts"
    ],
    "post-update-cmd": [
        "@symfony-scripts"
    ]
},

```

### Bundle Activation

[](#bundle-activation)

Within file `app/AppKernel.php` method `registerBundles` add the following into the `$bundles = array(` variable definition.

```
// Brookins Consulting : BcErrorPagesBundle Requirements
new BrookinsConsulting\BcErrorPagesBundle\BcErrorPagesBundle()

```

Install the above before installing the bundle via composer to ensure that the automatic error page template and assets installation scripts function as designed.

### Bundle Installation via Composer

[](#bundle-installation-via-composer)

Run the following command from your project root to install the bundle:

```
bash$ composer require brookinsconsulting/bcerrorpagesbundle dev-master;

```

### Dev Env Route Installation (Optional)

[](#dev-env-route-installation-optional)

Edit your `app/config/routing.yml` file and add the following code to import this bundle's routes. Note that this step is optional and only required if you desire to test the error pages manually.

```
app_bcerrorpages:
    resource: "@BcErrorPagesBundle/Resources/config/routing_dev.yml"

```

### Template Installation

[](#template-installation)

Required only if not installed via composer

```
php bin/console bc:ep:install --relative

```

### Asset Installation

[](#asset-installation)

Required only if not installed via composer

```
php bin/console assets:install web --symlink --relative

```

### Clear the caches

[](#clear-the-caches)

Clear Symfony caches (Required).

```
php bin/console cache:clear;

```

Template Customization
======================

[](#template-customization)

Custom Template Overrides
-------------------------

[](#custom-template-overrides)

If you need to customize the provided templates remember to do so within the bundle resources itself.

If needed you may find making a fork or variation based on this bundle suits your needs for further template customization.

Usage
=====

[](#usage)

The solution is configured to work virtually by default once properly installed.

Testing
=======

[](#testing)

The solution is configured to work once properly installed and configured.

Simply navigate to a route / url which is not defined to trigger a 404 error and view the new error page template.

Troubleshooting
===============

[](#troubleshooting)

### Read the FAQ

[](#read-the-faq)

Some problems are more common than others. The most common ones are listed in the the [doc/FAQ.md](doc/FAQ.md)

### Support

[](#support)

If you have find any problems not handled by this document or the FAQ you can contact Brookins Consulting through the support system:

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

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

---

Top Contributors

[![brookinsconsulting](https://avatars.githubusercontent.com/u/617031?v=4)](https://github.com/brookinsconsulting "brookinsconsulting (4 commits)")

---

Tags

command-linephpsymfonysymfony-bundlesymfony-consolesymlink

### Embed Badge

![Health badge](/badges/brookinsconsulting-bcerrorpagesbundle/health.svg)

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

###  Alternatives

[wp-cli/wp-cli

WP-CLI framework

5.0k17.2M318](/packages/wp-cli-wp-cli)[consolidation/annotated-command

Initialize Symfony Console commands from annotated command class methods.

22569.8M18](/packages/consolidation-annotated-command)[chi-teck/drupal-code-generator

Drupal code generator

26947.8M5](/packages/chi-teck-drupal-code-generator)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui

Comprehensive TUI library heavily influenced by Ratatui

589747.0k6](/packages/php-tui-php-tui)

PHPackages © 2026

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