This document discusses dependency inversion in PHP using composer and virtual packages. It describes how a developer can create an API client that depends on abstractions rather than specific implementations by using virtual packages. This allows the client code to remain decoupled from the underlying HTTP client implementation and avoid version conflicts. The document provides examples of how to declare a virtual package in composer.json that implements interfaces from packages like HTTP-Plug, and how clients can then require the virtual package to gain the benefits of abstraction and flexibility in choosing implementations.

1. Dependency Inversion w PHP

2. O MNIE
Rafał Kański
Software Engineer w Schibsted Tech Polska
http://blogophp.com

3. ZACZYNAMY...

4. TYPOWY DZIEŃ PRACY...
Pobieranie artykułów ze strony artykuly.pl
ZADANIE:

5. TYPOWY DZIEŃ PRACY...
DOBRA WIADOMOŚĆ:
Strona oferuje klienta do pobierania artykułów

6. TYPOWY DZIEŃ PRACY...
LEPSZA WIADOMOŚĆ:
Klienta można zainstalować composerem

7. INSTALUJEMY...
COMPOSER.JSON
{
"name": "application/my-app",
"description": “Project",
"minimum-stability": "stable",
"require": {
"artykuly/api-client": "^1.2"
}
}

8. TYPOWY DZIEŃ PRACY...
Zapisywanie danych z rssowego feeda feed.pl
KOLEJNE ZADANIE:

9. TYPOWY DZIEŃ PRACY...
DOBRA WIADOMOŚĆ:
Do pobierania feeda można użyć prostego klienta

10. TYPOWY DZIEŃ PRACY...
LEPSZA WIADOMOŚĆ:
Klienta do feeda można zainstalować composerem

11. INSTALUJEMY...
COMPOSER.JSON
{
"name": "application/my-app",
"description": “Project",
"minimum-stability": "stable",
"require": {
"artykuly/api-client": "^1.2",
"feed/api-client": "^2.1"
}
}

12. POTENCJALNE ZAGROŻENIE
TYPOWY DZIEŃ PRACY...

13. APLIKACJA
JEDNA APLIKACJA WIELE KLIENTÓW API
KLIENT API
KLIENT API
KLIENT API
KLIENT API
JSON
XML
OAUTH
SAML

14. KLIENT API
KLIENT API POD MASKĄ
KLIENT HTTP
WŁASNY GOTOWYCZY

15. KLIENT API
TO JESZCZE NIE JEST PROBLEM...
KLIENT HTTP
GOTOWY

16. JEDEN KLIENT API
PROBLEM POJAWIA SIĘ GDY...
GUZZLE
^5.3
DRUGI KLIENT API
GUZZLE
^6.2

17. JAKO TWÓRCA KLIENTA API
“Uzależniaj kod od abstrakcji a
nie od klas rzeczywistych”
Dependency Inversion

18. JAKO TWÓRCA KLIENTA API
{
"name": "somename/api-client",
"description": "API Client",
"minimum-stability": "stable",
"require": {
"guzzlehttp/guzzle": "^6.2"
}
}
Uzależniam się od klas rzeczywistych...MINUS

19. Dependency Inversion
w composerze?
JAKO TWÓRCA KLIENTA API

20. ROZWIĄZANIE
WIRTUALNA PACZKA
{
"name": "somename/virtual-package-implementation",
"description": "I deliver implementation",
"provide": {
"somename/virtual-package-name": "1.0"
},
"require": {
"somename/virtual-package-interfaces": "^1.2"
}
}

21. JAK SZUKAĆ WIRTUALNYCH PACZEK?
PACKAGIST
MOŻEMY JEJ WYMAGAĆ W COMPOSER

22. JAKO TWÓRCA KLIENTA API
Jak uniezależnić się od implementacji?PYTANIE
{
"name": "somename/api-client",
"description": "API Client",
"minimum-stability": "stable",
"require": {
"guzzlehttp/guzzle": "^6.2"
}
}

23. JAKO TWÓRCA KLIENTA API
Zbiór interfejsów dla klienta HTTP?PYTANIE
PSR-7 psr/http-message

24. A paczka wirtualna dla tych interfejsów?
JAKO TWÓRCA KLIENTA API
PYTANIE
PSR-7 psr/http-message-implementation

25. JAKO TWÓRCA KLIENTA API
PACKAGIST psr/http-message-implementation

26. PSR-7 nie daje interfejsu klienta HTTP
JAKO TWÓRCA KLIENTA API
PROBLEM
RequestInterface ResponseInterface
UriInterface...
PSR-7

27. http://httplug.io
JAKO TWÓRCA KLIENTA API
ROZWIĄZANIE

28. JAKO TWÓRCA KLIENTA API
Zbiór interfejsów dla klienta HTTP
HTTP-PLUG php-http/httpplug

29. JAKO TWÓRCA KLIENTA API
Wirtualna paczka dla klienta HTTP
HTTP-PLUG php-http/client-implementation

30. JAKO TWÓRCA KLIENTA API
PACKAGIST php-http/client-implementation

31. JAKO TWÓRCA KLIENTA API
KTO UŻYWA?

32. JAKO TWÓRCA KLIENTA API
JAK WYGLĄDA?

33. UZALEŻNIAMY SIĘ OD WIRTUALNEJ PACZKI
INSTALACJA
{
"name": "somename/api-client",
"description": "API Client",
"minimum-stability": "stable",
"require": {
"php-http/client-implementation": "^1.0"
}
}

34. UZALEŻNIAMY SIĘ OD WIRTUALNEJ PACZKI
{
"name": "somename/api-client",
"description": "API Client",
"minimum-stability": "stable",
"require": {
"php-http/client-implementation": "^1.0"
}
}
JAK ZACHOWA SIĘ COMPOSER PRZY composer install

35. WADY WIRTUALNYCH PACZEK
COMPOSER POINFORMUJE ŻE NIE ODNALAZŁ PACZKI1
ROZWIĄZANIE

36. WADY WIRTUALNYCH PACZEK
COMPOSER POINFORMUJE ŻE NIE ODNALAZŁ PACZKI1
ROZWIĄZANIE
WIEDZA CZYM JEST WIRTUALNA PACZKA WIEDZA JAK JE INSTALOWAĆ

37. WADY WIRTUALNYCH PACZEK
WIRTUALNĄ PACZKĘ MOŻNA STWORZYĆ NIE IMPLEMENTUJĄC INTERFEJSÓW2
{
"name": "somename/virtual-package-implementation",
"description": "I don’t deliver implementation",
"provide": {
"somename/virtual-package-name": "1.0"
}
}

38. WADY WIRTUALNYCH PACZEK
MOŻE ISTNIEĆ BIBLIOTEKA DOSTARCZAJĄCA INTERFEJS NIE INFORMUJĄC O TYM3
{
"name": "somename/virtual-package-implementation",
"description": "I deliver implementation",
"require": {
"somename/virtual-package-interfaces": "^1.2"
}
}

39. WADY WIRTUALNYCH PACZEK
KAŻDY MOŻE STWORZYĆ PACZKĘ WIRTUALNĄ O DOWOLNEJ NAZWIE4
{
"name": "somename/virtual-package-implementation",
"description": "I don’t deliver implementation",
"provide": {
"somename/virtual-package-name-typo": "1.0"
}
}

40. ZALETY WIRTUALNYCH PACZEK
ROZWIĄZUJEMY PROBLEM KONFLIKTÓW W COMPOSERZE PRZY INSTALACJI1

41. DAJEMY WYBÓR UŻYTKOWNIKOM KONKRETNEJ BIBLIOTEKI2
ZALETY WIRTUALNYCH PACZEK
MAM GUZZLE 5 TO INSTALUJE ADAPTER
NIE PODOBA MI SIĘ WYDAJNOŚĆ TO
ZMIENIAM IMPLEMENTACJĘ

42. UZALEŻNIAMY KOD OD ABSTRAKCJI/INTERFEJSÓW KORZYSTAJĄC Z COMPOSERA3
ZALETY WIRTUALNYCH PACZEK

43. PRZYKŁAD KLIENTA
https://github.com/Schibsted-Tech-Polska/capi_php_sdk
{
“require”: {
"php": ">=5.5",
"php-http/client-implementation": "^1.0",
"php-http/message-factory-implementation": "^1.0"
}
….
}

44. PYTANIA