deprecatedTwig 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.