文件类型字段

编辑本页

警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 3.3,现已不再维护。

本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。

文件类型字段

文件类型表示表单中的文件输入。

呈现为 输入文件
选项
覆盖选项
继承的选项
父类型 FormType
文件类型

基本用法

假设你有这样的表单定义:

1 2 3 4
使用欧宝娱乐app下载地址组件形式扩展核心类型文件类型/ /……构建器->add (“附件”,文件类型::类);

提交表单时,附件字段的实例UploadedFile.它可以用来移动附件文件到永久位置:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
使用欧宝娱乐app下载地址组件HttpFoundation文件UploadedFile公共函数uploadAction()/ /……如果形式->isSubmitted () & &形式->isValid ()) {someNewFilename=……文件形式“附件”->getData ();文件->移动(dirsomeNewFilename);/ /……/ /……

移动()方法以目录和文件名作为参数。你可以用以下方法之一来计算文件名:

1 2 3 4 5 6 7 8 9 10
//使用原来的文件名文件->移动(dir文件->getClientOriginalName ());//计算一个随机名称并尝试猜测扩展名(更安全)扩展文件->guessExtension ();如果(!扩展){//扩展名不能被猜测扩展“本”;}文件->移动(dir,兰德(199999).“。”扩展);

使用原名称viagetClientOriginalName ()是不安全的,因为它可能被最终用户操纵。此外,它可以包含文件名中不允许的字符。在直接使用该名称之前,应该对其进行消毒。

如何上传文件为如何管理与Doctrine实体相关联的文件上传的示例。

场的选择

多个

类型布尔默认的

当设置为true时,用户将能够同时上传多个文件。

覆盖选项

复合

类型布尔默认的

此选项指定类型是否包含子类型。此选项是针对内置类型进行内部管理的,因此不需要显式地配置它。

data_class

类型字符串默认的文件

此选项设置类型要使用的适当的与文件相关的数据映射器。

empty_data

类型混合默认的

此选项决定了当提交的值为空时字段将返回什么值。

继承的选项

方法继承了这些选项FormType

禁用

类型布尔默认的

如果不希望用户修改字段的值,可以将禁用选项设置为true。任何提交的值都将被忽略。

error_bubbling

类型布尔默认的除非表格是复合

如果真正的,此字段的任何错误都将传递给父字段或表单。例如,如果设置为真正的对于普通字段,该字段的任何错误都将附加到主表单,而不是特定的字段。

error_mapping

类型数组默认的数组()

此选项允许您修改验证错误的目标。

假设您有一个名为matchingCityAndZipCode ()这将验证城市和邮政编码是否匹配。不幸的是,您的表单中没有“matchingCityAndZipCode”字段,因此Symfony所能做的就是在表单顶部显示错误。欧宝娱乐app下载地址

使用自定义错误映射,你可以做得更好:将错误映射到城市字段,这样它就会显示在它上面:

1 2 3 4 5 6 7 8
公共函数configureOptions(OptionsResolver解析器解析器->setDefaults (数组“error_mapping”= >数组“matchingCityAndZipCode”= >“城市”,),));}

下面是映射左侧和右侧的规则:

  • 左侧包含属性路径;
  • 如果违反是在类的属性或方法上生成的,则其路径简单propertyName
  • 类的项上生成的违例数组ArrayAccess对象时,属性路径为(indexName)
  • 您可以通过连接它们来构造嵌套的属性路径,用圆点分隔属性。例如:地址[工作].matchingCityAndZipCode
  • 右侧仅包含表单中字段的名称。

默认情况下,任何未映射的属性的错误都会冒泡到父表单。你可以用点(),将所有未映射属性的错误映射到特定字段。例如,将所有这些错误映射到城市字段中,使用:

1 2 3 4 5
解析器->setDefaults (数组“error_mapping”= >数组“。”= >“城市”,),));

标签

类型字符串默认的:从字段名“猜测”标签

设置呈现字段时将使用的标签。设置为false将屏蔽标签。标签也可以直接在模板内设置:

  • 嫩枝
  • PHP
1
{{form_label(form.name, '你的名字')}}

label_attr

类型数组默认的数组()

属性的HTML属性<标识>元素,它将在呈现字段的标签时使用。它是一个以HTML属性为键的关联数组。这些属性也可以直接在模板中设置:

  • 嫩枝
  • PHP
1 2 3
{{form_label(form.name, '您的名字',{' label_attr': {'class': 'CUSTOM_LABEL_CLASS'}})}}

label_format

类型字符串默认的

配置用作字段标签的字符串,以防标签选项未设置。这在使用时很有用关键字翻译信息

如果您使用关键字翻译消息作为标签,您通常会对同一个标签有多个关键字消息(例如。profile_address_streetinvoice_address_street).这是因为标签是为字段的每个“路径”构建的。为了避免重复的关键字消息,您可以将标签格式配置为静态值,例如:

1 2 3 4 5 6 7 8
/ /……profileFormBuilder->add (“地址”, AddressType::类,数组“label_format”= >“form.address. %名称%”));invoiceFormBuilder->add (“发票”, AddressType::类,数组“label_format”= >“form.address. %名称%”));

此选项由子类型继承。的标签字段都将使用form.address.street关键字信息。

label格式有两个变量:

% id %
字段的唯一标识符,由字段的完整路径和字段名组成。profile_address_street);
%的名字%
字段名(例如:).

默认值()的结果是“人性化”版本字段名的。

请注意

label_format选项在表单主题中求值。确保更新你的模板以防你定制表单主题

映射

类型布尔默认的真正的

如果希望在读取或写入对象时忽略该字段,则可以设置映射选项

要求

类型布尔默认的真正的

如果为,则HTML5所需属性将被渲染。相应的标签还会渲染一个要求类。

这是肤浅的,独立于验证。如果您让Symfony猜测您的字段类型,欧宝娱乐app下载地址那么这个选项的值将从您的验证信息中猜测出来。

请注意

必选选项还影响如何处理每个字段的空数据。有关详细信息,请参见empty_data选择。

表单变量

变量 类型 使用
类型 字符串 类型变量设置为文件,以便呈现为文件输入字段。
此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。