VHS Development dla TYPO3

Dlaczego wersja deweloperska VHS dla agencji TYPO3 to miecz obosieczny

VHS (ViewHelpers Supplementary) z ponad 300 ViewHelperami to najobszerniejsze rozszerzenie Fluid dla TYPO3. Wersja deweloperska dostarcza nowe ViewHelper i poprawki błędów, zanim trafią do stabilnego wydania. Dla programistów pracujących nad aktualnymi projektami i czekających na konkretną poprawkę lub nową funkcję, to zaleta. Dla witryn produkcyjnych to ryzyko: wersje deweloperskie nie są w pełni przetestowane i mogą się niekompatybilnie zmieniać między commitami.

Decyzja o zastosowaniu VHS Development w projekcie nie jest techniczna, lecz organizacyjna: czy zespół ma zdolność, by terminowo testować zmiany w bibliotece i reagować, gdy coś się zepsuje?

Typowe scenariusze zastosowań

Dostęp do poprawek przed następnym stabilnym wydaniem. Projekt korzysta z ViewHelper VHS v:format.trim, który w stabilnej wersji ma błąd. Poprawka istnieje już w gałęzi deweloperskiej, ale następne stabilne wydanie jest planowane dopiero za 4 tygodnie. Zespół tymczasowo przechodzi na VHS Development i wraca po stabilnym wydaniu.

Ewaluacja nowych ViewHelper dla projektu relaunch. Relaunch TYPO3 zaczyna się za 3 miesiące. Zespół deweloperski ocenia, czy nowe ViewHelper VHS mogą uprościć kod szablonów. Wersja deweloperska jest instalowana w lokalnym środowisku, testowana, a wyniki wpływają na decyzje architektoniczne.

Wkład w rozwój VHS. Agencje wnoszące własne ViewHelper do VHS lub zgłaszające błędy pracują z wersją deweloperską, by testować swoje poprawki wobec aktualnego stanu kodu. Bez wersji deweloperskiej sensowne contributing nie jest możliwe.

Architektura techniczna

VHS Development to nie oddzielne rozszerzenie, lecz aktualny stan deweloperski repozytorium VHS na GitHub (FluidTYPO3/vhs). Instalacja odbywa się przez Composer z dev-main lub konkretną gałęzią. Ustawienie minimum-stability w composer.json musi być na dev, co wpływa na wszystkie pakiety.

VHS obejmuje ponad 300 ViewHelper w obszarach: Content (renderowanie elementów treści, dostęp FAL), Format (manipulacja stringami, daty, JSON), Iterator (operacje na tablicach, sortowanie, filtrowanie), Page (nawigacja drzewem stron, breadcrumb), Media (manipulacja obrazami, osadzanie wideo) i Security (sprawdzanie dostępu, status logowania).

Wersja deweloperska może zawierać ViewHelper, których API jeszcze się zmienia. Między dwoma stabilnymi wydaniami w gałęzi deweloperskiej zmienia się sygnatura 5 do 15 ViewHelper.

Częste problemy i rozwiązania

Aktualizacja Composer łamie istniejące szablony. composer update pobiera najnowszą wersję deweloperską, w której parametr ViewHelper został przemianowany. Rozwiązanie: konsekwentne commitowanie pliku Composer-Lock i instalacja VHS Development ze stałą referencją commitu: composer require fluidtypo3/vhs:dev-main#abc1234.

minimum-stability dev wpływa na inne pakiety. Rozwiązanie: utrzymanie "minimum-stability": "stable" i jawne zdefiniowanie VHS Development jako wyjątku: "fluidtypo3/vhs": "dev-main as 6.99.0". Wzorzec aliasu pozwala na instalację bez globalnej zmiany stabilności.

Pipeline CI/CD nie udaje się z wersją deweloperską. Automatyczne testy i wdrożenia mogą nie udać się, gdy GitHub jest tymczasowo nieosiągalny lub gałąź została force-pushowana. Rozwiązanie: użycie lokalnego mirrora Composer (Satis) dla pipeline CI/CD.

Migracja i kompatybilność wersji

Stabilne wydania VHS podążają za cyklami TYPO3 LTS: VHS 6.x wspiera TYPO3 v11, VHS 7.x wspiera TYPO3 v12. Gałąź deweloperska celuje w następną główną wersję.

Przejście z VHS Development z powrotem na Stable jest z reguły bezproblemowe, o ile nie są używane ViewHelper istniejące tylko w wersji deweloperskiej. Gosign zaleca przed przejściem na Stable sprawdzenie wszystkich używanych ViewHelper VHS wobec dokumentacji Stable.

Gosign zaleca następującą strategię: na środowiskach deweloperskich i w gałęziach funkcji korzystać z wersji deweloperskiej do ewaluacji nowych ViewHelper. Na staging i produkcji wyłącznie stabilne wydania. Jeśli krytyczna poprawka jest dostępna tylko w Development - przypiąć konkretny commit jako referencję Composer i zostawić w kodzie komentarz TODO widoczny przy następnym sprawdzeniu stabilnego wydania.