VOOZH about

URL: https://twig.symfony.com/doc/3.x/filters/data_uri.html

⇱ data_uri - Filters - Documentation - Twig PHP

Docs Filters data_uri
Docs for Twig version 3.x
Switch to another version: 1.x, 2.x

Questions & Feedback

Found a typo or an error?
Want to improve this document? Edit it.

Need support or have a technical question?
Ask support on Stack Overflow.

License

Twig documentation is licensed under the new BSD license.

data_uri

The data_uri filter generates a URL using the data scheme as defined in RFC 2397:

1
2
3
4
5
6
7
8
9
10
11
12
{{ image_data|data_uri }}{{ source('path_to_image')|data_uri }}{# force the mime type, disable the guessing of the mime type #}{{ image_data|data_uri(mime: "image/svg") }}{# also works with plain text #}{{ '<b>foobar</b>'|data_uri(mime: "text/html") }}{# add some extra parameters #}{{ '<b>foobar</b>'|data_uri(mime: "text/html", parameters: {charset: "ascii"}) }}

Note

The data_uri filter is part of the HtmlExtension which is not installed by default. Install it first:

1
$ composer require twig/html-extra

Then, on Symfony projects, install the twig/extra-bundle:

1
$ composer require twig/extra-bundle

Otherwise, add the extension explicitly on the Twig environment:

1
2
3
4
use Twig\Extra\Html\HtmlExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new HtmlExtension());

Note

The filter does not perform any length validation on purpose (limit depends on the usage context), validation should be done before calling this filter.

Arguments

  • mime: The mime type
  • parameters: A mapping of parameters
« currency_symbol | date »