Bez fasády

Fasáda je odporúčaná predvoľba, nie jediná cesta. Väčšina balíkov ponúka tri rovnocenné vstupné body — fasádu, manažér vložený cez konštruktor a jednoúčelové triedy akcií. google-places je klient vzdialeného API, preto triedy akcií nemá: prípady použitia sú priamo metódy klienta. Zostávajú teda dva:

• Fasáda GooglePlaces — najkratší zápis.
• Klient vložený cez konštruktor — rovnaké API s explicitnou závislosťou a bez statických volaní. Koreňom fasády je kontrakt RoundlyConsulting\GooglePlaces\Contracts\PlacesClient, zaregistrovaný ako singleton s implementáciou RoundlyConsulting\GooglePlaces\Places.

Vloženie klienta

Fasáda aj kontrakt vedú na ten istý singleton a GooglePlaces::fake() nahradí oba — v kóde, ktorý chcete v testoch nahradiť, preto typujte kontrakt, nie konkrétnu triedu Places:

use RoundlyConsulting\GooglePlaces\Contracts\PlacesClient;

final class NearbyCafes
{
    public function __construct(private PlacesClient $places) {}

    public function __invoke(string $query): array
    {
        return $this->places->textSearch($query)->all();
    }
}

Handles vytvorené vloženým klientom volajú späť práve tento klient, takže aj ony sa v testoch nahradia:

use RoundlyConsulting\GooglePlaces\Contracts\PlacesClient;

final class PlacePhotos
{
    public function __construct(private PlacesClient $places) {}

    public function hero(string $placeId): ?string
    {
        $place = $this->places->details($placeId);

        if ($place === null || $place->photos === []) {
            return null;
        }

        return $this->places->photo($place->photos[0])->url();
    }
}

Metóda fasády → metóda klienta

Každé volanie fasády zodpovedá presne jednej rovnomennej metóde PlacesClient: