Rozwój aplikacji opartych o Laravel

Rozwój aplikacji opartych o Laravel

Rozwój aplikacji opartych o Laravel
Mapa strony
PL EN

Rozwój aplikacji opartych o Laravel

Backend rzadko jest bohaterem projektu: nikt nie wchodzi na stronę, żeby podziwiać API. Widać go dopiero wtedy, gdy zawodzi. Raport generuje się trzy minuty, powiadomienia przychodzą po godzinie, a aktualizacja frameworka „na chwilę” trwa trzy tygodnie. Laravel jest dla nas podstawą takich systemów: dla transportu (Track My Truck), robót drogowych (OLAN), uczelni (UE Katowice) czy inwestorów giełdowych (Stockradar).

Laptop z oknem przeglądarki, od którego strzałki prowadzą do stosu modułów, bazy danych i zębatki
Aplikacja webowa zbudowana z czytelnych modułów, z własną bazą danych i logiką po stronie serwera.

Z czym zwykle przychodzą klienci

„Aplikacja działa, ale boimy się ją aktualizować”

To bardzo częsta sytuacja. System powstał kilka lat temu, wykonawca zniknął albo przestał się odzywać, a wersja frameworka została tam, gdzie była. Każdy dzień zwłoki to kolejne wersje, których nie da się już łatwo nadrobić, a wraz z nimi rosną ryzyko i koszt.

Nie zaczynamy od klikania „composer update”. Najpierw osobne środowisko testowe, żeby produkcji nie ruszać. Potem testy, które zabezpieczą to, co dziś działa, bo przy aktualizacji najgorsze są zmiany, których nikt nie zauważył. Dopiero wtedy idziemy wersja po wersji, bez przeskakiwania o kilka naraz. Na końcu to Wy sprawdzacie wynik, a wdrożenie robimy razem.

1Środowisko testoweAplikacja działa obok, produkcji nie ruszamy2TestyZabezpieczamy to, co dziś działa3Wersja po wersjiBez przeskoku o kilka wersji naraz4Akceptacja i wdrożenieSprawdzacie Wy, wdrażamy razemdesi9n.plWasza firma
Aktualizacja bez niespodzianek: testy przed zmianami i wersja po wersji, a nie skok o kilka wersji naraz.

„Użytkownik klika i czeka”

PHP z natury odpowiada na żądanie i kończy pracę. To świetnie, dopóki odpowiedź jest szybka. Gdy użytkownik zleca coś ciężkiego, na przykład raport w PDF, import danych albo wysłanie powiadomień do tysięcy osób, patrzenie w kręcące się kółko nikomu nie pomaga.

Rozwiązanie jest zawsze to samo: aplikacja przyjmuje zadanie, od razu odpowiada, a pracę wykonuje worker w tle. W systemie dla OLAN administrator ma zestawienia okresowe w PDF i eksport do CSV, który otworzy Excel, Google Sheets albo Calc. W aplikacji Stockradar serwis na bieżąco pobiera komunikaty giełdowe ESPI i EBI, a następnie automatycznie, przy pomocy zadań CRON, powiadamia użytkowników push. Dla uczelni w Katowicach powiadomienia trafiają grupowo do absolwentów, kandydatów i studentów, a każdy może jeszcze ustawić sobie przypomnienie o wydarzeniu na wybraną godzinę.

UżytkownikAplikacjabez czekaniaKolejkazleca zadanieWorkerpilnuje go SupervisorPDF i raportyeksportyPowiadomieniapush, e-mailImport danychz innych systemów
Zadanie trafia do kolejki, a użytkownik nie czeka. Ciężką pracę wykonuje worker w tle.

Czasem wystarczy prosty CRON, czasem potrzebna jest kolejka z Supervisorem, a bywa, że warto sięgnąć po RabbitMQ. Dobieramy narzędzie do skali, a nie do mody.

„Potrzebujemy panelu, aplikacji w terenie i integracji, najlepiej na tych samych danych”

Tak zwykle wygląda prawdziwy system: panel dla biura, aplikacja dla ludzi w terenie i połączenia z innymi programami. Jeśli każdy z tych elementów ma własną logikę, po roku dane przestają się zgadzać. Dlatego stawiamy jedno API w Laravelu, a wszyscy pozostali są jego klientami.

W OLAN to aplikacja PWA dla operatorów maszyn, w której raporty z wykonywanych prac powstają razem ze zdjęciami (zoptymalizowanymi pod konkretne raporty) i z walidacją, oraz panel administratora do zarządzania budowami, operatorami, maszynami i cenami asfaltu. W Track My Truck backend w Laravelu obsługuje aplikację kierowców i dodatkowo pokazuje położenie pojazdów na mapie. Za każdym razem to samo: jedna logika biznesowa, wielu klientów.

API w Laravelulogowanie, uprawnienia, danePanel biuraw przeglądarcePWA w tereniezdjęcia i raportyAplikacja mobilnaWebViewInne systemyREST, integracje
Jedno API, wielu klientów. Dzięki temu panel, aplikacja w terenie i integracje korzystają z tych samych danych i reguł.

„Zbieramy dane, ale nikt nie umie z nich nic wyciągnąć”

Raporty wpisane przez ludzi w terenie to dopiero połowa pracy. Druga to sprawić, żeby biuro mogło je szybko przejrzeć i policzyć. W panelu dla OLAN administrator filtruje i sortuje listę raportów, otwiera szczegóły razem ze zdjęciami i może je edytować, a potem tworzy zestawienia okresowe do wydruku albo PDF-a. Statystyki pokazują się na wykresach, a gdy ktoś woli własne tabele, dane można wyeksportować do CSV. Wszystko leży w jednej bazie, więc nikt nie zbiera plików z mailowych skrzynek.

Ten schemat powtarza się w wielu branżach: dane wpisuje ktoś w terenie, a decyzje podejmuje biuro. Dlatego zaczynamy od pytania, jakie liczby będą Wam potrzebne za pół roku, bo od tego zależy, jak zaprojektujemy bazę już dziś.

„Co się dzieje po wdrożeniu?”

System, który działa, wciąż potrzebuje opieki: aktualizacji frameworka i serwera, drobnych poprawek, a zwykle też nowych modułów, bo po kilku miesiącach użytkownicy mówią: „fajnie, a czy można jeszcze…”. Tak było choćby z Track My Truck, do którego w 2023 roku dokładaliśmy kolejne moduły, także po stronie backendu w Laravelu. Dlatego od początku ustalamy, jak wygląda współpraca po oddaniu systemu: kto przyjmuje zgłoszenia, jak często aktualizujemy zależności i jak wprowadzamy kolejne funkcje, żeby nie przerywać pracy użytkownikom.

Kiedy nie Laravel

Laravel nie jest odpowiedzią na wszystko i nie udajemy, że jest. Do strony z aktualnościami i BIP-em dla instytucji często lepszy jest WordPress, a Laravel pojawia się dopiero przy modułach, które wymagają własnej logiki, jak e-rejestracja pacjentów w szpitalu w Tarnowie. Do integracji, w których przetwarzamy duże ilości danych w formatach XML i JSON, chętnie używamy Pythona i FastAPI, tak jak w pracach dla Adecon. A do bardzo prostych stron wystarczy samo HTML i CSS.

Wybór technologii zależy od zadania i od tego, kto będzie system utrzymywał. Jeśli lepiej sprawdzi się coś innego, mówimy o tym na początku, a nie po wycenie. Więcej o łączeniu systemów znajdziecie na stronie o integracji z systemami zewnętrznymi.

Laravel od strony technicznej

Dla działów IT i osób, które lubią szczegóły :) Poniżej krótko o możliwościach frameworka i o tym, na co zwracamy uwagę.

Laravel to framework, który pozwala na tworzenie aplikacji internetowych w języku PHP. Jest jednym z najpopularniejszych frameworków dla języka PHP. W porównaniu do konkurencji ma niski próg wejścia i możliwości rozwijania aplikacji — nawet do dużych rozmiarów.

SSR w Laravel

Laravel daje pełną paletę rozwiązań do tworzenia nawet bardzo rozbudowanych i skomplikowanych aplikacji. Domyślnie korzysta z systemu templatek Blade, które mogą być wydajnie doposażone o JS dzięki Laravel-Mix.

Technicznie Laravel-mix to wrapper na Javascriptowy build tool, jakim jest webpack, który daje dodatkowe możliwości budowania w architekturze Laravela i strukturze katalogów.

Warto jednak zauważyć, że widoki generowane po stronie serwera (eng. Server Side Rendering) to tylko jedna z możliwości pracy z tym frameworkiem.

Obsługa baz danych w Laravelu

Laravel posiada własny system ORM — Eloquent. Pozwala on na tworzenie wydajnych zapytań do baz danych SQL. Przez wielu specjalistów jest uważany za bardziej wygodny od konkurencyjnego Doctrine.

Tworzenie REST API

Dzięki mechanizmom wbudowanym w Laravela — takim jak routing, autentykacja i autoryzacja, obsługa logowania błędów czy bezpośrednie zarządzanie odpowiedziami HTTP — Laravel idealnie nadaje się do tworzenia API. Pozwala na szybkie tworzenie dokumentacji API dzięki Swagger.

REST API pozwala nam zasilić danymi np. aplikacje typu SPA, aplikacje mobilne, IoT czy inne, zewnętrzne integracje.

Przetwarzanie kolejek, praca ciągła

Ze względu na sposób działania języka PHP — kod aplikacji uruchamiany jest, aby przetworzyć żądanie użytkownika. Co jednak z czynnościami konserwacyjnymi, serwisowymi? Z pomocą przychodzą nam zdefiniowane zadania CRON — mają one jednak swoje ograniczenia. Innym sposobem jest instalacja Supervisor, który pozwala rozwinąć skrzydła aplikacjom napisanym w Laravelu.

Oczywiście w tym miejscu warto zaznaczyć, że istnieją inne systemy do przetwarzania kolejek takie jak np. RabbitMQ, ale wybiega tematycznie poza główny wątek — jakim jest Laravel.

Wersje Laravela

Kolejne wersje frameworka Laravel dodają nowe funkcje, zmieniają pewne koncepcje czy są dostosowywane do wymagań zmieniającego się w kolejnych osłonach języka PHP.

Warto mieć świadomość, że pomiędzy kolejnymi "dużymi wersjami" pojawiać się mogę tzw. breaking changes — każdorazowa migracja na kolejną linię Laravela powinna być poprzedzona testami analizą zmian a aplikacji.

Biorąc jednak pod uwagę, że back-end zwykle rozwija się wolniej od front-endu nie jest to takim wielkim problemem.

Artisan, Composer i Docker

Mimo tego, że język PHP jest dostępny na większości serwerów współdzielonych, to jednak Laravel często wymaga do pracy zainstalowanego lub dostępnego jako plik .phar managera zależności — Composer. Do wydajnej pracy możemy również potrzebować narzędzia artisan, które jest po prostu CLI (eng. Command Line Interface) dla Laravela.

W takim przypadku dostęp SSH to niezbędne minimum, ale aby zainstalować np. wspomnianego Supervisora lub uruchamiać aplikację jako kontener Docker będziemy musieli uzyskać dostęp do użytkownika root, a to już kwestia przynajmniej serwerów VPS.

Stabilny partner w budowie systemów opartych o Laravel

Rozważając budowę aplikacji opartej o Laravel, warto wybrać solidnego i rzetelnego wykonawcę. Nie jest to technologia szczególnie trudna, ale biorąc pod uwagę stosunkowo niski próg wejścia do języka PHP oraz fakt, że często wykonawcy, które do tej pory wdrażali Wordpressa, próbują swoich sił z Laravelem — warto zachować czujność.

Na szczególną uwagę zasługuje doświadczenie w podobnych obszarach do rozwiązania, które chcemy tworzyć. Przykładowo — zagadnienia związane z Blade i Laravel-Mix nie są konieczne do tworzenia REST-API, tak jak odpowiednia struktura RestFul nie jest wymagana w przypadku monolitycznych aplikacji SSR.

Najczęściej zadawane pytania

Czy aktualizacja starej aplikacji w Laravelu jest bezpieczna?

Tak, jeśli zrobi się ją w odpowiedniej kolejności: najpierw osobne środowisko testowe, potem testy zabezpieczające obecne działanie, następnie aktualizacja wersja po wersji, a na końcu akceptacja przez klienta i wspólne wdrożenie. Nie przeskakujemy o kilka wersji naraz, bo między wersjami mogą pojawiać się zmiany niekompatybilne wstecz.

Po co kolejki i zadania w tle w aplikacji Laravel?

Dzięki nim użytkownik nie czeka na ciężkie operacje, takie jak generowanie raportu PDF, import danych albo wysyłka powiadomień. Aplikacja przyjmuje zadanie, od razu odpowiada, a pracę wykonuje worker w tle. Zależnie od skali wystarcza CRON, kolejka z Supervisorem albo osobny system kolejkowania, jak RabbitMQ.

Czy z jednego backendu w Laravelu może korzystać panel, aplikacja mobilna i inne systemy?

Tak, to jeden z najczęstszych układów w naszych projektach. Backend wystawia API, a panel w przeglądarce, aplikacja PWA lub mobilna i zewnętrzne systemy są jego klientami. Dzięki temu wszyscy korzystają z tych samych danych i reguł biznesowych, a dane nie rozjeżdżają się między aplikacjami.

Źródła