Sonata Admin Bundle：如何提醒用户填写非必填字段？

作为常年和Sonata Admin、Symfony打交道的开发者，我先把你的场景和代码整理得更清晰，再给点实用建议：

你提到的应用基于Symfony 3.3和Sonata Admin Bundle，其中ImagePair实体包含三个字段：一个字符串类型的name，以及两个关联的Image实体字段（比如你已经在配置的imageOne）。

你当前的表单配置代码可以规范成这样（补全了link_parameters的常见用法，同时优化了代码格式）：

protected function configureFormFields(FormMapper $formMapper)
{
    $formMapper
        // 配置字符串类型的name字段
        ->add('name', null, [
            'label' => '配对名称', // 自定义后台显示的标签，可根据需求修改
            'required' => true
        ])
        // 配置第一个Image关联字段
        ->add('imageOne', 'sonata_type_model', [
            'expanded' => false, // 使用下拉选择框而非单选按钮组
            'by_reference' => true, // 直接关联实体，无需级联操作时设为true
            'multiple' => false, // 单选模式
            'required' => true,
            'label' => '第一张图片'
        ], [
            'link_parameters' => [
                // 传递额外参数到Image实体的Admin列表页面，用于过滤或上下文控制
                'context' => 'pair_images', // 示例：指定媒体上下文（若用Sonata Media Bundle）
                'filter' => ['status' => ['value' => 'active']] // 示例：只显示激活状态的图片
            ]
        ])
        // 配置第二个Image关联字段，逻辑和第一个一致
        ->add('imageTwo', 'sonata_type_model', [
            'expanded' => false,
            'by_reference' => true,
            'multiple' => false,
            'required' => true,
            'label' => '第二张图片'
        ], [
            'link_parameters' => [
                'context' => 'pair_images',
                'filter' => ['status' => ['value' => 'active']]
            ]
        ]);
}

几个实用小提示 #

• Symfony 3.3支持短数组语法[]，比传统的array()更简洁，建议统一使用
• 给每个字段添加label参数能让后台表单的可读性更强，方便其他维护人员理解
• 如果你的Image实体是基于Sonata Media Bundle实现的，可以考虑替换为sonata_media_type字段类型，它自带上传、预览等更适合媒体文件的功能
• by_reference参数注意点：如果ImagePair的setImageOne方法是直接赋值实体（比如$this->imageOne = $imageOne），设为true就没问题；如果是处理集合关联（比如一对多），才需要设为false

内容的提问来源于stack exchange，提问作者Mayor of the Plattenbaus