使用实体的自定义查询

如果你在获取实体时需要指定一个自定义查询(例如，你只想返回一些实体，或者需要对它们排序)，请使用query_builder选择。使用该选项的最简单方法如下:

1 2 3 4 5 6 7 8 9 10

使用学说＼ORM＼EntityRepository；/ /……＄构建器->add (“用户”，“实体”，数组（“类”= >“AcmeHelloBundle:用户”，“query_builder”= >函数(EntityRepository＄呃）｛返回＄呃->createQueryBuilder (“u”）->orderBy (“u.username”，“ASC”）;}));

使用选择

如果您已经拥有希望包含在choice元素中的实体的确切集合，则可以简单地通过选择关键。例如，如果你有一个美元集团变量(可能作为表单选项传递到表单中)和getuser的集合。用户实体，然后您可以提供选择选项直接:

1 2 3 4

＄构建器->add (“用户”，“实体”，数组（“类”= >“AcmeHelloBundle:用户”，“选择”= >＄集团->getuser ()));

类

类型：字符串要求

你的实体的类(例如:AcmeStoreBundle:类别)．这可以是一个完全限定的类名(例如。Acme \ \ StoreBundle \实体类别)或短别名(如前所示)。

data_class

类型：字符串

此选项用于设置表单要使用的适当数据映射器，因此可以将其用于任何需要对象的表单字段类型。

1 2 3

＄构建器->add (“媒体”，“sonata_media_type”，数组（“data_class”= >“Acme \ DemoBundle \实体\媒体”));

新兴市场

类型：字符串默认的:默认的实体管理器

如果指定了，将使用指定的实体管理器加载选项，而不是默认的实体管理器。

group_by

类型：字符串

这是一个属性路径(例如。author.name)用于将可用的选项分组。它仅在呈现为选择标记时有效，并通过添加optgroup围绕选项的元素。没有为该属性路径返回值的选项将直接呈现在select标记下，而不包含周围的optgroup。

财产

类型：字符串

这是用于在HTML元素中以文本形式显示实体的属性。如果为空，则实体对象将被转换为字符串，因此必须有__toString ()方法。

1 2 3 4

＄构建器->add (“性别”，“实体”，数组（“类”= >“MyBundle:性别”，“属性”= >“翻译(en) . name”));

query_builder

类型：学说\ ORM \ QueryBuilder或闭包

如果指定了，则用于查询应用于该字段的选项子集(及其顺序)。该选项的值可以是aQueryBuilder对象或闭包。如果使用闭包，它应该接受一个参数，即EntityRepository实体的。

choice_list

默认的：EntityChoiceList

的目的实体类型用于创建和配置该对象EntityChoiceList对您来说，可以使用上述所有选项。如果需要覆盖此选项，可以考虑使用选择字段类型直接。

选择

类型: array ||\可反驳的默认的：零

而不是允许类而且query_builder选项来获取要包含的实体，您可以将选择直接选择。看到字段类型．

empty_value

类型：字符串或布尔

这个选项决定了一个特殊的“空”选项(例如:“选择一个选项”)将出现在选择小部件的顶部。此选项仅适用于多个选项设置为false。

• 添加一个空值，文本为“Choose an option”:

  1 2 3

  ＄构建器->add (“州”，“选择”，数组（“empty_value”= >“选择一个选项”));

• 确保没有“空”值选项显示:

  1 2 3

  ＄构建器->add (“州”，“选择”，数组（“empty_value”= >假));

如果你离开empty_value选项未设置时，则当且仅当要求选项为false:

1 2 3 4

//添加一个空白(无文本)选项＄构建器->add (“州”，“选择”，数组（“要求”= >假));

扩大

类型：布尔默认的：假

如果设置为true，则将呈现单选按钮或复选框(取决于多个值)。如果为false，将呈现一个select元素。

多个

类型：布尔默认的：假

如果为真，用户将能够选择多个选项(而不是只选择一个选项)。的值扩大选项，如果为真，将呈现一个选择标签或复选框，如果为假，将呈现一个选择标签或单选按钮。返回值将是一个数组。

preferred_choices

类型：数组默认的：数组()

如果指定了此选项，则所有选项的子集将被移动到选择菜单的顶部。下面将“Baz”选项移动到顶部，并在它和其他选项之间使用可视分隔符:

1 2 3 4

＄构建器->add (“foo_choices”，“选择”，数组（“选择”= >数组（“foo”= >“Foo”，“酒吧”= >“酒吧”，“记者”= >“记者”)，“preferred_choices”= >数组（“记者”)));

注意，首选选项仅在呈现为对象时才有意义选择元素(即。扩大是假的)。首选选项和普通选项在视觉上由一组虚线分隔开。-------------------)．这可以在呈现字段时自定义:

1

{{form_widget(形式。Foo_choices， {'separator': '====='})}}

1

<？php回声＄视图［“形式”］->小部件(＄形式［“foo_choices”]，数组（“分隔符”= >“= = = = =”）)? >

方法继承了这些选项形式类型:

数据

类型:混合默认的:默认为基础对象的字段(如果有的话)

创建表单时，每个字段最初显示表单域对象的相应属性的值(如果对象绑定到表单)。如果你想覆盖表单的初始值或只是一个单独的字段，你可以在data选项中设置它:

1 2 3

＄构建器->add (“令牌”，“隐藏”，数组（“数据”= >“六边形abcdef”));

禁用

类型：布尔默认的：假

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

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将屏蔽标签。标签也可以直接在模板内设置:

1

{{form_label(form.name， '你的名字')}}

1 2 3 4

回声＄视图［“形式”］->标签(＄形式［“名字”]，“你的名字”）;

label_attr

类型：数组默认的：数组()

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

1

{{form_label(form.name， '您的名字'，{'label_attr': {'class': 'CUSTOM_LABEL_CLASS'}})}}

1 2 3 4 5

回声＄视图［“形式”］->标签(＄形式［“名字”]，“你的名字”，数组（“label_attr”= >数组（“类”= >“CUSTOM_LABEL_CLASS”)));

映射

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

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

read_only

类型：布尔默认的：假

如果此选项为true，则该字段将使用只读的属性，使字段不可编辑。

要求

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

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

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