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

Utworzony 3y | 14 lis 2022, 10:20:26


Zaloguj się, aby dodać komentarz

Inne posty w tej grupie

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

13 lip 2025, 09:20:11 | 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

11 lip 2025, 13:20:27 | 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

11 lip 2025, 08:40:20 | 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

6 lip 2025, 08:10:15 | 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

4 lip 2025, 09:40:14 | Symfony
Case study: A Long-Term Powerhouse Behind Vente-unique.com's E-Commerce Success (Zero Churn, All Wins!)

Vente-unique.com, a leading European online retailer of furniture and home decor, operates in 11 countries, powered by a team of 400 professionals and serving more than 3 million customers. From 15 ye

2 lip 2025, 09:10:03 | Symfony
A Week of Symfony #965 (June 23–29, 2025)

This week, Symfony 6.4.23, 7.2.8 and 7.3.1 maintenance versions were released. Meanwhile, the upcoming Symfony 7.4 version continued adding new features such as better controller helpers, more precisi

29 cze 2025, 09:10:15 | Symfony