Reports conditional expressions nested inside other conditional expressions. Split them into named values or branches.

Parentheses do not hide a nested conditional. A conditional in an arrow function body is not nested in the conditional around the arrow function.

{{ flag ? (other ? one : two) : no }}

{{ flag ? yes : no }}

Prefers the include() function to the include tag.

No fix is offered: a rewrite must account for escaping, sandboxing, scope, and call order.

{% include 'card.twig' %}

{{ include('card.twig') }}

Enforces snake_case for macro parameter names.

Non-ASCII names are left alone. No fix is offered, because renaming a parameter breaks calls that pass it by name.

{% macro input(className) %}{% endmacro %}

{% macro input(class_name) %}{% endmacro %}

Enforces snake_case for macro names.

Non-ASCII names are left alone. No fix is offered, because renaming a macro breaks its callers.

{% macro htmlInput() %}{% endmacro %}

{% macro html_input() %}{% endmacro %}

Enforces snake_case for named arguments.

Enable this only when the functions, filters, and macros you call follow the Twig coding standard. Non-ASCII names are left alone.

{{ input(className: 'input') }}

{{ input(class_name: 'input') }}

Enforces snake_case for the names that set, for, import, from, arrow functions, assignments, and destructuring bind.

Variables from the application, mapping keys, attribute names, and non-ASCII names are left alone.

{% set firstName = user.name %}

{% set first_name = user.name %}

Requires the block or macro name on endblock and endmacro tags.

Short blocks need no closing tag. The fix adds the name and leaves whitespace control intact.

{% block title %}Title{% endblock %}

{% block title %}Title{% endblock title %}

Requires : between a named argument and its value, as the Twig coding standard recommends, instead of =.

Macro parameter defaults keep =.

此规则要求最低 Twig 版本 [twig.linter] version 为 3.12 或更高。

{{ range(low = 1, high = 3) }}

{{ range(low: 1, high: 3) }}

Prefers single quotes for plain strings: strings without escapes, apostrophes, #, or line breaks.

Other strings stay unchanged, because new quotes would change their meaning.

{{ "title" }}

{{ 'title' }}

Reports calls to the built-in attribute() function, deprecated since Twig 3.15.

Use dynamic attribute access, object.(name), after checking its call and lookup behavior. A macro imported as attribute is left alone.

此规则要求最低 Twig 版本 [twig.linter] version 为 3.15 或更高。

{{ attribute(object, name) }}

{{ object.(name) }}

Reports the spaceless filter, deprecated since Twig 3.12, including in apply tags.

No fix is offered: check the rendered output before you stop stripping whitespace.

此规则要求最低 Twig 版本 [twig.linter] version 为 3.12 或更高。

{{ text|spaceless }}

{{ text }}

Reports macro names repeated in one template. Names are case-sensitive.

Twig 3 uses the last definition; Twig 3.29 deprecates this and Twig 4 rejects it. An embed body has its own macros.

此规则要求最低 Twig 版本 [twig.linter] version 为 3.29 或更高。

{% macro title() %}A{% endmacro %}
{% macro title() %}B{% endmacro %}

{% macro title() %}Title{% endmacro %}

Requires only on include and embed tags, and a literal with_context: false in calls to the built-in include() function, so templates do not share the whole context by accident.

A macro imported as include is left alone. No fix is offered, because it would change the variables the included template can see.

{% include 'card.twig' %}

{% include 'card.twig' with {title: title} only %}

Disallows ignore missing on include and embed tags, and a literal ignore_missing: true in calls to the built-in include() function.

Dynamic values are left alone.

{% include 'card.twig' ignore missing %}

{% include 'card.twig' %}

Reports literal boolean conditions in if branches and conditional expressions.

The rule does not guess the truthiness of other values. No fix is offered, because removing a branch removes rendered text.

{% if true %}yes{% endif %}

{% if flag %}yes{% endif %}

Reports the filters listed in names, including in apply tags.

Names match exactly. An empty list reports nothing.

{{ title|raw }}

{{ title }}

Reports calls to the functions listed in names.

Names match exactly, including macros imported under those names. An empty list reports nothing.

{{ source('secret.txt') }}

{{ title }}

Reports the tags listed in names, including custom tags.

Names match exactly. An empty list reports nothing.

{% flush %}

{{ title }}

Disallows autoescape false blocks, which turn off escaping for their whole body.

No fix is offered, because Mago cannot tell which output needs escaping.

{% autoescape false %}{{ value }}{% endautoescape %}

{% autoescape 'html' %}{{ value }}{% endautoescape %}

Reports calls to the built-in dump() function. Debug output can expose the template context.

A macro imported as dump is left alone. No fix is offered: the calls and their arguments stay in place.

{{ dump(user) }}

{{ user.name }}

Disallows the raw filter, including in apply tags. Raw output can be deliberate, so this rule is off by default.

No fix is offered, because removing the filter can change escaping or token boundaries.

{{ user.name|raw }}

{{ user.name }}

Reports block names repeated in one template. Twig rejects such templates.

An embed body has its own blocks, so it may reuse a name from the enclosing template.

{% block title %}A{% endblock %}
{% block title %}B{% endblock %}

{% block title %}Title{% endblock %}

Reports macro parameter names that repeat an earlier parameter, including variadic parameters. Twig rejects such macros.

{% macro input(name, name) %}{% endmacro %}

{% macro input(name, value) %}{% endmacro %}

Reports named arguments that repeat a name in one call, filter, or test.

Twig ignores underscores and case in the argument names of its own functions, filters, and tests, so first_name and firstName name the same argument there. Calls to macros and methods compare names exactly.

{{ range(low: 1, low: 3) }}

{{ range(low: 1, high: 3) }}

Reports literal mapping keys that repeat an earlier key after PHP's array-key conversion, so '1' and 1 are the same key. The last value replaces the first.

Dynamic keys are left alone. No fix is offered, because both values can have side effects.

{{ {title: title, title: body} }}

{{ {title: title, body: body} }}