PHPackages                             nowo-tech/fragment-kit-bundle - 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. [Templating &amp; Views](/categories/templating)
4. /
5. nowo-tech/fragment-kit-bundle

ActiveSymfony-bundle[Templating &amp; Views](/categories/templating)

nowo-tech/fragment-kit-bundle
=============================

Symfony bundle: resilient Twig fragment rendering with optional fallback template and Sentry reporting.

v1.2.0(3w ago)0379↓65.9%MITShellPHP &gt;=8.2 &lt;8.6CI passing

Since Jul 16Pushed 1w agoCompare

[ Source](https://github.com/nowo-tech/FragmentKitBundle)[ Packagist](https://packagist.org/packages/nowo-tech/fragment-kit-bundle)[ Docs](https://github.com/nowo-tech/FragmentKitBundle)[ RSS](/packages/nowo-tech-fragment-kit-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (9)Dependencies (38)Versions (8)Used By (0)

FragmentKitBundle
=================

[](#fragmentkitbundle)

[![CI](https://github.com/nowo-tech/FragmentKitBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/FragmentKitBundle/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/0189ac9cda4280b8bac5df84f36125da0d28157a89930f088817ca96aec1abf9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f667261676d656e742d6b69742d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/fragment-kit-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/e65836c2560632108089305cfe6643f1e54d9d54991b78e18f0dc54a0346f660/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f667261676d656e742d6b69742d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/fragment-kit-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/0701ae1a8855b98dea0f1dc9d9025d6b0f9444a803559dc983614d044176348b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e34253230253743253230382e30253230253743253230382e312532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/2d552879ba599cc1d34c2ad26c8fe68fda027db28590eddd3e2c5b9a7453443e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f467261676d656e744b697442756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/FragmentKitBundle) [![Coverage](https://camo.githubusercontent.com/cd0704b56f1d56def350b6d0164316307bb2f47834225fd85443b6fb0059bc73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352d627269676874677265656e)](#tests-and-coverage)

> ⭐ **Found this useful?** Give it a star on GitHub! It helps us maintain and improve the project.

Symfony bundle that makes Twig fragment sub-requests resilient when using `{ignore_errors: true}`.

[![FrankenPHP Friendly Worker Mode](docs/images/frankenphp-friendly.png)](docs/images/frankenphp-friendly.png)

This bundle is **FrankenPHP worker mode friendly**.

Features
--------

[](#features)

- ✅ **HTTP error tolerance** — `{ignore_errors: true}` also covers 403/404 (not only exceptions)
- ✅ **Twig fallback** — configurable template (or empty string)
- ✅ **Optional Sentry** — report suppressed failures without breaking the parent page
- ✅ **Flex recipe** — ships `nowo_fragment_kit` config
- ✅ **FrankenPHP demo** — Symfony 8 single-container demo

**FrankenPHP:** Demos use a **single PHP service** (FrankenPHP, no nginx). Runtime mode is controlled by **`FRANKENPHP_MODE`** in `.env` (**default `worker`**). Set `classic` for per-request PHP / easier hot-reload (entrypoint swaps in `Caddyfile.dev`). Recreate the container after changing the mode — no image rebuild. See [docs/DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md).

Version information
-------------------

[](#version-information)

VersionPHPSymfonyStatus1.2.x&gt;= 8.27.4 – 8.1+Stable1.1.x&gt;= 8.27.4 – 8.1+Stable1.0.x&gt;= 8.27.4 – 8.1+Security / maintenanceInstallation
------------

[](#installation)

```
composer require nowo-tech/fragment-kit-bundle
```

Register the bundle (Flex does this automatically):

```
Nowo\FragmentKitBundle\NowoFragmentKitBundle::class => ['all' => true],
```

```
{{ render(controller('App\\Controller\\WidgetController::index'), {ignore_errors: true}) }}
```

Requirements
------------

[](#requirements)

- PHP `>= 8.2`, `< 8.6`
- Symfony `^7.4 || ^8.0` (CI covers **7.4**, **8.0**, **8.1**)
- Twig Bundle

Problem
-------

[](#problem)

`{{ render(controller(...), {ignore_errors: true}) }}` only suppresses **exceptions** thrown during sub-requests. When the sub-request returns an HTTP error status (403, 404, …), `FragmentHandler::deliver()` throws a `RuntimeException` and the **parent page still fails with a 500**.

Demos
-----

[](#demos)

```
make -C demo up-symfony8   # http://localhost:8050 (default PORT)
```

Development
-----------

[](#development)

```
make setup-hooks
make up
make install
make release-check
```

Documentation
-------------

[](#documentation)

- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)
- [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md)
- [GitHub Spec Kit](docs/SPEC-KIT.md)

### Additional documentation

[](#additional-documentation)

- [GitHub Actions CI requirements](docs/GITHUB_CI.md)
- [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md) (includes worker mode)
- [Server cookbook (Nginx, php-fpm, FrankenPHP)](docs/SERVERS.md)

Tests and coverage
------------------

[](#tests-and-coverage)

```
make test
make test-coverage
```

- Tests: PHPUnit (unit + integration)
- PHP: **100%** lines (`make test-coverage`)

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance96

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 68.6% 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 ~3 days

Total

7

Last Release

26d ago

### Community

Maintainers

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

---

Top Contributors

[![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (24 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")

---

Tags

fragmentfrankenphpphpsentrysymfonysymfony-bundletwigsymfonytwigfragmentsentrySymfony Bundlesub-requestignore-errors

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-fragment-kit-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-fragment-kit-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-fragment-kit-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.7M440](/packages/easycorp-easyadmin-bundle)[pimcore/pimcore

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

3.8k4.0M551](/packages/pimcore-pimcore)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

605.9M709](/packages/shopware-core)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1718.2k18](/packages/2lenet-crudit-bundle)[open-dxp/opendxp

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

9830.9k78](/packages/open-dxp-opendxp)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)

PHPackages © 2026

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