EasyAdmin Image Field
This field is used to manage the uploading of images to the backend. The entity property only stores the path to the image and not its binary contents, which are stored in a file.
In form pages (edit and new) it looks like this:
Basic Information
- PHP Class:
EasyCorp\Bundle \EasyAdminBundle \Field \ImageField - Doctrine DBAL Type used to store this value:
string - Symfony Form Type used to render the field:
FileUploadType, a custom form type created by EasyAdmin Rendered as:
1 2
<!-- when loading the page this is transformed into a dynamic widget via JavaScript --> <input type="file">
Options
setBasePath
By default, images are loaded in read-only pages (index and detail) "as is",
without changing their path. If you serve your images under some path (e.g.
uploads/images/) use this option to configure that:
1
yield ImageField::new('...')->setBasePath('uploads/images/');setUploadDir
By default, the contents of uploaded images are stored into files inside the
<your-project-dir>/public/uploads/images/ directory. Use this option to
change that location. The argument is the directory relative to your project root:
1
yield ImageField::new('...')->setUploadDir('assets/images/');setFileConstraints
By default, the uploaded file is validated using an empty Image constraint (which means it only validates that the uploaded file is of type image). Use this option to define the constraints applied to the uploaded file:
1
yield ImageField::new('...')->setFileConstraints(new Image(maxSize: '100k'));setUploadedFileNamePattern
By default, uploaded images are stored with the same file name and extension as the original files. Use this option to rename the image files after uploading. The string pattern passed as argument can include the following special values:
[day], the day part of the current date (obtained asdate('d'))[month], the month part of the current date (obtained asdate('m'))[year], the year part of the current date (obtained asdate('Y'))[timestamp], the current timestamp (obtained astime())[name], the original name of the uploaded file[slug], the slug of the original name of the uploaded file (generated with Symfony's String component)[extension], the original extension of the uploaded file (e.g.png)[contenthash], a SHA1 hash of the original file contents[randomhash], a random hash not related in any way to the original file contents[uuid], a random UUID v4 value (generated with Symfony's Uid component)[ulid], a random ULID value (generated with Symfony's Uid component)
You can combine them in any way:
1
yield ImageField::new('...')->setUploadedFileNamePattern('[year]/[month]/[day]/[slug]-[contenthash].[extension]');The argument of this method also accepts a closure that receives as its first argument the Symfony's UploadedFile instance:
1 2 3
yield ImageField::new('...')->setUploadedFileNamePattern(
fn (UploadedFile $file): string => sprintf('upload_%d_%s.%s', random_int(1, 999), $file->getFilename(), $file->guessExtension()))
);