图像

编辑该页面

警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 5.0,不再维护。

这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。

图像

图像约束作品一模一样文件约束,除了它mimetypemimeTypesMessage选项将自动设置为图像文件具体工作。

另外它有选项,这样你就可以验证图像的宽度和高度。

看到文件约束的大部分文档约束。欧宝官网下载app

基本用法

这个约束是最常用的属性将会呈现在一个表单文件类型字段。例如,假设您正在创建一个表单,你可以上传作者作者的“头像”的形象。在表单中,头像房地产是一个文件类型。的作者类可能看起来如下:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
/ / src /实体/ Author.php名称空间应用程序\实体;使用ob娱乐下载\组件\HttpFoundation\文件\文件;作者{受保护的美元头像;公共函数setHeadshot(文件美元文件= null){美元- >头像=美元文件;}公共函数getHeadshot(){返回美元- >头像;}}

为了保证头像文件对象是一个有效的图像和一定规模之间,添加以下:

  • 注释
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src /实体/ Author.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;作者{/ * * *@Assert\形象(* minWidth = 200 * maxWidth = 400, * minHeight = 200 * maxHeight = 400 *) * /受保护的美元头像;}

头像属性验证来保证它是一个真正的形象,它是在一定的宽度和高度。

你也可以保证头像图像是广场。在这种情况下,你可以禁用肖像和风景方向如以下代码所示:

  • 注释
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
/ / src /实体/ Author.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;作者{/ * * *@Assert\形象(* allowLandscape = false, * allowPortrait = false *) * /受保护的美元头像;}

你可以混合所有的约束选项来创建强大的验证规则。

选项

这个约束股票与它的所有选项文件约束。然而,它确实修改默认选项的两个值,并添加其他选项。

allowLandscape

类型:布尔默认的:真正的

如果这个选项是错误的,不能面向景观的形象。

allowLandscapeMessage

类型:字符串默认的:面向图像景观({{宽度}}{{高度}}px)。面向景观图像是不允许的

错误消息如果图像是面向景观的设置allowLandscape

在这个信息:您可以使用以下参数

参数 描述
{{高度}} 当前的高度
{{宽度}} 当前的宽度

allowPortrait

类型:布尔默认的:真正的

如果这个选择是错误的,不能面向肖像的图片。

allowPortraitMessage

类型:字符串默认的:面向图像肖像({{宽度}}{{高度}}px)。肖像的图片是不允许的

错误消息如果面向图像肖像集allowPortrait

在这个信息:您可以使用以下参数

参数 描述
{{高度}} 当前的高度
{{宽度}} 当前的宽度

allowSquare

类型:布尔默认的:真正的

如果这个选项是假的,不能一个正方形。如果你想迫使广场形象,然后离开这个选项的默认值真正的值和设置allowLandscapeallowPortrait

allowSquareMessage

类型:字符串默认的:图像是广场({{宽度}}{{高度}}px)。广场图像是不允许的

错误消息如果图像是广场集合allowSquare

在这个信息:您可以使用以下参数

参数 描述
{{高度}} 当前的高度
{{宽度}} 当前的宽度

corruptedMessage

类型:字符串默认的:图像文件损坏。

时的错误消息detectCorrupted选项已启用并损坏。

这个消息没有参数。

detectCorrupted

类型:布尔默认的:

如果这个选项是正确的,图像的内容进行验证,以确保图像不损坏。这与PHP的验证完成imagecreatefromstring函数,它要求PHP GD扩展要启用。

类型:数组|字符串

它定义了这个约束属于验证组或组。阅读更多关于验证组

maxHeight

类型:整数

如果设置,图像文件的高度必须小于或等于这个值像素。

maxHeightMessage

类型:字符串默认的:图像高度太大({{高度}}px)。允许的最大高度是{{max_height}} px。

错误消息如果图像的高度超过maxHeight

在这个信息:您可以使用以下参数

参数 描述
{{高度}} 当前的高度(无效)
{{max_height}} 最大允许高度

maxPixels

类型:整数

如果设置,图像文件的像素的数量必须小于或等于这个值。

maxPixelsMessage

类型:字符串默认的:图像有许多像素({{像素}}像素)。最大预期是{{max_pixels}}像素。

错误消息如果图像的像素的数量超过maxPixels

在这个信息:您可以使用以下参数

参数 描述
{{高度}} 当前图像的高度
{{max_pixels}} 允许的最大数量的像素
{{像素}} 当前的像素数量
{{宽度}} 当前图像的宽度

maxRatio

类型:浮动

如果设置,纵横比(宽/高)的图像文件必须小于或等于这个值。

maxRatioMessage

类型:字符串默认的:图像比例太大({{比率}})。允许最大比例是{{max_ratio}}

错误消息如果图像的纵横比超过maxRatio

在这个信息:您可以使用以下参数

参数 描述
{{max_ratio}} 所需的最大比例
{{比率}} 目前的比率(无效)

maxWidth

类型:整数

如果设置,图像文件的宽度必须小于或等于这个值像素。

maxWidthMessage

类型:字符串默认的:图像宽度太大({{宽度}}px)。允许的最大宽度是{{max_width}} px。

错误消息如果图像的宽度超过maxWidth

在这个信息:您可以使用以下参数

参数 描述
{{max_width}} 允许的最大宽度
{{宽度}} 当前的宽度(无效)

mimetype

类型:数组字符串默认的:图像/ *

你可以找到一个现有图片mime类型列表IANA网站

mimeTypesMessage

类型:字符串默认的:这个文件不是一个有效的图像。

minHeight

类型:整数

如果设置,图像文件的高度必须大于等于该值的像素。

minHeightMessage

类型:字符串默认的:图像高度太小({{高度}}px)。最低高度预期的{{min_height}} px。

错误消息如果图像的高度小于minHeight

在这个信息:您可以使用以下参数

参数 描述
{{高度}} 当前的高度(无效)
{{min_height}} 所需的最低高度

minPixels

类型:整数

如果设置,图像文件的像素的数量必须大于或等于这个值。

minPixelsMessage

类型:字符串默认的:图像像素太少({{像素}}像素)。最少是{{min_pixels}}像素。

错误消息,如果图像的像素的数量小于minPixels

在这个信息:您可以使用以下参数

参数 描述
{{高度}} 当前图像的高度
{{min_pixels}} 所需的最低数量的像素
{{像素}} 当前的像素数量
{{宽度}} 当前图像的宽度

minRatio

类型:浮动

如果设置,纵横比(宽/高)的图像文件必须大于或等于这个值。

minRatioMessage

类型:字符串默认的:图像比例太小({{比率}})。最低比率预计{{min_ratio}}

错误消息如果图像的纵横比小于minRatio

在这个信息:您可以使用以下参数

参数 描述
{{min_ratio}} 所需的最低比率
{{比率}} 目前的比率(无效)

minWidth

类型:整数

如果设置,图像文件的宽度必须大于等于该值的像素。

minWidthMessage

类型:字符串默认的:图像宽度太小({{宽度}}px)。最小宽度预期是{{min_width}} px。

错误消息如果图像的宽度小于minWidth

在这个信息:您可以使用以下参数

参数 描述
{{min_width}} 所需的最小宽度
{{宽度}} 当前的宽度(无效)

sizeNotDetectedMessage

类型:字符串默认的:图像的大小不能被探测到。

如果系统无法确定图像的大小,这个错误将显示出来。这只会发生在至少一个的尺寸约束选项被设置。

这个消息没有参数。

这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。