Skip to content
This repository was archived by the owner on Jan 29, 2020. It is now read-only.

Commit 268a50c

Browse files
committed
Documented changes in migration document.
1 parent 08a0cd4 commit 268a50c

File tree

1 file changed

+54
-0
lines changed

1 file changed

+54
-0
lines changed

doc/book/migration/to-v3-0.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,21 @@ your application configuration. Components are pushed to the top of the module
3434
list, while modules are pushed to the end. As a development component, it will
3535
not be installed in your production distributions.
3636

37+
## Updated dependencies
38+
39+
The v3 release now *requires*:
40+
41+
- zend-http
42+
- zend-modulemanager
43+
- zend-router
44+
- zend-view
45+
46+
Additionally, the following components require their v3 releases:
47+
48+
- zend-eventmanager
49+
- zend-servicemanager
50+
- zend-stdlib
51+
3752
## Application class
3853

3954
The following changes were made to the `Zend\Mvc\Application` constructor:
@@ -49,6 +64,20 @@ will not notice a change. Those who are directly instantiating the `Application`
4964
instance (in production or test code) or who have created their own factory for
5065
the class will need to update their code.
5166

67+
### send method
68+
69+
The `send()` method has been deprecated since the 2.2 release, and a no-op since
70+
then as well. It is removed starting with the v3 release.
71+
72+
## ControllerLoader
73+
74+
The `ControllerLoader` service was deprecated early in the v2 lifecycle, and
75+
aliased to `ControllerManager`. The `ControllerLoader` factory was kept to
76+
prevent BC breaks due to extending the class.
77+
78+
v3 removes the `ControllerLoaderFactory`, as well as the `ControllerLoader`
79+
service alias.
80+
5281
## DI-ServiceManager integration
5382

5483
The integration between [zend-servicemanager](https://zendframework.github.io/zend-servicemanager) and
@@ -71,6 +100,12 @@ $ composer require zendframework/zend-servicemanager-di
71100
The new component also contains a [migration document](https://zendframework.github.io/zend-servicemanager-di/migration/v2-to-v3/)
72101
detailing potential issues for users migrating to version 3.
73102

103+
## DispatchListener
104+
105+
The `marshallControllerNotFoundEvent()` method was deprecated early in the ZF2
106+
lifecycle, and has proxied to `marshalControllerNotFoundEvent()`. It is removed
107+
with the v3 release.
108+
74109
## Routing
75110

76111
Routing was removed from zend-mvc, and moved to a new component,
@@ -340,6 +375,19 @@ $ composer require zendframework/zend-serializer
340375
Note: the above assumes you have already installed zend-component-installer, per
341376
the section above on [dependency reduction](#dependency-reduction).
342377

378+
## ServiceLocatorAware initializers
379+
380+
Starting with zend-servicemanager v3, that component no longer defines the
381+
`ServiceLocatorAwareInterface`. Since zend-mvc pins against zend-servicemanager
382+
v3 with its own v3 release, the initializers that injected the application
383+
container into implementations of that interface are no longer relevant. As
384+
such, they have now been removed from each of the
385+
`Zend\Mvc\Service\ServiceManagerConfig` and
386+
`Zend\Mvc\Controller\ControllerManager` classes.
387+
388+
If you relied on this functionality, you are encouraged to update your code to
389+
use factories to inject your *actual* dependencies.
390+
343391
## Validator integration
344392

345393
In version 2, zend-mvc exposed a `ValidatorManager` service by default, and
@@ -356,3 +404,9 @@ $ composer require zendframework/zend-validator
356404

357405
Note: the above assumes you have already installed zend-component-installer, per
358406
the section above on [dependency reduction](#dependency-reduction).
407+
408+
## Zend\Mvc\View\SendResponseListener
409+
410+
`Zend\Mvc\View\SendResponseListener` was deprecated with the 2.2 release, and
411+
has been an extension of `Zend\Mvc\SendResponseListener` ever since. It is
412+
removed with the v3 release.

0 commit comments

Comments
 (0)