OroCommerce设置Customer User手机号为必填字段遇表单扩展问题

问题原因 #

你遇到的报错本质是：通过Oro后台添加的phone扩展字段，并非在FrontendCustomerUserRegistrationType的初始构建阶段加入表单，而是由Oro的Extend系统在表单构建的后续流程中动态添加的。因此在你的扩展类buildForm方法执行时，phone字段还未被添加到表单构建器中，调用$builder->get('phone')会提示字段不存在；而直接调用add又会和后续系统自动添加的字段冲突。

解决方案 #

使用Symfony表单的POST_BUILD事件，在表单构建完成后（此时所有动态字段已被添加）修改phone字段的属性。修改你的表单扩展类如下：

<?php
namespace <custom>\Bundle\CustomerBundle\Form\Extension;

use Oro\Bundle\CustomerBundle\Form\Type\FrontendCustomerUserRegistrationType;
use Symfony\Component\Form\AbstractTypeExtension;
use Symfony\Component\Validator\Constraints\NotBlank;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\Form\FormEvent;
use Symfony\Component\Form\FormEvents;

class FrontendCustomerUserRegistrationTypeExtension extends AbstractTypeExtension
{
    /**
     * {@inheritDoc}
     */
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder->addEventListener(FormEvents::POST_BUILD, function (FormEvent $event) {
            $form = $event->getForm();
            
            // 确认phone字段已存在
            if (!$form->has('phone')) {
                return;
            }
            
            $phoneField = $form->get('phone');
            $fieldConfig = $phoneField->getConfig();
            $fieldOptions = $fieldConfig->getOptions();
            
            // 设置为必填
            $fieldOptions['required'] = true;
            
            // 添加非空验证约束
            $fieldOptions['constraints'] = array_merge(
                $fieldOptions['constraints'] ?? [],
                [new NotBlank(message: "Phone number is required.")]
            );
            
            // 添加占位符
            $fieldOptions['attr'] = array_merge(
                $fieldOptions['attr'] ?? [],
                ['placeholder' => '+X(XXX)XXX-XXX']
            );
            
            // 重新添加字段以应用修改后的配置
            $form->add(
                'phone',
                get_class($fieldConfig->getType()->getInnerType()),
                $fieldOptions
            );
        });
    }

    /**
     * {@inheritDoc}
     */
    public function getExtendedType()
    {
        return FrontendCustomerUserRegistrationType::class;
    }
}

代码说明 #

• FormEvents::POST_BUILD事件会在表单所有字段构建完成后触发，此时能确保phone扩展字段已被添加到表单中。
• 通过$form->has('phone')做存在性检查，避免因字段未添加导致的异常。
• 保留原字段的类型（通过get_class($fieldConfig->getType()->getInnerType())获取），避免强制替换为TextType导致的类型不匹配问题。
• 使用array_merge合并原有配置和新配置，保留字段原有的其他属性（比如数据映射关系）。

内容的提问来源于stack exchange，提问作者quinnlin