Download the PHP package somnambulist/value-object-doctrine-mappings without Composer
On this page you can find all versions of the php package somnambulist/value-object-doctrine-mappings. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download somnambulist/value-object-doctrine-mappings
More information about somnambulist/value-object-doctrine-mappings
Files in somnambulist/value-object-doctrine-mappings
Package value-object-doctrine-mappings
Short Description A collection of mapping files for the value-objects included in: somnambulist/value-objects
License MIT
Informations about the package value-object-doctrine-mappings
Moved to https://github.com/dave-redfern/somnambulist-domain
This repository has been archived. Please update to the combined package.s
Doctrine Mappings for Value Objects and Enumerations
Provides a basic set of mapping information for the somnambulist/value-objects library for use with Doctrine. Mappings are available for Doctrine (.dcm.yml) and Symfony (.orm.yml). The mappings are symlinked from symfony to doctrine.
A Bootstrapper
is included for automatically registering the value-object enumerations
as Doctrine types.
Requirements
- PHP 7+
- Doctrine ORM 2.5+
Installation
Install using composer, or checkout / pull the files from github.com.
- composer require somnambulist/value-object-doctrine-mappings
Usage
Copy or link the mapping files to your project in the Doctrine configuration. These are needed per entity manager. It is highly recommended to extend the value-objects to your own and then copy and adapt the mappings as you need.
Remember: value-objects are part of your domain model and should be treated with care.
Note: enumerations are used in these mappings.
Register Enumeration Handlers
To register the enumeration handlers add the following to your applications bootstrap code (e.g.: AppBundle::boot or AppServiceProvider::register|boot):
Somnambulist\Doctrine\Bootstrapper::registerEnumerations();
This will pre-register the following enumerations:
- Geography\CountryCode
- Geography\Srid
- Measure\AreaUnit
- Measure\DistanceUnit
- Money\CurrencyCode
In addition extra helpers are registered to allow the Country and Currency value objects
to be used as enumerations. These are stored using the CountryCode and CurrencyCode
values and restored using the ::create()
method.
Register Custom Types
Custom types are included for:
- datetime
- datetimetz
- date
- time
- json
- jsonb
- json_collection
The date types override the default Doctrine types and uses the VO DateTime that is an extended DateTimeImmutable object.
json, jsonb and json_collection are equivalent and allow JSON data to be converted to and from a Collection object instead of a plain array.
To register the types add the following to your application bootstrap:
Somnambulist\Doctrine\Bootstrapper::registerTypes();
Mapping Files
To use the types and enumerations, in your mapping files set the type appropriately:
To use the value-objects:
Or in XML format:
When using embeddables, be sure to have added the necessary mapping files.
Configuring Types for Symfony
Within a Symfony project, add a new mapping area to your orm configuration within the doctrine
section:
Then either copy or symlink the appropriate config files from vendor config folder to your projects mapping config section. If you have different requirements for field type, copy and update as appropriate. It is recommended to copy and not link the mapping files to avoid issues with this library changing.
Links
All versions of value-object-doctrine-mappings with dependencies
doctrine/dbal Version ^2.5
somnambulist/doctrine-enum-bridge Version ~1.0
somnambulist/value-objects Version ~1.3