url_encode

You are reading the documentation for Twig 1.x. Switch to the documentation for Twig 2.x, 3.x.

Warning Twig version 1.x is no longer 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.)