New in Symfony 5.4: Misc. features (part 1)


Strict Mode for Missing Assets


Contributed by Jérôme Tamarelle
in #38495.

In Symfony applications you can use a JSON file manifest as the strategy to
manage asset versions. When a requested asset is not listed in manifest.json,
Symfony returns the unmodified path of the asset. This prevents the application
from breaking when some asset is missing but generates 404 errors in the browser
when trying to load the asset.
In Symfony 5.4 we've added a strict_mode option (which is disabled by default).
When it's true, the application triggers an exception for missing assets, so you
can solve the issue. That's why it's recommended to use '%kernel.debug%' as
its value, so the application breaks in dev/test but keeps working in production:

# config/packages/assets.yaml
framework:
assets:
packages:
app:
strict_mode: '%kernel.debug%'

Copy File Paths in Error Pages


Contributed by Lorenzo Millucci
in #40052.

The file paths of error traces in exception pages are clickable. If you configure
the framework.ide option properly, you can open those files directly on PhpStorm,
VS Code, SublimeText, etc. In Symfony 5.4 we've improved this page a bit more so
you can copy those file paths to clipboard. You only need to move your mouse over
some row and you'll see a new clipboard icon to click on it:

Allow to Exclude Directories from Yaml Linting


Contributed by Christin Gruber
in #39641.

The lint:yaml command is a nice little tool used for example to
find errors in translation files. However, sometimes you might have YAML
files which use a custom syntax extensions or advanced features not supported by
the YAML linter. In those cases, use the new --exclude option to not lint
the files included in the given directories:

$ php bin/console lint:yaml translations/ --exclude=translations/experimental/

# you can exclude multiple directories
$ php bin/console lint:yaml translations/ --exclude=translations/draft/ --exclude=translations/discarded/

New Nil ULID Class


Contributed by Thomas Calvet
in #41802.

The Uid component provides utilities to work with UUIDs and ULIDs. The UUID
standard defines a NilUuid object to represent null UUID values and
Symfony component implements it. However, even if the ULID standard doesn't
define a NilUlid object, in Symfony 5.4 we've decided to add it so you can
easily create and check for null ULID values:

# BEFORE
use Symfony\Component\Uid\Ulid;

$nilUlid = new Ulid('00000000000000000000000000');

# AFTER
use Symfony\Component\Uid\NilUlid;

$nilUlid = new NilUlid();

New String Functions


Contributed by Nicolas Grekas
in #43481.

The String component provides an object-oriented API for strings and deals
with bytes, UTF-8 code points and grapheme clusters in a unified way.
In Symfony 5.4 we've added two new functions to it:

// removes the given content from the start/end of the string
u('file-image-0001.png')->trimPrefix('file-'); // 'image-0001.png'
u('file-image-0001.png')->trimPrefix('image-'); // 'file-image-0001.png'

u('template.html.twig')->trimSuffix('.html'); // 'template.html.twig'
u('template.html.twig')->trimSuffix('.twig'); // 'template.html'

// when passing an array of prefix/sufix, only the first one found is trimmed
u('file-image-0001.png')->trimPrefix(['file-', 'image-']); // 'image-0001.png'
u('template.html.twig')->trimSuffix(['.twig', '.html']); // 'template.html'

Sponsor the Symfony project.