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

Commit

Permalink
Updated CHANGELOG to reference exception changes
Browse files Browse the repository at this point in the history
  • Loading branch information
weierophinney committed Sep 21, 2015
1 parent c4b3877 commit b751729
Showing 1 changed file with 29 additions and 24 deletions.
53 changes: 29 additions & 24 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,30 +32,35 @@ All notable changes to this project will be documented in this file, in reverse
removed entirely from zend-stdlib in v3.0, and all future updates to hydrators
will occur in the zend-hydrator library.

One change is **backwards-incompatible**: Users implementing
`Zend\Stdlib\Hydrator\HydratorAwareInterface` will need to update their
`setHydrator()` implementation to typehint on
`Zend\Hydrator\HydratorInterface`. This can be done by changing the import
statement for that interface as follows:

```php
// Replace this:
use Zend\Stdlib\Hydrator\HydratorInterface;
// with this:
use Zend\Hydrator\HydratorInterface;
```

If you are not using imports, change the typehint within the signature itself:

```php
// Replace this:
public function setHydrator(\Zend\Stdlib\Hydrator\HydratorInterface $hydrator)
// with this:
public function setHydrator(\Zend\Hydrator\HydratorInterface $hydrator)
```

If you are using `Zend\Stdlib\Hydrator\HydratorAwareTrait`, no changes are
necessary, unless you override that method.
Changes with backwards compatibility implications:

- Users implementing `Zend\Stdlib\Hydrator\HydratorAwareInterface` will need to
update their `setHydrator()` implementation to typehint on
`Zend\Hydrator\HydratorInterface`. This can be done by changing the import
statement for that interface as follows:

```php
// Replace this:
use Zend\Stdlib\Hydrator\HydratorInterface;
// with this:
use Zend\Hydrator\HydratorInterface;
```

If you are not using imports, change the typehint within the signature itself:

```php
// Replace this:
public function setHydrator(\Zend\Stdlib\Hydrator\HydratorInterface $hydrator)
// with this:
public function setHydrator(\Zend\Hydrator\HydratorInterface $hydrator)
```

If you are using `Zend\Stdlib\Hydrator\HydratorAwareTrait`, no changes are
necessary, unless you override that method.

- If you were catching hydrator-generated exceptions, these were previously in
the `Zend\Stdlib\Exception` namespace. You will need to update your code to
catch exceptions in the `Zend\Hydrator\Exception` namespace.

### Removed

Expand Down

0 comments on commit b751729

Please sign in to comment.