The Clean Architecture in php

interface
GeocoderInterface {
public function
geocode
(
$address
);
}
Then, we’ll go ahead and make our controller depend only upon this interface:
class
AddressController
extends
AbstractController {
protected
$geocoder
;
public function
__construct
(GeocoderInterface
$geocoder
) {
$this
->
geocoder
=
$geocoder
;
}
public function
validateAddressAction
() {
$address
=
$this
->
vars
()
->
fromPost
(
'address'
);
$isValid
=
$this
->
geocoder
->
geocode
(
$address
)
!==
false
;
}
}
Finally, we’ll create an adapter to wrap
BillsGeocoder
and make it conform to our
GeocoderInterface
that is required by our
AddressController
class:
class
BillsGeocoderAdapter
implements
GeocoderInterface {
protected
$geocoder
;
public function
__construct
(BillsGeocoder
$geocoder
) {
$this
->
geocoder
=
$geocoder
;
}
public function
geocode
(
$address
) {
return
$this
->
geocoder
->
geocode
(
$address
);
}
}
In our
geocode()
method, we’re simply passing off the processing to our instance of
BillsGeocoder
,
which we take through the constructor.
We can use dependency injection to inject an instance of
BillsGeocoderAdapter
into our
AddressController
, which allows us to use a third party library but makes sure it conforms
to the interface we need.
How does this help?
This method of using adapters with third party libraries allows us to remain decoupled and free
from dependence on those third party libraries. It allows us to freely swap out those dependencies

---

Abstracting with Adapters
59
without having to rewrite any code that uses them, and it allows us to easily test our application
and its use of those dependences without actually having to test those dependencies ourselves.
We only have to test that we’re properly utilizing them.
We’ll later discuss the importance of External Agency Independence when we discuss The Clean
Architecture.

---