# Changelog

All notable changes to this project will be documented in this file, in reverse chronological order by release.

## 2.7.15 - 2018-05-03

### Added

- Nothing.

### Changed

- [zendframework/zend-mvc#245](https://github.com/zendframework/zend-mvc/pull/245) moves the laminas-console dependency from `require-dev` to `require`, as it is
  a requirement of the `RequestFactory`, and removal of the package causes that factory to fail.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- Nothing.

## 2.7.14 - 2018-05-02

### Added

- [zendframework/zend-mvc#279](https://github.com/zendframework/zend-mvc/pull/279) provides support for PHP 7.1 and 7.2.

### Changed

- [zendframework/zend-mvc#279](https://github.com/zendframework/zend-mvc/pull/279) changes the `Laminas\Mvc\Controller\PluginManager` implementation to vary
  based on laminas-servicemanager major version detected in order to ensure the
  signature of `get()` will be correct regardless of version.

### Deprecated

- Nothing.

### Removed

- [zendframework/zend-mvc#279](https://github.com/zendframework/zend-mvc/pull/279) removes explicit support for PHP 5.5.
  The code may, and likely will, continue to run on the 5.5 series, but we are
  unable to continue testing it at this time as dependencies necessary for PHP
  7.2 support have all bumped their minimum versions to PHP 5.6. If you use PHP
  5.5, upgrade at your own risk.

### Fixed

- Nothing.

## 2.7.13 - 2017-12-14

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- Updates the `Laminas\Mvc\Controller\PluginManager::get()` signature to match
  that of `Laminas\ServiceManager\AbstractPluginManager::get()`, and thus ensure
  compatibility when running under PHP 7.2.

- [zendframework/zend-mvc#234](https://github.com/zendframework/zend-mvc/pull/234) fixes docblock
  annotations in `AbstractActionController::indexAction` and `notFoundAction` to
  indicate they return a `ViewModel|ConsoleModel` and not `array`.

## 2.7.12 - 2017-04-27

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#235](https://github.com/zendframework/zend-mvc/pull/235) fixes
  `FormAnnotationBuilderFactory::injectFactory()` to pass the correct
  arguments to the plugin manager's `injectFactory()` initializer when running
  under laminas-servicemanager v2.

## 2.7.11 - 2017-04-27

### Added

- [zendframework/zend-mvc#233](https://github.com/zendframework/zend-mvc/pull/233) adds a `replace`
  entry to the `composer.json` indicating the package replaces
  zendframework/zend-router. This is done to prevent errors from installing both
  zend-mvc v2 with zend-router, which could lead to subtle errors when checking
  exceptions, locating route types, etc. Users should upgrade to zend-mvc v3 if
  they wish to use the standalone zend-router package.

### Deprecated

- Nothing.

### Removed

- [zendframework/zend-mvc#229](https://github.com/zendframework/zend-mvc/pull/229) removes the
  zend-version package from the `require-dev` and `suggest` sections of
  `composer.json`, and updates the `RouteNotFoundStrategy::getConsoleBanner()`
  method to no longer use the version constant. Since zend-version has had no
  real meaning since the 2.5 release, this removes ambiguity for end-users.

### Fixed

- [zendframework/zend-mvc#223](https://github.com/zendframework/zend-mvc/pull/223) fixes how the
  `FormAnnotationBuilderFactory` injects the builder with the
  `FormElementManager` service such that it will work with the latest laminas-form
  releases.

## 2.7.10 - 2016-06-13

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- [zendframework/zend-mvc#159](https://github.com/zendframework/zend-mvc/pull/159) removes the
  dependency on laminas-servicemanager-di.

### Fixed

- [zendframework/zend-mvc#159](https://github.com/zendframework/zend-mvc/pull/159) fixes issues with
  regards to conflicts between laminas-servicemanager v2 and
  laminas-servicemanager-di by re-instating code removed from various
  servicemanager/DI-related factories in 2.7.9. Two factories,
  `Laminas\Mvc\Service\DiAbstractServiceFactoryFactory` and
  `Laminas\Mvc\Service\DiServiceInitializerFactory`, now raise exceptions if they
  detect they are running under laminas-servicemanager v3, and prompt the developer
  to install laminas-servicemanager-di.

## 2.7.9 - 2016-06-11

### Added

- [zendframework/zend-mvc#149](https://github.com/zendframework/zend-mvc/pull/149) and
  [zendframework/zend-mvc#158](https://github.com/zendframework/zend-mvc/pull/158) add a dependency
  on laminas/laminas-servicemanager-di in order to provide both backwards and
  forwards compatibility for the DI/ServiceManager integration.

### Deprecated

- [zendframework/zend-mvc#158](https://github.com/zendframework/zend-mvc/pull/158) deprecates each of
  the following classes, which now have equivalents in the
  laminas-servicemanager-di package (which is required by laminas-mvc v2, but optional
  starting with laminas-mvc v3):
  - `Laminas\Mvc\Service\DiAbstractServiceFactoryFactory`
  - `Laminas\Mvc\Service\DiFactory`
  - `Laminas\Mvc\Service\DiServiceInitializerFactory`
  - `Laminas\Mvc\Service\DiStrictAbstractServiceFactory`
  - `Laminas\Mvc\Service\DiStrictAbstractServiceFactoryFactory`
- [zendframework/zend-mvc#152](https://github.com/zendframework/zend-mvc/pull/152) formally marks the
  `ControllerLoaderFactory` as deprecated via annotation (though it has been
  noted as such in the documentation for several years). Use
  `Laminas\Mvc\Service\ControllerManagerFactory` instead.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#149](https://github.com/zendframework/zend-mvc/pull/149) and
  [zendframework/zend-mvc#158](https://github.com/zendframework/zend-mvc/pull/158) fix an "undefined
  variable" issue with `Laminas\Mvc\Service\DiAbstractServiceFactoryFactory`.
- [zendframework/zend-mvc#153](https://github.com/zendframework/zend-mvc/pull/153) removes the
  typehint from the `$exception` argument of `DispatchListener::marshalBadControllerEvent()`,
  fixing an issue when PHP 7 Error types are caught and passed to the method.

## 2.7.8 - 2016-05-31

### Added

- [zendframework/zend-mvc#138](https://github.com/zendframework/zend-mvc/pull/138) adds support for
  PHP 7 `Throwable`s within each of:
  - `DispatchListener`
  - `MiddlewareListener`
  - The console `RouteNotFoundStrategy` and `ExceptionStrategy`
  - The HTTP `DefaultRenderingStrategy` and `RouteNotFoundStrategy`

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- Nothing.

## 2.7.7 - 2016-04-12

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#122](https://github.com/zendframework/zend-mvc/pull/122) fixes the
  `FormAnnotationBuilderFactory` to use the container's `get()` method instead
  of `build()` to retrieve the event manager instance.

## 2.7.6 - 2016-04-06

### Added

- [zendframework/zend-mvc#94](https://github.com/zendframework/zend-mvc/pull/94) adds a documentation
  recipe for using middleware withing MVC event listeners.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#107](https://github.com/zendframework/zend-mvc/pull/107) fixes an incorrect
  import statement in the `DiStrictAbstractServiceFactoryFactory` that prevented
  it from working.
- [zendframework/zend-mvc#112](https://github.com/zendframework/zend-mvc/pull/112) fixes how the
  `Forward` plugin detects and detaches event listeners to ensure it works
  against either v2 or v3 releases of laminas-eventmanager.

## 2.7.5 - 2016-04-06

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#111](https://github.com/zendframework/zend-mvc/pull/111) fixes a bug in how
  the `ConsoleExceptionStrategyFactory` whereby it was overwriting the default
  exception message template with an empty string when no configuration for it
  was provided.

## 2.7.4 - 2016-04-03

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#114](https://github.com/zendframework/zend-mvc/pull/114) fixes an issue in
  the `ServiceLocatorAware` initializer whereby plugin manager instances were
  falsely identified as the container instance when under laminas-servicemanager v2.

## 2.7.3 - 2016-03-08

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#97](https://github.com/zendframework/zend-mvc/pull/97) re-introduces the
  `ServiceManager` factory definition inside `ServiceManagerConfig`, to ensure
  backwards compatibility.

## 2.7.2 - 2016-03-08

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#95](https://github.com/zendframework/zend-mvc/pull/95) re-introduces the
  various laminas-di aliases and factories in `Laminas\Mvc\Service\ServiceListenerFactory`,
  which were accidently removed in the 2.7.0 release.
- [zendframework/zend-mvc#96](https://github.com/zendframework/zend-mvc/pull/96) fixes shared event
  detachment/attachment within the `Forward` plugin to work with both v2 and v3
  of laminas-eventmanager.
- [zendframework/zend-mvc#93](https://github.com/zendframework/zend-mvc/pull/93) ensures that the
  Console `Catchall` route factory will not fail when the `defaults` `$options`
  array key is missing.
- [zendframework/zend-mvc#43](https://github.com/zendframework/zend-mvc/pull/43) updates the
  `AbstractRestfulController` to ensure it can accept textual (e.g., XML, YAML)
  data.
- [zendframework/zend-mvc#79](https://github.com/zendframework/zend-mvc/pull/79) updates the
  continuous integration configuration to ensure we test against lowest and
  highest accepted dependencies, and those in the current lockfile.

## 2.7.1 - 2016-03-02

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#88](https://github.com/zendframework/zend-mvc/pull/88) addresses backwards
  compatibility concerns raised by users due to the new deprecation notices
  emitted by `ServiceLocatorAware` initializers; in particular, all
  `AbstractController` implementations were raising a deprecation wen first
  pulled from the `ControllerManager`.
  
  At this time, notices are now only raised in the following conditions:

  - When a non-controller, non-plugin manager, `ServiceLocatorAware` instance
    is detected.
  - When a plugin manager instance is detected that is `ServiceLocatorAware` and
    does not have a composed service locator. In this situation, the deprecation
    notice indicates that the factory for the plugin manager should be updated
    to inject the service locator via the constructor.
  - For controllers that do not extend `AbstractController` but do implement
    `ServiceLocatorAware`.
  - When calling `getServiceLocator()` from within an `AbstractController`
    extension; this properly calls out the practice that should be avoided and
    which requires updates to the controller.

## 2.7.0 - 2016-03-01

### Added

- [zendframework/zend-mvc#31](https://github.com/zendframework/zend-mvc/pull/31) adds three new
  optional arguments to the `Laminas\Mvc\Application` constructor: an EventManager
  instance, a Request instance, and a Response instance.
- [zendframework/zend-mvc#36](https://github.com/zendframework/zend-mvc/pull/36) adds more than a
  dozen service factories, primarily to separate conditional factories into
  discrete factories.
- [zendframework/zend-mvc#32](https://github.com/zendframework/zend-mvc/pull/32) adds
  `Laminas\Mvc\MiddlewareListener`, which allows dispatching PSR-7-based middleware
  implementing the signature `function (ServerRequestInterface $request,
  ResponseInterface $response)`. To dispatch such middleware, point the
  `middleware` "default" for a given route to a service name or callable that
  will resolve to the middleware:

  ```php
  [ 'router' => 'routes' => [
      'path' => [
          'type' => 'Literal',
          'options' => [
              'route' => '/path',
              'defaults' => [
                  'middleware' => 'ServiceNameForPathMiddleware',
              ],
          ],
      ],
  ]
  ```

  This new listener listens at the same priority as the `DispatchListener`, but,
  due to being registered earlier, will invoke first; if the route match does
  not resolve to middleware, it will fall through to the original
  `DispatchListener`, allowing normal Laminas-style controller dispatch.
- [zendframework/zend-mvc#84](https://github.com/zendframework/zend-mvc/pull/84) publishes the
  documentation to https://docs.laminas.dev/laminas-mvc/

### Deprecated

- Two initializers registered by `Laminas\Mvc\Service\ServiceManagerConfig` are now
  deprecated, and will be removed starting in version 3.0:
  - `ServiceManagerAwareInitializer`, which injects classes implementing
    `Laminas\ServiceManager\ServiceManagerAwareInterface` with the service manager
    instance. Users should create factories for such classes that directly
    inject their dependencies instead.
  - `ServiceLocatorAwareInitializer`, which injects classes implementing
    `Laminas\ServiceManager\ServiceLocatorAwareInterface` with the service manager
    instance. Users should create factories for such classes that directly
    inject their dependencies instead.

### Removed

- `Laminas\Mvc\Controller\AbstractController` no longer directly implements
  `Laminas\ServiceManager\ServiceLocatorAwareInterface`, but still implements the
  methods defined in that interface. This was done to provide
  forwards-compatibility, as laminas-servicemanager v3 no longer defines the
  interface. All initializers that do `ServiceLocatorInterface` injection were
  updated to also inject when just the methods are present.

### Fixed

- [zendframework/zend-mvc#31](https://github.com/zendframework/zend-mvc/pull/31) and
  [zendframework/zend-mvc#76](https://github.com/zendframework/zend-mvc/pull/76) update the component
  to be forwards-compatible with laminas-eventmanager v3.
- [zendframework/zend-mvc#36](https://github.com/zendframework/zend-mvc/pull/36),
  [zendframework/zend-mvc#76](https://github.com/zendframework/zend-mvc/pull/76),
  [zendframework/zend-mvc#80](https://github.com/zendframework/zend-mvc/pull/80),
  [zendframework/zend-mvc#81](https://github.com/zendframework/zend-mvc/pull/81), and
  [zendframework/zend-mvc#82](https://github.com/zendframework/zend-mvc/pull/82) update the component
  to be forwards-compatible with laminas-servicemanager v3. Several changes were
  introduced to support this effort:
  - Added a `RouteInvokableFactory`, which can act as either a
    `FactoryInterface` or `AbstractFactoryInterface` for loading invokable route
    classes, including by fully qualified class name. This is registered as an
    abstract factory by default with the `RoutePluginManager`.
  - The `DispatchListener` now receives the controller manager instance at
    instantiation.
  - The `ViewManager` implementations were updated, and most functionality
    within separated into discrete factories.

## 2.6.3 - 2016-02-23

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#74](https://github.com/zendframework/zend-mvc/pull/74) fixes the
  `FormAnnotationBuilderFactory`'s usage of the
  `FormElementManager::injectFactory()` method to ensure it works correctly on
  all versions.

## 2.6.2 - 2016-02-22

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#71](https://github.com/zendframework/zend-mvc/pull/71) fixes the
  `ViewHelperManagerFactory` to be backwards-compatible with v2 by ensuring that
  the factories for each of the `url`, `basepath`, and `doctype` view helpers
  are registered using the fully qualified class names present in
  `Laminas\View\HelperPluginManager`; these changes ensure requests for these
  helpers resolve to these override factories, instead of the
  `InvokableFactory`.

## 2.6.1 - 2016-02-16

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#69](https://github.com/zendframework/zend-mvc/pull/69) largely reverts
  [zendframework/zend-mvc#30](https://github.com/zendframework/zend-mvc/pull/30), having the component
  utilize the `HydratorPluginManager` from laminas-stdlib 2.7.5. This was done to
  provide backwards compatibility; while laminas-stdlib Hydrator types can be used
  in place of laminas-hydrator types, the reverse is not true.

  You can make your code forwards-compatible with version 3, where the
  `HydratorPluginManager` will be pulled from laminas-hydrator, by updating your
  typehints to use the laminas-hydrator classes instead of those from laminas-stdlib;
  the instances returned from the laminas-stdlib `HydratorPluginManager`, because
  they extend those from laminas-hydrator, remain compatible. 

## 2.6.0 - 2015-09-22

### Added

- [zendframework/zend-mvc#30](https://github.com/zendframework/zend-mvc/pull/30) updates the component
  to use laminas-hydrator for hydrator functionality; this provides forward
  compatibility with laminas-hydrator, and backwards compatibility with
  hydrators from older versions of laminas-stdlib.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- Nothing.

## 2.5.3 - 2015-09-22

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#29](https://github.com/zendframework/zend-mvc/pull/29) updates the
  laminas-stdlib dependency to reference `>=2.5.0,<2.7.0` to ensure hydrators
  will work as expected following extraction of hydrators to the laminas-hydrator
  repository.

## 2.5.2 - 2015-09-14

### Added

- Nothing.

### Deprecated

- Nothing.

### Removed

- Nothing.

### Fixed

- [zendframework/zend-mvc#27](https://github.com/zendframework/zend-mvc/pull/27) fixes a condition
  where non-view model results from controllers could cause errors to be
  raisedin the `DefaultRenderingStrategy`.