PHPackages                             vkollin/doctrine-backed-enum-fields-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. vkollin/doctrine-backed-enum-fields-bundle

ActiveLibrary[Database & ORM](/categories/database)

vkollin/doctrine-backed-enum-fields-bundle
==========================================

Provides truly support for backed enums in doctrine by generating enum fields, not string fields.

1.4.1(2y ago)023.9k↓17.9%2[1 PRs](https://github.com/vkollin/doctrine-backed-enum-fields-bundle/pulls)MITPHPPHP >=8.1

Since Jul 7Pushed 1y ago1 watchersCompare

[ Source](https://github.com/vkollin/doctrine-backed-enum-fields-bundle)[ Packagist](https://packagist.org/packages/vkollin/doctrine-backed-enum-fields-bundle)[ RSS](/packages/vkollin-doctrine-backed-enum-fields-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (5)Versions (8)Used By (0)

Symfony Doctrine Enum Fields Bundle
===================================

[](#symfony-doctrine-enum-fields-bundle)

This library provides support to [PHP Enums](https://wiki.php.net/rfc/enumerations), introduced in PHP 8.1, within your Doctrine entities and will generate enum fields for you.

Doctrine introduced [kinda enum support](https://www.doctrine-project.org/2022/01/11/orm-2.11.html), but this will give you just string fields.

Thanks
------

[](#thanks)

This project was forked from [bpolaszek/doctrine-native-enums](https://github.com/bpolaszek/doctrine-native-enums) by [Beno!t POLASZEK](https://github.com/bpolaszek) and heavily inspired by [this blog post](https://knplabs.com/en/blog/how-to-map-a-php-enum-with-doctrine-in-a-symfony-project)

Installation
------------

[](#installation)

```
composer require vkollin/doctrine-backed-enum-fields-bundle
```

Usage
-----

[](#usage)

This library only works with [Backed enums](https://wiki.php.net/rfc/enumerations#backed_enums).

### In a Symfony project

[](#in-a-symfony-project)

#### 1. Declare the bundle.

[](#1-declare-the-bundle)

```
// config/bundles.php

return [
    // ...
    VKollin\Doctrine\BackedEnumFields\Bundle\DoctrineBackedEnumFieldsBundle::class => ['all' => true],
];
```

#### 2. Register enums in your configuration.

[](#2-register-enums-in-your-configuration)

```
# config/packages/doctrine_backed_enum_fields.yaml

doctrine_backed_enum_fields:
  enum_types:
    App\Entity\StatusEnum: ~
    #App\Entity\StatusEnum: status # Alternatively, if you want your type to be named "status"
```

#### 3. Use them in your entities.

[](#3-use-them-in-your-entities)

```
declare(strict_types=1);

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
final class Book
{
    #[
        ORM\Id,
        ORM\Column(unique: true),
        ORM\GeneratedValue(strategy: 'AUTO'),
    ]
    public int $id;

    #[ORM\Column]
    public string $name;

    #[ORM\Column(type: StatusEnum::class)]
    public StatusEnum $status;
}
```

### Enums in your key

[](#enums-in-your-key)

You need to use a custom id generator to use enums as your key. It is also required to set the GeneratedValue strategy to CUSTOM. Otherwise the custom id generator will not be used. Nothing will be generated here though.

```
#[ORM\Column(name: 'type', type: StatusEnum::class, nullable: false)]
#[ORM\GeneratedValue(strategy: 'CUSTOM')]
#[ORM\CustomIdGenerator(EnumIdGenerator::class)]
#[ORM\Id]
private StatusEnum $status,
```

Then you also need to tag the custom id generator as a doctrine id\_generator in your services.yaml

```
    VKollin\Doctrine\BackedEnumFields\IdGenerator\EnumIdGenerator:
        class: VKollin\Doctrine\BackedEnumFields\IdGenerator\EnumIdGenerator
        tags: [ 'doctrine.id_generator' ]
```

### In other projects using Doctrine

[](#in-other-projects-using-doctrine)

```
use App\Entity\StatusEnum;
use BenTools\Doctrine\NativeEnums\Type\NativeEnum;
use Doctrine\DBAL\Types\Type;

NativeEnum::registerEnumType(StatusEnum::class);
// NativeEnum::registerEnumType('status', StatusEnum::class); // Alternatively, if you want your type to be named "status"
```

License
-------

[](#license)

MIT.

*Ceterum censeo Doctrinam esse delendam*

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance27

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 69.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~110 days

Recently: every ~141 days

Total

7

Last Release

746d ago

Major Versions

0.0.5 → 1.4.02024-05-02

### Community

Maintainers

![](https://www.gravatar.com/avatar/b623099807ea29e486c2934237b1e45019e629bad0add08767cd8d0be2592a8a?d=identicon)[vinkol](/maintainers/vinkol)

---

Top Contributors

[![vkollin](https://avatars.githubusercontent.com/u/5981580?v=4)](https://github.com/vkollin "vkollin (9 commits)")[![gempir](https://avatars.githubusercontent.com/u/9765622?v=4)](https://github.com/gempir "gempir (3 commits)")[![Schluepfer](https://avatars.githubusercontent.com/u/18718586?v=4)](https://github.com/Schluepfer "Schluepfer (1 commits)")

### Embed Badge

![Health badge](/badges/vkollin-doctrine-backed-enum-fields-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/vkollin-doctrine-backed-enum-fields-bundle/health.svg)](https://phpackages.com/packages/vkollin-doctrine-backed-enum-fields-bundle)
```

###  Alternatives

[scienta/doctrine-json-functions

A set of extensions to Doctrine that add support for json query functions.

58723.9M36](/packages/scienta-doctrine-json-functions)[laravel-doctrine/orm

An integration library for Laravel and Doctrine ORM

8425.3M87](/packages/laravel-doctrine-orm)[damienharper/auditor-bundle

Integrate auditor library in your Symfony projects.

4542.8M](/packages/damienharper-auditor-bundle)[sonata-project/entity-audit-bundle

Audit for Doctrine Entities

644989.8k1](/packages/sonata-project-entity-audit-bundle)[bartlett/php-compatinfo-db

Reference Database of all functions, constants, classes, interfaces on PHP standard distribution and about 110 extensions

1183.0k1](/packages/bartlett-php-compatinfo-db)[heymoon/doctrine-psql-enum

Store PHP native enums as PostgeSQL custom enum types

254.9k](/packages/heymoon-doctrine-psql-enum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)