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.
Jedna myśl na temat “Jak zaktualizować wersję frameworka Laravel”