Masz do czynienia z legacy kodem i zastanawiasz się jak zacząć go przepisywać do Symfony? W tej prezentacji postaramy się podpowiedzieć, jak zacząć migrować kod starej aplikacji bez przerywania jej działania i konieczności przepisywania całości za jednym razem.

1. www.xsolve.pl

2. Jak migrować kod legacy do Symfony?
Tips and tricks
www.xsolve.pl

3. Sławomir Rostek
Senior PHP Software Developer

4. Ion Bazan
PHP Software Developer
@IonBazan

5. 1. Wstęp
2. Kod legacy
3. Przygotowanie
4. Pierwsze podejście
5. Napotkane problemy
6. Drugie podejście
7. Wady i zalety
8. Co dalej?
Plan prezentacji

6. Wstęp

7. Kod legacy
Problemy
■ PHP 5.5
■ Yii 1.1
■ Kilka testów (żaden nie działa)
■ Zależności wkomitowane w repozytorium
■ Zmiany w frameworku
■ Niespójna baza ze 170 tabelami, bez kluczy
obcych

8. Od czego zacząć?

9. KROK 1:
Wdrożenie Dockera dla
developmentu
Spójne środowisko i konfiguracja.
Ułatwia wdrażanie do projektu i konfigurację
środowiska dla nowych developerów.
Przejście na PHP 5.6.

10. KROK 2:
Composer
Nowe zależności i część starych pod
kontrolą composera.

11. KROK 3:
Naprawienie testów i
wdrożenie CI
● Tydzień konfigurowania,
przepisywania, poprawiania i
dopisywania nowych testów.
● Testy uruchamiane w izolacji (Docker)
na środowisku CI.
● Wdrożenie mechanizmów statycznej
analizy kodu.

12. KROK 4:
Poprawienie bazy danych
Zapewnienie spójności przy pomocy kluczy
obcych.

13. KROK 6:
Przekonać klienta do
przepisania aplikacji

14. Przepisywanie aplikacji?
A komu to potrzebne?

15. Jak przekonać do przepisania?
■ Miej przy sobie eksperta
■ Znajdź luki w kodzie
■ Mniej bugów podczas releasów
■ Dostarcz metryki kodu
■ Napisz test pokazujący niepożądane zachowanie aplikacji
■ Powołaj się na autorytet
■ Zbuntuj się?!

16. Na czym zależało klientowi?
Skalowanie aplikacji i sesja w Memcache

17. KROK 7:
Do dzieła!

18. Najpierw powstał plan
Symfony App
Yii
Internet
Request
Route found in
Symfony?
Process Request
as usual
yes
Process by
LegacyCodeLegacyCo
deBundleController
FallbackController
need something
from Yii?
no
no
yes
this will be done by
“subrequest” with flag
$forcePathOverride = true
Create
SymfonyComponentHttpF
oundationResponse and
return it
Spa

19. Struktura katalogów
● Nowa aplikacja obok starej.
● Konfigurowalna ścieżka do
starej aplikacji.
● Symlinki do statycznych plików.
● Stara aplikacja może działać
samodzielnie gdyby coś poszło
nie tak.

27. Tagi ESI
● Umożliwiają wstrzykiwanie
widoków, za które
odpowiedzialna jest nowa część
aplikacji.
$esi->render(
'AppBundle:AssignLog:logs',
['modelId' => $model->id]
);

28. Refaktoryzacja,
refaktoryzacja
i refaktoryzacja
Usuwamy niepotrzebne funkcjonalności

30. Wszystko to bez ingerencji w
kod Yii

31. Działa?
Now let’s get fancy!

32. Konfiguracja starej
aplikacji w Symfony
● Utworzenie node w konfiguracji
odpowiedzialnego za starą
aplikację.
● Możliwość dziedziczenia dzięki
komponentowi
Symfony/Configuration

33. Wstrzykiwanie nowych
serwisów do starej
aplikacji
● Serwisy z Symfony trzymane w
specjalnym kontenerze.
● Wstrzykiwanie kontenera
odbywa się w kontrolerze.

34. Mamy problem
■ Niektóre akcje kończą się exitem
Rozwiązanie?
■ Developer usunął wszystkie exit i zastąpił je returnem
■ Rzucanie ApplicationTerminatedException

36. register_shutdown_function()

38. ShutdownableKernel
● Obsługuje wywołanie exit()
wewnątrz kodu.
● Deleguje utworzenie Response
ze zbuforowanego wyjścia i
przesyła go do klienta.

39. ShutdownListener
● Rejestruje metodę shutdown
jako shutdown_function przed
wywołaniem kodu kontrolera.
● Odwołuje rejestrację w wypadku
braku wywołania exit w
kontrolerze (poprawnie
wygenerowany Response).

40. HeaderListener
● Kopiuje ustawione nagłówki do
Response
● Ustawia odpowiedni kod
odpowiedzi

41. OutputBufferListener
● Włącza buforowanie wyjścia
przed uruchomieniem kodu
kontrolera.
● Ustawia zbuforowane wyjście
jako treść odpowiedzi.

42. Klient wymyśla nową funkcjonalność.
Potrzebujemy wynik z aplikacji legacy?

43. ResponseCallbackListener
● Wywołuje callback tuż przed
zwróceniem odpowiedzi i
umożliwia jej podmianę

44. Konfiguracja
● RequestMatcher decyduje o
tym, czy przetworzyć aktualny
Request

45. OutputBufferListener:
Enable buffering
Request
FallbackController:
Process request by legacy app
OutputBufferListener:
Generate Response from buffer
HeaderListener:
Add headers to Response
exit()
called?
LegacyHttpKernel:
Ask for response and send it to client
ResponseCallbackListener:
Use a closure to modify the
Response
Response
YesNo

46. A logi?

47. Logi w Monolog
● Prosty MonologRoute
konwertujący wpisy do logów Yii
na wpisy Monologa.
● Dodanie Route do komponentu
log podczas budowania starej
aplikacji

49. Działa?
Now let’s get fancy!

50. DataCollectors
● Znacznie ułatwiają profilowanie
● Pomagają odnaleźć się w
gąszczu szablonów
● Wyświetlają logi i zapytania
starej aplikacji

52. Podsumowanie
■ Znormalizuj kod
■ Pisz testy!
■ Staraj się przepisywać funkcjonalności małymi krokami
■ Twórz metryki w oparciu o statyczną analizę kodu
■ Ułatwiaj sobie życie przy pomocy narzędzi, jakie oferuje
framework

53. Dzięki!

54. Źródła?
bangpound/LegacyPhpHttpKernel
https://symfony.com/doc/current/components/http_kernel.html

55. www.xsolve.pl
hello@xsolve.pl