Download the PHP package mpalourdio/mpa-custom-doctrine-hydrator without Composer

MpaCustomDoctrineHydrator

Module that helps you deal with date/datetime/time for DoctrineORMModule & ZF2 : filtering, hydration, Locale etc. Extends and replace the ZF2 Date Element, ZF2 DateTime Element, ZF2 Time Element to make them compliant 'out-of-the-box' with doctrine hydration.

Provides an extension of the DoctrineORMModule and a factory for more ease. The is overridden too in order to better suit needs regarding filtering and validation.

The filters and the elements can be used as standalone. Using the provided elements via the adds automatic conversion formats for date/date and time/time strings to . Automatic filtering and validation are provided regarding the date format (Y-m-d, Y-m-d H:i:s, H:i:s, etc.) that depends of the . A placeholder is added to your form element too when rendered.

The hydrator service adds a strategy to every date column in your entity for extraction and hydration.

Requirements

PHP 7.0+ - Only Composer installation supported

Installation

Run the command below to install via Composer

Add "MpaCustomDoctrineHydrator" to your modules list in application.config.php

Configuration

Copy mpacustomdoctrinehydrator.config.global.php.dist in your autoload folder and rename it by removing the .dist extension.

Add your own date / time formats (if needed) that are compliant with php

see http://www.php.net/manual/fr/datetime.createfromformat.php

Usage (the easy and lazy way)

Create your forms with the provided annotation builder.

Or with the factory

Then, hydrate your form

You're done! Date/Date & Time/ Time colums will be hydrated/extracted, filtered and validated automatically, without providing anything else in your entities. Your form elements will be rendered with a placeholder.

Usage (the hard and decoupled way)

In your forms classes, when not using the :

If you pull your forms from the , just grab the element as a or . The format option is not needed here, config will be pulled from service config.

You can too use the filter as standalone on other form elements with custom formats, if needed. For this, use the filter FQCN.

If you use the filter shortname (), the config will be pulled from the service config (ie. The options array will be ignored).

or simply

/!\ If you don't create your fieldsets/forms via the , you must manually inject the SL so the element can fetch the configuration

/!\ Tip : To use the filter short name in a form grabbed without the , you must do the following :

You can use the provided strategy as standalone with your hydrators too. Date Time and Time handling work the same way as the example above, with only few changes, like the 'format' keys names.