PHPackages mouf/html.renderer - 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 & Views](/categories/templating)
4. /
5. mouf/html.renderer
ActiveLibrary[Templating & Views](/categories/templating)
mouf/html.renderer
==================
This package contains the rendering mechanism of the Mouf framework. It is a mechanism allowing packages/templates/developers to overload a default template for various HTML objects.
v2.0.0(3y ago)0362.4k↓72.1%4[2 issues](https://github.com/thecodingmachine/html.renderer/issues)6MITPHPPHP ^8.0
Since Apr 17Pushed 3y ago12 watchersCompare
[ Source](https://github.com/thecodingmachine/html.renderer)[ Packagist](https://packagist.org/packages/mouf/html.renderer)[ Docs](http://mouf-php.com/packages/mouf/html.renderer)[ RSS](/packages/mouf-htmlrenderer/feed)WikiDiscussions 2.0 Synced today
READMEChangelog (4)Dependencies (22)Versions (14)Used By (6)
[](https://packagist.org/packages/mouf/html.renderer)[](https://packagist.org/packages/mouf/html.renderer)[](https://packagist.org/packages/mouf/html.renderer)[](https://packagist.org/packages/mouf/html.renderer)[](https://travis-ci.org/thecodingmachine/html.renderer)[](https://coveralls.io/github/thecodingmachine/html.renderer?branch=2.0)[](https://scrutinizer-ci.com/g/thecodingmachine/html.renderer/?branch=2.0)
What is this package?
=====================
[](#what-is-this-package)
This package contains a rendering mechanism to **render objects in HTML**.
For application developers
--------------------------
[](#for-application-developers)
You are an application developer? [Learn how to use the rendering system](doc/for_application_developers.md) with PHP files or Twig templates to render your objects or overload renderers provided by packages.
See the video!
<iframe width="480" height="360" src="//[www.youtube.com/embed/f2MyYSUic1U](http://www.youtube.com/embed/f2MyYSUic1U)" frameborder="0" allowfullscreen></iframe> For package developers
----------------------
[](#for-package-developers)
You are a package developer? [Learn how to use the rendering system to allow other users to overload your renderers easily.](doc/for_package_developers.md)
Installation
------------
[](#installation)
```
$ composer require mouf/html.renderer ^2
```
The easiest way to use this package is through a dependency injection container compatible with [container-interop/service-providers](https://github.com/container-interop/service-provider).
Once installed, you need to register the [`Mouf\Html\Renderer\RendererServiceProvider`](src/RendererServiceProvider.php) into your container.
If your container supports [thecodingmachine/discovery](https://github.com/thecodingmachine/discovery) integration, you have nothing to do. Otherwise, refer to your framework or container's documentation to learn how to register *service providers*.
### Provided services
[](#provided-services)
This *service provider* provides the following services:
Service nameDescription`RendererInterface::class`The default renderer. An alias to `ChainRenderer::class``ChainRenderer::class`A composite renderer asking all other renderers in turn if they can render an object.`customRenderers`A list of `RendererInterface` objects at the "custom" level (top most level). This list is consumed by the `ChainRenderer``customRenderer`A default custom renderer is provided by this package. Out of the box, template files are expected to be in the `src/templates` directory.`packageRenderers`A list of `RendererInterface` objects at the "package" level (bottom level). This list is consumed by the `ChainRenderer`. When a package you install has a renderer, it will add the renderer to this list (most of the time using the `AbstractPackageRendererServiceProvider``InitRendererFacadeMiddleware::class`A PSR-15 middleware that is used to initialize global access to the default renderer. This is needed for the `Renderable` trait to work.### Extended services
[](#extended-services)
This *service provider* extends those services:
NameCompulsoryDescription`MiddlewareListServiceProvider::MIDDLEWARES_QUEUE`*yes*The `InitRendererFacadeMiddleware::class` registers itself in the list of PSR-15 middlewares.Mouf package
------------
[](#mouf-package)
This package was originally part of Mouf (), an effort to ensure good developing practices by providing a graphical dependency injection framework.
V2 makes the package framework-agnostic, so it can be used in any framework.
Basically, you will find in this package some **Renderers**. These are classes in charge of rendering other objects. They usually rely on *template files*, that contain the HTML to be rendered. Renderers can be *chained*, and the first renderer that knows how to render an object will be in charge of the rendering.
Troubleshooting
---------------
[](#troubleshooting)
Your template or a custom template is not applied.
- Purge the cache with the red button in mouf.
- You use Ajax and you return html with echo (for example BCE).
- By default an echo don't apply the template to make it
- add the defaultRenderer (a class of Mouf\\Html\\Renderer\\AutoChainRenderer) in your class
- add your templateRenderer (a class of Mouf\\Html\\Renderer\\FileBasedRenderer) in Bootstrap this is bootstrapRenderer
- add the code before your call to the function toHTML: $this->defaultRenderer->setTemplateRenderer($this->templateRenderer);
### Health Score
41
—
FairBetter than 87% of packages
Maintenance20
Infrequent updates — may be unmaintained
Popularity34
Limited adoption so far
Community25
Small or concentrated contributor base
Maturity75
Established project with proven stability
Bus Factor1
Top contributor holds 90.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 ~262 days
Recently: every ~473 days
Total
13
Last Release
1311d ago
Major Versions
v1.2.1 → v2.0.02022-12-01
PHP version history (2 changes)v1.0.0PHP >=5.4.4
v2.0.0PHP ^8.0
### Community
Maintainers
[mouf](/maintainers/mouf)[@Mouf](https://github.com/Mouf)
---
Top Contributors
[](https://github.com/moufmouf "moufmouf (69 commits)")[](https://github.com/nguyenk "nguyenk (3 commits)")[](https://github.com/xhuberty "xhuberty (2 commits)")[](https://github.com/homersimpsons "homersimpsons (1 commits)")[](https://github.com/npeguin "npeguin (1 commits)")
---
Tags
htmlinterfacerendertohtml
### Code Quality
TestsPHPUnit
Static AnalysisPHPStan
Code StylePHP\_CodeSniffer
Type Coverage Yes
### Embed Badge
```
[](https://phpackages.com/packages/mouf-htmlrenderer)
```
### Alternatives
[symfony/symfony
The Symfony PHP framework
31.4k87.2M2.2k](/packages/symfony-symfony)[cakephp/cakephp
The CakePHP framework
8.9k19.5M1.8k](/packages/cakephp-cakephp)[moonshine/moonshine
Laravel administration panel
1.3k253.1k81](/packages/moonshine-moonshine)[getgrav/grav
Modern, Crazy Fast, Ridiculously Easy and Amazingly Powerful Flat-File CMS
15.6k86.4k1](/packages/getgrav-grav)[typo3/cms
TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.
1.2k1.9M122](/packages/typo3-cms)[thecodingmachine/graphqlite
Write your GraphQL queries in simple to write controllers (using webonyx/graphql-php).
5733.3M47](/packages/thecodingmachine-graphqlite)
PHPackages © 2026
[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)