url_encode

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

⚠️ Version 1.x is not maintained.

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.

`url_encode`

1.12.3

Support for encoding an array as query string was added in Twig 1.12.3.

1.16.0

The raw argument was removed in Twig 1.16.0. Twig now always encodes according to RFC 3986.

The url_encode filter percent encodes a given string as URL segment or an array as query string:

        1
2
3
4
5
6
7
8
        {{ "path-seg*ment"|url_encode }}
{# outputs "path-seg%2Ament" #}

{{ "string with spaces"|url_encode }}
{# outputs "string%20with%20spaces" #}

{{ {'param': 'value', 'foo': 'bar'}|url_encode }}
{# outputs "param=value&foo=bar" #}
    

Note

Internally, Twig uses the PHP urlencode (or rawurlencode if you pass true as the first parameter) or the http_build_query function. Note that as of Twig 1.16.0, urlencode always uses rawurlencode (the raw argument was removed.)