字段类型
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.3,现已不再维护。
读本页的更新版本用于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实体相关联的文件上传的示例。
继承的选项
方法继承了这些选项形式类型:
error_bubbling
类型:布尔
默认的:假
除非表格是复合
如果真正的
,此字段的任何错误都将传递给父字段或表单。例如,如果设置为真正的
对于普通字段,该字段的任何错误都将附加到主表单,而不是特定的字段。
error_mapping
2.1
的error_mapping
选项在Symfony 2.1中引入。ob娱乐下载
类型:数组
默认的:数组()
此选项允许您修改验证错误的目标。
假设您有一个名为matchingCityAndZipCode
这将验证城市和邮政编码是否匹配。不幸的是,您的表单中没有“matchingCityAndZipCode”字段,因此Symfony所能做的就是在表单顶部显示错误。ob娱乐下载
使用自定义错误映射,你可以做得更好:将错误映射到城市字段,这样它就会显示在它上面:
1 2 3 4 5 6 7 8
公共函数setDefaultOptions(OptionsResolverInterface$解析器){$解析器->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'}})}}
要求
类型:布尔
默认的:真正的
如果为,则HTML5所需属性将被渲染。相应的标签
还会渲染一个要求
类。
这是肤浅的,独立于验证。如果您让Symfony猜测您的字段类型,ob娱乐下载那么这个选项的值将从您的验证信息中猜测出来。
请注意
必选选项还影响如何处理每个字段的空数据。有关详细信息,请参见empty_data选择。
表单变量
变量 | 类型 | 使用 |
---|---|---|
类型 | 字符串 |
类型变量设置为文件 ,以便呈现为文件输入字段。 |