字段类型
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.4，现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
字段类型
的文件类型表示表单中的文件输入。
基本用法
假设你有这样的表单定义:
1
＄构建器->add (“附件”，“文件”）;提交表单时，附件字段的实例UploadedFile．它可以用来移动附件文件到永久位置:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16
使用ob娱乐下载＼组件＼HttpFoundation＼文件＼UploadedFile；公共函数uploadAction（）｛/ /……如果（＄形式->isValid ()) {＄someNewFilename=……＄形式［“附件”］->getData ()->移动(＄dir，＄someNewFilename）;/ /……｝/ /……｝的移动()方法以目录和文件名作为参数。你可以用以下方法之一来计算文件名:
1 2 3 4 5 6 7 8 9 10
//使用原来的文件名＄文件->移动(＄dir，＄文件->getClientOriginalName ());//计算一个随机名称并尝试猜测扩展名(更安全)＄扩展＝＄文件->guessExtension ();如果(！＄扩展) {//扩展名不能被猜测＄扩展＝“本”；｝＄文件->移动(＄dir,兰德(1，99999）.“。”．＄扩展）;使用原名称viagetClientOriginalName ()是不安全的，因为它可能被最终用户操纵。此外，它可以包含文件名中不允许的字符。在直接使用该名称之前，应该对其进行消毒。
读了食谱为如何管理与Doctrine实体相关联的文件上传的示例。
继承的选项
方法继承了这些选项形式类型:
empty_data
类型：混合
- ．．该文件应该只包含在设置为start-after或end-before时
- 这个占位符值。它的目的是让我们只包含该文件的一部分。
DEFAULT_PLACEHOLDER
此选项决定了当提交的值为空时字段将返回什么值。
但是您可以根据自己的需要定制它。例如，如果你想要性别要显式设置的选择字段零当没有选择值时，你可以这样做:
1 2 3 4 5 6 7 8 9
＄构建器->add (“性别”，“选择”，数组（“选择”= >数组（“米”= >“男”，“f”= >“女”)，“要求”= >假，“empty_value”= >“选择性别”，“empty_data”= >零));默认值为零．
empty_data
类型：混合
- ．．该文件应该只包含在设置为start-after或end-before时
- 这个占位符值。它的目的是让我们只包含该文件的一部分。
DEFAULT_PLACEHOLDER
此选项决定了当提交的值为空时字段将返回什么值。
但是您可以根据自己的需要定制它。例如，如果你想要性别要显式设置的选择字段零当没有选择值时，你可以这样做:
1 2 3 4 5 6 7 8 9
＄构建器->add (“性别”，“选择”，数组（“选择”= >数组（“米”= >“男”，“f”= >“女”)，“要求”= >假，“empty_value”= >“选择性别”，“empty_data”= >零));error_bubbling
类型：布尔默认的：假除非表格是复合
如果真正的，此字段的任何错误都将传递给父字段或表单。例如，如果设置为真正的对于普通字段，该字段的任何错误都将附加到主表单，而不是特定的字段。
error_mapping
类型：数组默认的：空
此选项允许您修改验证错误的目标。
假设您有一个名为matchingCityAndZipCode这将验证城市和邮政编码是否匹配。不幸的是，您的表单中没有“matchingCityAndZipCode”字段，因此Symfony所能做的就是在表单顶部显示错误。ob娱乐下载
使用自定义错误映射，你可以做得更好:将错误映射到城市字段，这样它就会显示在它上面:
1 2 3 4 5 6 7 8
公共函数setDefaultOptions(OptionsResolverInterface＄解析器）｛＄解析器->setDefaults (数组（“error_mapping”= >数组（“matchingCityAndZipCode”= >“城市”，)，));｝下面是映射左侧和右侧的规则:
- 左侧包含属性路径;
- 如果违反是在类的属性或方法上生成的，则其路径简单
propertyName； - 类的项上生成的违例
数组或ArrayAccess对象时，属性路径为(indexName)； - 您可以通过连接它们来构造嵌套的属性路径，用圆点分隔属性。例如:
地址[工作].matchingCityAndZipCode； - 错误映射的左侧也接受一个点
．，它指的是字段本身。这意味着添加到字段中的任何错误都会添加到给定的嵌套字段中; - 右侧仅包含表单中字段的名称。
标签
类型：字符串默认的:从字段名“猜测”标签
设置呈现字段时将使用的标签。设置为false将屏蔽标签。标签也可以直接在模板内设置:
- 嫩枝
- PHP
1
{{form_label(form.name， '你的名字')}}label_attr
类型：数组默认的：数组()
属性的HTML属性<标识>元素，它将在呈现字段的标签时使用。它是一个以HTML属性为键的关联数组。这些属性也可以直接在模板中设置:
- 嫩枝
- PHP
1
{{form_label(form.name， '您的名字'，{'label_attr': {'class': 'CUSTOM_LABEL_CLASS'}})}}要求
类型：布尔默认的：真正的
如果为，则HTML5所需属性将被渲染。相应的标签还会渲染一个要求类。
这是肤浅的，独立于验证。如果您让Symfony猜测您的字段类型，ob娱乐下载那么这个选项的值将从您的验证信息中猜测出来。
请注意
必选选项还影响如何处理每个字段的空数据。有关详细信息，请参见empty_data选择。
表单变量
| 变量 | 类型 | 使用 |
|---|---|---|
| 类型 | 字符串 |
类型变量设置为文件，以便呈现为文件输入字段。 |
