@weierophinney weierophinney released this Dec 10, 2018 · 1 commit to master since this release

Assets 2

Added

  • #87 adds Zend\Hydrator\HydratorPluginManagerInterface to allow
    type-hinting on plugin manager implementations. The interface simply extends
    the PSR-11 ContainerInterface.

  • #87 adds Zend\Hydrator\StandaloneHydratorPluginManager as an implementation
    of each of Psr\Container\ContainerInterface and Zend\Hydrator\HydratorPluginManagerInterface,
    along with a factory for creating it, Zend\Hydrator\StandaloneHydratorPluginManagerFactory.
    It can act as a replacement for Zend\Hydrator\HydratorPluginManager, but
    only supports the shipped hydrator implementations. See the plugin manager documentation
    for more details on usage.

  • #79 adds a third, optional parameter to the DateTimeFormatterStrategy constructor.
    The parameter is a boolean, and, when enabled, a string that can be parsed by
    the DateTime constructor will still result in a DateTime instance during
    hydration, even if the string does not follow the provided date-time format.

  • #14 adds the following final classes:

    • \Zend\Hydrator\NamingStrategy\UnderscoreNamingStrategy\UnderscoreToCamelCaseFilter
    • \Zend\Hydrator\NamingStrategy\UnderscoreNamingStrategy\CamelCaseToUnderscoreFilter

Changed

  • #89 renames the various hydrators to use the "Hydrator" suffix:

    • ArraySerializable becomes ArraySerializableHydrator
    • ClassMethods becomes ClassMethodsHydrator
    • ObjectProperty becomes ObjectPropertyHydrator
    • Reflection becomes ReflectionHydrator
      In each case, the original class was re-added to the repository as a
      deprecated extension of the new class, to be removed in version 4.0.0.

    Aliases resolving the original class name to the new class were also added to
    the HydratorPluginManager to ensure you can still obtain instances.

  • #87 modifies Zend\Hydrator\ConfigProvider to add a factory entry for
    Zend\Hydrator\StandaloneHydratorPluginManager.

  • #87 modifies Zend\Hydrator\ConfigProvider to change the target of the
    HydratorManager alias based on the presence of the zend-servicemanager
    package; if the package is not available, the target points to
    Zend\Hydrator\StandaloneHydratorPluginManager instead of
    Zend\Hydrator\HydratorPluginManager.

  • #83 renames Zend\Hydrator\FilterEnabledInterface to Zend\Hydrator\Filter\FilterEnabledInterface (new namespace).

  • #83 renames Zend\Hydrator\NamingStrategyEnabledInterface to Zend\Hydrator\NamingStrategy\NamingStrategyEnabledInterface (new namespace).

  • #83 renames Zend\Hydrator\StrategyEnabledInterface to Zend\Hydrator\Strategy\StrategyEnabledInterface (new namespace).

  • #82 and #85 change Zend\Hydrator\NamingStrategy\MapNamingStrategy
    in the following ways:

    • The class is now marked final.
    • The constructor is marked private. You can no longer instantiate it directly.
    • The class offers three new named constructors; one of these MUST be used to
      create an instance, as the constructor is now final:
      • MapNamingStrategy::createFromExtractionMap(array $extractionMap) : MapNamingStrategy
        will use the provided extraction map for extraction operations, and flip it
        for hydration operations.
      • MapNamingStrategy::createFromHydrationMap(array $hydrationMap) : MapNamingStrategy
        will use the provided hydration map for hydration operations, and flip it
        for extraction operations.
      • MapNamingStrategy::createFromAssymetricMap(array $extractionMap, array $hydrationMap) : MapNamingStrategy
        will use the appropriate map based on the requested operation.
  • #80 bumps the minimum supported PHP version to 7.2.

  • #80 bumps the minimum supported zend-eventmanager version to 3.2.1. zend-eventmanager
    is only required if you are using the AggregateHydrator.

  • #80 bumps the minimum supported zend-serializer version to 2.9.0. zend-serializer is
    only required if you are using the SerializableStrategy.

  • #80 bumps the minimum supported zend-servicemanager version to 3.3.2.
    zend-servicemanager is only required if you are using the
    HydratorPluginManager or DelegatingHydrator. This change means that
    some service names supported by zend-servicemanager v2 will no longer work.
    When in doubt, use the fully qualified class name, or the class name minus the
    namespace, with correct casing.

  • #80 adds scalar typehints both to parameters and return values, and object
    typehints to parameters, wherever possible. For consumers, this should pose no
    discernable change. For those implementing interfaces or extending classes
    from this package, updates will be necessary to ensure your code will run.

    See the migration guide for details.

  • #14 replaces usage of zend-filter with the hardcoded filters referenced in
    the above section.

  • #14 made the following visibility changes to \Zend\Hydrator\NamingStrategy\UnderscoreNamingStrategy:

    • static property $underscoreToStudlyCaseFilter was renamed to $underscoreToCamelCaseFilter and marked private
    • static property $camelCaseToUnderscoreFilter was marked private
    • method getCamelCaseToUnderscoreFilter was marked private
    • method getUnderscoreToStudlyCaseFilter was renamed to getUnderscoreToCamelCaseFilter and marked private

Deprecated

  • #89 and
    #93 deprecate the
    following classes, which will be removed in 4.0.0:
    • Zend\Hydrator\ArraySerializable (becomes ArraySerializableHydrator)
    • Zend\Hydrator\ClassMethods (becomes ClassMethodsHydrator)
    • Zend\Hydrator\ObjectProperty (becomes ObjectPropertyHydrator)
    • Zend\Hydrator\Reflection (becomes ReflectionHydrator)

Removed

  • #83 removes the constructor in Zend\Hydrator\AbstractHydrator. All
    initialization is now either performed via property definitions or lazy-loading.

  • #82 removes Zend\Hydrator\NamingStrategy\ArrayMapNamingStrategy. The functionality
    it provided has been merged into Zend\Hydrator\NamingStrategy\MapNamingStrategy;
    use MapNamingStrategy::createFromExtractionMap() to create an instance that
    has the same functionality as ArrayMapNamingStrategy previously provided.

Fixed

  • Nothing.

@weierophinney weierophinney released this Nov 19, 2018 · 112 commits to master since this release

Assets 2

Added

  • Nothing.

Changed

  • #69 adds support for special pre/post characters in formats passed to the
    DateTimeFormatterStrategy. When used, the DateTime instances created
    during hydration will (generally) omit the time element, allowing for more
    accurate comparisons.

Deprecated

  • Nothing.

Removed

  • Nothing.

Fixed

  • Nothing.

@weierophinney weierophinney released this Apr 30, 2018 · 128 commits to master since this release

Assets 2

Added

  • #70 updates the DateTimeFormatterStrategy to work with any DateTimeInterface,
    and not just DateTime.

Changed

  • #75 ensures continuous integration requires PHP 7.2 tests to pass;
    they already were.

Deprecated

  • Nothing.

Removed

  • Nothing.

Fixed

  • Nothing.

@weierophinney weierophinney released this Oct 2, 2017 · 170 commits to master since this release

Assets 2

Added

  • Nothing.

Changed

  • Nothing.

Deprecated

  • Nothing.

Removed

  • Nothing.

Fixed

  • #67 fixes an issue in the ArraySerializable::hydrate() logic whereby nested array data was merged instead of replaced during hydration. The hydrator now correctly replaces such data.

@weierophinney weierophinney released this Sep 20, 2017 · 175 commits to master since this release

Assets 2

Added

  • #27 adds the interface Zend\Hydrator\HydratorProviderInterface for use with the zend-modulemanager ServiceListener implementation, and updates the HydratorManager definition for the ServiceListener to typehint on this new interface instead of the one provided in zend-modulemanager.

    Users implementing the zend-modulemanager Zend\ModuleManger\Feature\HydratorProviderInterface will be unaffected, as the method it defines, getHydratorConfig(), will still be identified and used to inject he HydratorPluginManager. However, we recommend updating your Module classes to use the new interface instead.

  • #44 adds Zend\Hydrator\Strategy\CollectionStrategy. This class allows you to provide a single hydrator to use with an array of objects or data that represent the same type.

    From the patch, if the "users" property of an object you will hydrate is expected to be an array of items of a type User, you could do the following:

    $hydrator->addStrategy('users', new CollectionStrategy(
        new ReflectionHydrator(),
        User::class
    ));
  • #63 adds support for PHP 7.2.

Changed

  • #44 updates the ClassMethods hydrator to add a second, optional, boolean argument to the constructor, $methodExistsCheck, and a related method setMethodExistsCheck(). These allow you to specify a flag indicating whether or not the name of a property must directly map to a defined method, versus one that may be called via __call(). The default value of the flag is false, which retains the previous behavior of not checking if the method is defined. Set the flag to true to make the check more strict.

Deprecated

  • Nothing.

Removed

  • #63 removes support for HHVM.

Fixed

  • Nothing.

@weierophinney weierophinney released this Sep 20, 2017 · 211 commits to master since this release

Assets 2

Added

  • Nothing.

Changed

  • Nothing.

Deprecated

  • Nothing.

Removed

  • Nothing.

Fixed

  • #65 fixes the hydration behavior of the ArraySerializable hydrator when using exchangeArray(). Previously, the method would clear any existing values from the instance, which is problematic when a partial update is provided as values not in the update would disappear. The class now pulls the original values, and recursively merges the replacement with those values.

@weierophinney weierophinney released this May 17, 2017 · 222 commits to master since this release

Assets 2

Added

  • Nothing

Changes

  • #42 updates the ConfigProvider::getDependencies() method to map the HydratorPluginManager class to the HydratorPluginManagerFactory class, and make the HydratorManager service an alias to the fully-qualified HydratorPluginManager class.
  • #45 changes the ClassMethods hydrator to take into account naming strategies when present, making it act consistently with the other hydrators.

Deprecated

  • Nothing.

Removed

  • Nothing.

Fixed

  • #59 fixes how the HydratorPluginManagerFactory factory initializes the plugin manager instance, ensuring it is injecting the relevant configuration from the config service and thus seeding it with configured hydrator services. This means that the hydrators configuration will now be honored in non-zend-mvc contexts.

@weierophinney weierophinney released this Apr 18, 2016 · 303 commits to master since this release

Assets 2

Added

  • Nothing.

Deprecated

  • Nothing.

Removed

  • Nothing.

Fixed

  • #28 fixes the Module::init() method to properly receive a ModuleManager instance, and not expect a ModuleEvent.

@weierophinney weierophinney released this Apr 6, 2016 · 317 commits to master since this release

Assets 2

Added

  • #26 exposes the package as a ZF component and/or generic configuration provider, by adding the following:
    • HydratorPluginManagerFactory, which can be consumed by container-interop / zend-servicemanager to create and return a HydratorPluginManager instance.
    • ConfigProvider, which maps the service HydratorManager to the above factory.
    • Module, which does the same as ConfigProvider, but specifically for zend-mvc applications. It also provices a specification to Zend\ModuleManager\Listener\ServiceListener to allow modules to provide hydrator configuration.

Deprecated

  • Nothing.

Removed

  • Nothing.

Fixed

  • Nothing.

@weierophinney weierophinney released this Feb 18, 2016 · 335 commits to master since this release

Assets 2

Added

Deprecated

  • Nothing.

Removed

  • Nothing.

Fixed

  • #6 add additional unit test coverage
  • #17 and #23 update the code to be forwards compatible with zend-servicemanager v3, and to depend on zend-stdlib and zend-eventmanager v3.