Demonstrate #[AsDatabaseType]

[GromNaN]

Demonstrates the new #[AsDatabaseType] attribute from DoctrineBundle that registers DBAL types as Symfony services with a per-connection TypeRegistry.

• Adds EncryptedEmailType: a custom DBAL type that stores User::$email encrypted in the database using deterministic AES-256-GCM
• The encryption key is provided via the APP_EMAIL_ENCRYPTION_KEY environment variable, injected into the type via #[Autowire(env: 'APP_EMAIL_ENCRYPTION_KEY')]
• The key is generated automatically in .env.local on composer install via bin/generate-env-keys
• The type is registered automatically via #[AsDatabaseType(name: EncryptedEmailType::NAME)] — no doctrine.dbal.types config needed
• All 61 tests pass (including 8 new unit tests for the type)

Warning

This is for demonstration purposes only. Production-grade field-level encryption requires more advanced techniques for key management (key rotation, envelope encryption, HSM/KMS integration, etc.). This example intentionally keeps it simple to focus on the #[AsDatabaseType] feature.

Important

Key rotation requires reloading fixtures. The encryption key is generated once on composer install. If you regenerate it (e.g. by deleting .env.local), you must reload fixtures to re-encrypt the database with the new key:

php bin/console doctrine:fixtures:load

The test database (data/database_test.sqlite) uses the fixed zero key from .env.test. Regenerate it after changing fixtures or encryption logic:

php bin/console doctrine:fixtures:load --env=test

How it works

use Doctrine\Bundle\DoctrineBundle\Attribute\AsDatabaseType;
use Symfony\Component\DependencyInjection\Attribute\Autowire;

#[AsDatabaseType(name: EncryptedEmailType::NAME)]
final class EncryptedEmailType extends Type
{
    public const string NAME = 'encrypted_email';

    public function __construct(
        #[Autowire(env: 'APP_EMAIL_ENCRYPTION_KEY')]
        string $emailEncryptionKey,
    ) { ... }
}

#[ORM\Column(type: EncryptedEmailType::NAME, unique: true)]
private ?string $email = null;

Dependencies

This demo depends on PRs in 3 repositories:

• Add TypeRegistry to Configuration and use it in all internal type resolution doctrine/dbal#7342
• Replace static Type::* calls with instance-based TypeRegistry lookups doctrine/orm#12421
• Add #[AsDatabaseType] attribute to register DBAL types as Symfony services doctrine/DoctrineBundle#2221