File: sandbox.rst

package info (click to toggle)
php-twig 3.20.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 5,940 kB
  • sloc: php: 23,320; makefile: 110; sh: 43
file content (35 lines) | stat: -rw-r--r-- 907 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
``sandbox``
===========

.. warning::

    The ``sandbox`` tag is deprecated as of Twig 3.15.
    Use the ``sandboxed`` option of the ``include`` function instead.

The ``sandbox`` tag can be used to enable the sandboxing mode for an included
template, when sandboxing is not enabled globally for the Twig environment:

.. code-block:: twig

    {% sandbox %}
        {% include 'user.html.twig' %}
    {% endsandbox %}

.. warning::

    The ``sandbox`` tag is only available when the sandbox extension is
    enabled (see the :doc:`Twig for Developers<../api>` chapter).

.. note::

    The ``sandbox`` tag can only be used to sandbox an include tag and it
    cannot be used to sandbox a section of a template. The following example
    won't work:

    .. code-block:: twig

        {% sandbox %}
            {% for i in 1..2 %}
                {{ i }}
            {% endfor %}
        {% endsandbox %}