New in Symfony 6.2: Improved File Validator

Contributed by
Kévin Dunglas
in #47710.

The File constraint from the Validator component checks that a given value is a valid file. One of its options is called mimeTypes and it verifies that the media type (formerly known as MIME type) of the file is one of the given values:

use Symfony\Component\Validator\Constraints as Assert;

class ScannedDocument
{
    #[Assert\File(
        maxSize: '1024k',
        mimeTypes: ['application/pdf', 'application/x-pdf'],
    )]
    protected $pdfFile;

    // ...
}

The values passed to mimeTypes must be any of the official list of valid media types. Some of these values are confusing and cumbersome even for common file types (e.g. Microsoft Excel have multiple media types associated to it, such as application/vnd.ms-excel, application/vnd.ms-excel.sheet.macroEnabled.12, etc.)

In Symfony 6.2 we're improving the File constraint with a new option called extensions. This option checks both the file extension and its media type. Using this option, the above example looks as follows:

use Symfony\Component\Validator\Constraints as Assert;

class ScannedDocument
{
    #[Assert\File(maxSize: '1024k', extensions: 'pdf')]
    protected $pdfFile;

    // ...
}

The extensions option checks both that the file has exactly the .pdf extension and that its media type is any of the types associated to that extension in the official list (application/pdf, application/x-pdf, etc.)

In the following example, we allow uploading any file associated to JPEG media types, but require that the extension is .jpg (so, .jpeg files won't be allowed):

use Symfony\Component\Validator\Constraints as Assert;

class UserProfile
{
    #[Assert\File(maxSize: '250k', extensions: 'jpg')]
    protected $avatar;

    // ...
}

The extensions option also allows to pass a list of media types to accept for the extension. Moreover, you can pass an array to accept several extensions, each of them optionally defining which media types to accept:

use Symfony\Component\Validator\Constraints as Assert;

class SharedFile
{
    #[Assert\File(extensions: [
        'jpg',
        'txt' => 'text/plain',
        'xml' => ['text/xml', 'application/xml'],
    ])]
    protected $contents;

    // ...
}
            <hr style="margin-bottom: 5px" />
            <div style="font-size: 90%">
                <a href="https://symfony.com/sponsor">Sponsor</a> the Symfony project.
            </div>

https://symfony.com/blog/new-in-symfony-6-2-improved-file-validator?utm_source=Symfony%20Blog%20Feed&utm_medium=feed

Created 3y | Nov 14, 2022, 10:20:26 AM


Login to add comment

Other posts in this group

SymfonyCon Amsterdam 2025: Community Evening - Let’s Celebrate 20 Years of Symfony Together!

Symfony is turning 20 and we’re throwing a party you won’t want to miss! 🥳

Join us for an unforgettable evening of drinks, music, and great company at the Kanarie Club in Amsterdam!

This year

Jul 23, 2025, 3:10:02 PM | Symfony
A Week of Symfony #968 (July 14–20, 2025)

This week, the upcoming Symfony 7.4 version improved the Serializer component by adding more prefix support to the accessor, added more code to make the JsonPath component RFC compliant, and added sup

Jul 20, 2025, 8:20:04 AM | Symfony
A Week of Symfony #967 (July 7–13, 2025)

This week, Symfony unveiled the Symfony AI initiative, a set of components and bundles designed to bring powerful AI capabilities directly into your PHP applications. In addition, we published travel

Jul 13, 2025, 9:20:11 AM | Symfony
Kicking off the Symfony AI Initiative

Today we are happy to announce a new Symfony initiative called Symfony AI - with the goal to provide a comprehensive set of components and bundles designed to bring powerful AI capabilities directly i

Jul 11, 2025, 1:20:27 PM | Symfony
SymfonyCon Amsterdam 2025: Travel & Lodging Tips

SymfonyCon Amsterdam 2025, our next annual international Symfony conference, will take place on:

November 25 & 26: 2 workshops days with several topics to learn, practice and improve your skills

Jul 11, 2025, 8:40:20 AM | Symfony
A Week of Symfony #966 (June 30 – July 6, 2025)

This week, development on the upcoming Symfony 8.0 version continued with the removal of deprecated features and the marking of several classes as final. In addition, we published two new case studies

Jul 6, 2025, 8:10:15 AM | Symfony
Case study: Modernizing Audi France’s Digital Ecosystem with Symfony 6

At Wide, Micropole’s digital agency, they help leading brands modernize their digital infrastructures while ensuring scalability, security, and performance. When Audi France approached them to migrate

Jul 4, 2025, 9:40:14 AM | Symfony