Inject dynamic tags programmatically

v2.3.0 2024-05-21 09:28 UTC


Latest Version Software License Build Status Code Coverage Mutation testing

Tag bag is an object oriented and very extendable way of adding content/tags to your pages.

A very common use case for the tag bag is tracking events on your pages.


composer require setono/tag-bag

Basic usage


use Setono\TagBag\Renderer\ElementRenderer;
use Setono\TagBag\Tag\InlineScriptTag;
use Setono\TagBag\TagBag;

$tagBag = new TagBag();

// in a controller or service

// in your template

The above call to TagBagInterface::renderAll() would output the following:


Here we introduced two important concepts of the tag bag: The tags and the rendering of the tags.

Tags are PHP classes implementing the TagInterface and they are designed to make it easier for you to output content on your pages. The ones included are pretty basic, and you may find that you'd want to use some other more advanced tags that you can read about in the tags section below.


The base library includes the following tags:

Content tag

use Setono\TagBag\Tag\ContentTag;

$tag = ContentTag::create('<div class="class-name">tag</div>');

Renders as:

<div class="class-name">tag</div>

Element tag

use Setono\TagBag\Tag\ElementTag;

$tag = ElementTag::createWithContent('div', 'content');

Renders as:


Inline script tag

use Setono\TagBag\Tag\InlineScriptTag;

$tag = InlineScriptTag::create('alert("Hey!");');

Renders as:


You can also add attributes to the inline script tag:

use Setono\TagBag\Tag\InlineScriptTag;

$tag = InlineScriptTag::create('{"@context": ""}')->withType('application/ld+json');

The above renders as:

<script type="application/ld+json">
{"@context": ""}

Link tag

use Setono\TagBag\Tag\LinkTag;

$tag = LinkTag::create('stylesheet', '');

Renders as:

<link rel="stylesheet" href="">

Style tag

use Setono\TagBag\Tag\StyleTag;

$tag = StyleTag::create('body { background-color: red; }');

Renders as:

body { background-color: red; }

Twig tag

Render using twig templates. See installation instructions and usage here.

PHP templates tag

Render using PHP templates. See installation instructions and usage here.

Gtag tag

If you're using Google's services, some of them allow you to track events using the gtag.

To make it easier to create these tags, you can use the gtag extension for the tag bag.


The base library contains two renderers. A renderer implements the RendererInterface.

Just as with the tags there are also renderers in the sub packages.

Content renderer

The ContentRenderer renders the content you've input in the tag.

Element renderer

The ElementRenderer renders 'element tag', e.g. <script>, <style>, <meta>, <link>, all tags based on HTML elements basically.


The intended use of the tag bag is to save the tag bag upon end of request and restore it upon starting the request life cycle. The TagBagInterface has store and restore methods for these events respectively.

use Setono\TagBag\Tag\InlineScriptTag;
use Setono\TagBag\TagBagInterface;

/** @var TagBagInterface $tagBag */

// in a controller or service
$tagBag->add(new InlineScriptTag('trackSomething();'));

// this stores the contents of the tag bag

// this restores the contents of the tag bag

Framework integration