Download the PHP package squirrelphp/twig-php-syntax without Composer

PHP Syntax for Twig

Enables syntax known from PHP in Twig, so PHP developers can more easily create and edit Twig templates. This is especially useful for small projects, where the PHP developers end up writing Twig templates and it is not worth it to have a slightly different syntax in your templates.

Installation

composer require squirrelphp/twig-php-syntax

Configuration

Add PhpSyntaxExtension to Twig:

You can also have a look at the extension definition and create your own extension class to only include some of the features, if you do not like all of them.

Symfony integration

If you use autoconfigure (which is the default) you just need to load the PhpSyntaxExtension class in services.yaml in the config directory of your project (the first four lines should already be there, just add the line with the PhpSyntaxExtension class at the end of the file):

If you do not use autoconfigure, you can add the twig extension tag to the service definition:

Features

=== / !== strict comparison operators

Twig has the same as test, which mimicks === in PHP, but has a syntax that can be hard to get used to. Using the strict comparison operators from PHP (=== and !==) reduces friction, is familiar and less verbose.

strtotime filter

Comparing timestamps in templates when the data only has (date) strings is a bit cumbersome in Twig, as there is no strtotime filter - this library adds it exactly as it is in PHP:

foreach loops

Twig uses for to create loops, with a slightly different syntax compared to foreach in PHP. With this library foreach becomes available in Twig with the same syntax as in PHP:

Internally it behaves the exact same way as for: it actually creates ForNode elements, so you have the same functionality like in for loops, including the loop variable and else. else works the same as with for:

break and continue

Sometimes it can be convenient to break loops in Twig, yet there is no native support for it. This library adds break and continue and they work exactly as in PHP:

You can use break with a number to break out of multiple loops, just like in PHP: (continue does not support this)

While you can often circumvent the usage of break and continue in Twig, it sometimes leads to additional nesting and more complicated code. Just one break or continue can clarify behavior and intent in these instances. Yet I would advise to use break and continue sparingly.

Variable type tests (string, array, true, callable, etc.)

Adds tests known from PHP, so you can test a value for being:

• an array (like is_array)
• a boolean (like is_bool)
• a callable (like is_callable)
• a float (like is_float)
• an integer (like is_int)
• an object (like is_object)
• a scalar (integer, float, string or boolean, like is_scalar)
• a string (like is_string)
• true (like === true)

• false (like === false)

  It uses the mentioned PHP functions / comparisons internally, so you have the same behavior as in PHP.

Convert to type: intval, strval, floatval and boolval filters

Converting a variable to a specific type is not something Twig encourages and it probably should be avoided, if possible. Yet there are situations where you just want to convert something to an integer or string so you can be sure a comparison is type safe or that there is no unexpected behavior because one value has the wrong type.

These filters mainly behave like the ones in PHP (and use the corresponding PHP functions internally), but there is some additional behavior to detect or avoid likely errors:

• only scalar values, null and objects with a __toString method are allowed, so if you use any of these filters with an array or an object that cannot be cast to a string it will throw an exception
• null will return 0 for intval, '' for strval, false for boolval and 0.0 for floatval (just like in PHP)
• objects with a toString method will be converted to a string first (using the toString method), and only after that intval, boolval and floatval will be used
• boolval should be used with caution, as if you give it any non-numeric string it will return true, yet empty strings and "0" will return false. boolval is here more for completeness, as it is probably the least useful conversion function in PHP. The recommendation is to use the other three functions instead of using boolval if possible.

&& and ||

If you want to make expressions even more like PHP, you can use && instead of and and || instead of or. This might be the least useful part of this library, as and and or are already short and clear, yet it is another easily remedied difference between Twig and PHP, and && and || can be easier to spot in comparison to and and or.