deprecated

Twig genera un aviso de obsolescencia (mediante una llamada a la función PHP trigger_error()) donde se utiliza la etiqueta deprecated en una plantilla:

{# base.html.twig #}
{% deprecated 'The "base.html.twig" template is deprecated, use "layout.html.twig" instead.' %}
{% extends 'layout.html.twig' %}

También puedes marcar una macro como obsoleta de la siguiente manera:

{% macro welcome(name) %}
    {% deprecated 'The "welcome" macro is deprecated, use "hello" instead.' %}

    ...
{% endmacro %}

Ten en cuenta que, por defecto, los avisos de obsolescencia se silencian y nunca se muestran ni registran. Consulta Recetas para aprender cómo manejarlos.

Note

Las opciones package y version se agregaron en Twig 3.11.

Puedes opcionalmente agregar el paquete y la versión que introdujeron la obsolescencia:

{% deprecated 'The "base.html.twig" template is deprecated, use "layout.html.twig" instead.' package='twig/twig' %}
{% deprecated 'The "base.html.twig" template is deprecated, use "layout.html.twig" instead.' package='twig/twig' version='3.11' %}

Note

No uses la etiqueta deprecated para marcar un block como obsoleto, ya que la obsolescencia no siempre se puede activar correctamente.