如何在Doctrine中映射ENUM类型？（PHP 8.1.6+Symfony 6环境）

针对PHP 8.1 + Symfony 6 + Doctrine ORM的组合，推荐直接使用PHP 8.1原生ENUM搭配Doctrine 2.9+的原生支持，这是当前最简洁且兼容的方案，以下是完整示例：

1. 创建PHP原生ENUM类 #

首先定义你的枚举类型，比如订单状态：

// src/Enum/OrderStatus.php
namespace App\Enum;

enum OrderStatus: string
{
    case PENDING = 'pending';
    case PROCESSING = 'processing';
    case SHIPPED = 'shipped';
    case DELIVERED = 'delivered';
}

这里使用字符串类型的枚举值，方便与数据库字段直接映射。

2. 在Doctrine实体中映射ENUM #

在实体类中，通过Doctrine注解直接关联ENUM类，无需额外的类型配置：

// src/Entity/Order.php
namespace App\Entity;

use App\Enum\OrderStatus;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class Order
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;

    // 核心配置：用enumType指定对应的PHP ENUM类
    #[ORM\Column(type: 'string', enumType: OrderStatus::class)]
    private OrderStatus $status;

    public function __construct()
    {
        // 初始化默认状态
        $this->status = OrderStatus::PENDING;
    }

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

    public function setStatus(OrderStatus $status): self
    {
        $this->status = $status;
        return $this;
    }

    // 其他属性和方法...
}

3. 生成数据库Schema #

运行Doctrine命令更新数据库结构，Doctrine会自动在数据库中创建对应的ENUM字段（以MySQL为例，会生成ENUM('pending', 'processing', 'shipped', 'delivered')类型的字段）：

php bin/console doctrine:schema:update --force

4. 常见问题排查 #

• 映射不生效：先清理Symfony缓存，运行php bin/console cache:clear
• 数据库不支持ENUM：如SQLite，Doctrine会自动将ENUM降级为VARCHAR类型，同时在应用层验证枚举值的有效性
• Doctrine版本问题：确保你的Doctrine ORM版本≥2.9（Symfony 6默认依赖的版本满足此要求）
• 修改ENUM值：不要直接修改数据库ENUM，应先更新PHP ENUM类，再重新生成Schema

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