Jak zaktualizować wersję frameworka Laravel

Na jesieni 2020 mogliśmy ujrzeć premierę najnowszej wersji 8 frameworka Laravel. W tym roku autorzy wypuścili 2 wersje, co świadczy że mocno pracują nad rozwojem i udoskonaleniem tego frameworka. Dzisiaj chciałbym pokazać jak wykonać migrację projektu ze starej wersji do nowej.

Setup

Mam na swoim GitHubie jakiś prosty projekt, który korzysta z Laravela w wersji 7.24 i teraz chciałbym go zaktualizować. Źródło projektu znajduje się tutaj. W pliku readme.md znajduje się instrukcja krok po kroku jak zainicjować środowisko.

Aktualizujemy framework Laravel

W tym wpisie pokażę jak przejść z wersji 7.24 do 8.x, upewnij się że posiadasz PHP w wersji 7.3. Jeśli nie wiesz jaką masz wersję PHP zainstalowaną, w konsoli wpisz php -v.

W dokumentacji jest napisane że należy zaaktualizować kilka zależności:

• guzzlehttp/guzzle – ^7.0.1
• facade/ignition – ^2.3.6
• laravel/framework – ^8.0
• laravel/ui – ^3.0
• nunomaduro/collision – ^5.0
• phpunit/phpunit – ^9.0

Pewnie przy pobieraniu paczek z composera wszystkie zależności najprawdopodobniej zaczytują się z pamięci podręcznej. Warto wyczyścić sobie cały cache z composera. W tym celu uruchom polecenie:

composer clearcache

Następnie wykonaj polecenie, które zainstaluje wszystkie zależności z pliku composer.json.

composer install

Testowanie aplikacji

Po wykonaniu tego polecenia wszystkie paczki na nowo powinny ci się pobrać. Warto sprawdzić każde poszczególne akcje w aplikacji czy działają poprawnie, po aktualizacji frameworka

Ja w projekcie mam napisane testy, które wykonam poleceniem:

php artisan test

Testy wszystkie przeszły co znaczy że aplikacja działa poprawnie.

Być może w przejściu ze starszych wersji możesz natrafić na problem że nie przechodzić testy. Na szczęście nie miałem takiej sytuacji ale znalazłem 2 wątki które mogą ci w tym pomóc. Pierwszy aktualizacja z 5.7 do 6.0. Drugi testy nie działają w Laravel 7.0.

To był dosyć szybki wpis. Zachęcam do przejrzenia całej podstrony w dokumentacji odnośnie aktualizacji do wersji 8.

Na zakończenie

• Zajrzyj do kodu źródłowego projektu
• Zachęcam do przeczytania poprzedniego wpisu, który opowiada o moim projekcie po godzinach, który finalnie został sprzedany.