Symfony项目中PHP Enum字符串转换错误及最佳实践咨询

我参考PHP 8.1枚举在Symfony项目中的实践方案，在实体中使用枚举类型后数据可正常持久化到数据库，但控制器执行$bookingFeeRepository->findAll()并传递给Twig模板时，出现错误：

Object of class App\Enum\BookingFeeStatusEnum could not be converted to string

相关代码示例 #

枚举类代码 #

<?php

namespace App\Enum;

enum BookingFeeStatusEnum: string
{
    case Hold = 'HOLD';
    case Deal = 'DEAL';
}

实体代码片段 #

...

class BookingFee
{
    
    #[ORM\Column(type: 'string', nullable: false, enumType: BookingFeeStatusEnum::class)]
    private BookingFeeStatusEnum $status = BookingFeeStatusEnum::Hold;


...

控制器代码 #

#[Route('', name: 'app_booking_fee_index', methods: ['GET'])]
public function index(BookingFeeRepository $bookingFeeRepository): Response
{
    return $this->render('booking_fee/index.html.twig', [
        'booking_fees' => $bookingFeeRepository->findAll(),
    ]);
}

表单代码 #

<?php

namespace App\Form;

use App\Entity\BookingFee;
use App\Enum\BookingFeeStatusEnum;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\EnumType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class BookingFeeType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('status', EnumType::class, [
                'class' => BookingFeeStatusEnum::class
            ])
            ->add('note')
            ->add('fee')
        ;
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => BookingFee::class,
        ]);
    }
}

临时解决方案与疑问 #

我尝试修改实体的getStatus()方法，让它直接返回枚举的字符串值，错误随之消失：

public function getStatus(): string
{
    return $this->status->value;
}

public function setStatus(BookingFeeStatusEnum $status): self
{
    $this->status = $status;

    return $this;
}

但不确定这种写法是否符合最佳实践，同时疑惑：Doctrine本身支持枚举映射，是否我遗漏了某些配置？或者是否应该改用实体属性为字符串类型，配合表单数据转换器来实现？

正确解决方案分析 #

问题本质 #

错误并非来自Doctrine的枚举配置，而是Twig模板尝试直接输出枚举对象时，PHP枚举默认没有实现__toString()方法，导致无法自动转换为字符串。

推荐方案1：在Twig中直接访问枚举的value属性 #

无需修改实体或枚举类，只需要在模板中明确调用枚举的value属性：

{{ booking_fee.status.value }}

这种方式保持了实体的类型安全，业务代码中仍能直接使用枚举对象的类型约束。

推荐方案2：给枚举类添加__toString()方法 #

在枚举类中实现__toString()方法，让枚举对象可以直接转换为字符串，模板中仍可使用{{ booking_fee.status }}：

<?php

namespace App\Enum;

enum BookingFeeStatusEnum: string
{
    case Hold = 'HOLD';
    case Deal = 'DEAL';

    public function __toString(): string
    {
        return $this->value;
    }
}

这是更优雅的处理方式，既保留了枚举的类型安全，又解决了字符串转换问题，后续如果给枚举添加业务逻辑方法也不受影响。

不推荐修改实体getStatus()返回字符串 #

这种方式虽然能解决当前问题，但会丢失类型安全——其他业务代码调用getStatus()时无法直接利用枚举的类型约束，也无法调用枚举对象的方法，不符合最佳实践。

关于Doctrine配置与表单转换器 #

• 你使用的#[ORM\Column(type: 'string', enumType: BookingFeeStatusEnum::class)]是Doctrine ORM 2.13+的原生枚举映射，配置完全正确，持久化和读取逻辑没有问题。
• Symfony的EnumType表单类型已经自动处理了枚举与字符串的转换，不需要额外添加数据转换器。

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