jfnetwork/doctrine-encrypted-object

Doctrine mapping type to store encrypted objects

Doctrine Encrypted Object Mapping

This bundle implement a doctrine mapping type for objects, that should be encrypted in storage., _(*1)

Install

The bundle can be installed with composer:, _(*2)

composer require jfnetwork/doctrine-encrypted-object

For Sodium or Openssl encryption are corresponding PHP extensions required. For Defuse is defuse/php-encryption package required, _(*3)

Sample Configuration

you should provide two environment variables:, _(*4)

DOCTRINE_ENCRYPTED_OBJECT_KEY=xxx
DOCTRINE_ENCRYPTED_OBJECT_ENCRYPTION_WAY=sodium

The DOCTRINE_ENCRYPTED_OBJECT_ENCRYPTION_WAY variable is optional and has value sodium by default., _(*5)

The DOCTRINE_ENCRYPTED_OBJECT_KEY variable should be generated with the command:, _(*6)

bin/console jf:doctrine-encrypted-object:create-key {encryption_way}

where encryption way is one of sodium, openssl, defuse, _(*7)

Usage

Annotations

/**
 * @ORM\Column(name="your_secure_field", type="encoded_object")
 */
private $yourSecureField;

Attributes

use Jfnetwork\DoctrineEncryptedObject\DoctrineEncryptedObject;

#[ORM\Column(type: DoctrineEncryptedObject::TYPE_NAME)]
private $yourSecureField;

Upgrade from 2.0 to 3.0

You should set DOCTRINE_ENCRYPTED_OBJECT_ENCRYPTION_WAY environment variable to defuse. No other configuration is required. Some migration tool to other encryption ways will be provided later., _(*8)