** This is a Patch Repository **
Since the zendframework/zend-stdlib hydrators were moved into their own repository, zendframework/zend-hydrator, the DoctrineModule repository has not been updated to correctly use the new library. Through many discussions on the issue @doctrineorm continues to maintain they are in line with zendframework/zend-hydrator because, very unusually, the new library was written to be backwards compatible with zendframework/zend-stdlib but that backwards compatibility was removed from zend-hydrator in later versions leaving developers who want to use Doctrine in their projects which allow for custom hydrators out on a limb.
Discussion on this issue:
- Jan 30, 2016: https://github.com/doctrine/DoctrineModule/pull/548
- Apr 7, 2016: https://github.com/doctrine/DoctrineModule/pull/558#issuecomment-207212246
Installation of this module uses composer. For composer documentation, please refer to getcomposer.org.
$ php composer.phar require api-skeletons/zf-doctrine-module-zend-hydrator ^1.0
composer.json file this library must be included before doctrine/doctrine-module. This ordering allows classes from this repository to override the DoctrineModule classes which are broken.
You may receive the following warnings. These are to be expected and are not a cause for concern.
Warning: Ambiguous class resolution, "DoctrineModule\Stdlib\Hydrator\DoctrineObject" was found in both "Projects/phpro/zf-doctrine-hydration-module/vendor/api-skeletons/zf-doctrine-module-zend-hydrator/src/DoctrineObject.php" and "/Projects/phpro/zf-doctrine-hydration-module/vendor/doctrine/doctrine-module/src/DoctrineModule/Stdlib/Hydrator/DoctrineObject.php", the first will be used. Warning: Ambiguous class resolution, "DoctrineModule\Stdlib\Hydrator\Filter\PropertyName" was found in both "/Projects/phpro/zf-doctrine-hydration-module/vendor/api-skeletons/zf-doctrine-module-zend-hydrator/src/Filter/PropertyName.php" and "/Projects/phpro/zf-doctrine-hydration-module/vendor/doctrine/doctrine-module/src/DoctrineModule/Stdlib/Hydrator/Filter/PropertyName.php", the first will be used. Warning: Ambiguous class resolution, "DoctrineModule\Stdlib\Hydrator\Strategy\AbstractCollectionStrategy" was found in both "/Projects/phpro/zf-doctrine-hydration-module/vendor/api-skeletons/zf-doctrine-module-zend-hydrator/src/Strategy/AbstractCollectionStrategy.php" and "/Projects/phpro/zf-doctrine-hydration-module/vendor/doctrine/doctrine-module/src/DoctrineModule/Stdlib/Hydrator/Strategy/AbstractCollectionStrategy.php", the first will be used.
When to use this Patch Repository
If you are using custom hydrators for your entities and you see errors like the following, this repository will correct them.
Argument 2 passed to Zend\Stdlib\Hydrator\AbstractHydrator::addStrategy() must be an instance of Zend\Stdlib\Hydrator\Strategy\StrategyInterface ...
This is a Patch Repository
If you would like to be involved in the conversation at DoctrineModule to help get zendframework/zend-hydrator implemented correctly in @doctrineorm repository you may contribute to the discussions linked above.
Finding this patch would not have been possible without the constant support of Toon Verwerft and his zf-doctrine-hydration-module. It took nearly six months to find a solution and he supported my efforts the whole time. Thank you Toon!