31 lines
845 B
ReStructuredText
31 lines
845 B
ReStructuredText
``deprecated``
|
|
==============
|
|
|
|
.. versionadded:: 2.6
|
|
The ``deprecated`` tag was added in Twig 2.6.
|
|
|
|
Twig generates a deprecation notice (via a call to the ``trigger_error()``
|
|
PHP function) where the ``deprecated`` tag is used in a template:
|
|
|
|
.. code-block:: twig
|
|
|
|
{# base.twig #}
|
|
{% deprecated 'The "base.twig" template is deprecated, use "layout.twig" instead.' %}
|
|
{% extends 'layout.twig' %}
|
|
|
|
Also you can deprecate a block in the following way:
|
|
|
|
.. code-block:: twig
|
|
|
|
{% block hey %}
|
|
{% deprecated 'The "hey" block is deprecated, use "greet" instead.' %}
|
|
{{ block('greet') }}
|
|
{% endblock %}
|
|
|
|
{% block greet %}
|
|
Hey you!
|
|
{% endblock %}
|
|
|
|
Note that by default, the deprecation notices are silenced and never displayed nor logged.
|
|
See :ref:`deprecation-notices` to learn how to handle them.
|