КЕЙС / GIFT CARD GRANNY /

Обновление фреймворка Symfony для компании Wolfe

ПРОБЛЕМА

Gift Card Granny работает с 2009 года. Последнее крупное обновление фреймворка и кодовой базы было в 2014 году: команда клиента перенесла проект на фреймворк Symfony версии 2.0. В 2015 году был еще один апгрейд до версии 2.8.

Разработчики фреймворка Symfony перестали выпускать исправления багов и обновления безопасности для этой версии фреймворка в 2019, то есть она существенно устарела. Это привело к появлению двух проблем, которые не давали клиенту развивать Gift Card Granny:

В 2022 году компания Wolfe обратилась к Resolventa за помощью в обновлении фреймворка.

ЗАДАЧА

Resolventa усилила внутреннюю команду клиента одним ведущим PHP-разработчиком. Квалифицированный специалист с сертификатом по работе с Symfony и опытом масштабного апгрейда фреймворка должен был:

РЕШЕНИЕ

Resolventa составила план обновления и взяла на себя большую часть технических работ по апгрейду фреймворка.

Настройка среды разработки. В первую очередь, команде клиента не хватало локальной среды разработки. Программисты работали с файлами проекта на своих компьютерах в IDE, а затем синхронизировали их с тестовым сервером с помощью rsync, а после тестирования — с продакшен-сервером. Современной инфраструктуры для разработки и доставки кода не было.

Такой способ работы подходил для небольших обновлений, однако при апгрейде фреймворка нужно одномоментно синхронизировать огромное число файлов. Более того, выполнять синхронизацию приходится многократно, потому что при обновлении часто возникают конфликты и ошибки в коде проекта. В подобной ситуации rsync становится слишком медленным и неудобным инструментом. Апгрейд по такой технологии шел бы очень долго и с большими трудозатратами.

Чтобы сделать обновление более удобным и современным, команда Resolventa внедрила Docker-контейнеры для локальной разработки. Внутри контейнера программисты использовали одинаковую, уже настроенную инфраструктуру разработки: PHP, mySQL, Nginx, очереди сообщений. Там же подключались mock — специальные заглушки, которые заменяют сервисы и внешние интеграции на время разработки и тестирования.

Изучение инфраструктуры проекта, составление конфигурации контейнеров, создание mock и настройка локальной среды разработки заняла около двух недель. Такой долгий срок был связан с большим объемом кодовой базы, сложностью инфраструктуры, а больше всего времени потребовала разработка mock-заглушек. Когда подготовительный этап завершился, Resolventa приступила к обновлению фреймворка.

Апгрейд Symfony. Работа по обновлению шла в несколько итераций, потому что огромный проект нельзя перенести сразу с версии 2.8 на актуальную в 2022 году 5.4. Разрыв между версиями очень большой, поэтому при обновлении одним скачком возникло бы огромное количество конфликтов и несовместимостей. Отследить и исправить их было бы очень сложно даже опытным специалистам.

Обновление разбили на шаги: поэтапно переносили проект на все ключевые версии фреймворка начиная с 2.8. На момент публикации кейса проект готовится к обновлению до версии 5.0.

На каждом шаге разработчики повторяли одну и ту же процедуру: проверяли проект с помощью специальных инструментов, обновляли или заменяли конфликтующие и устаревшие пакеты, по необходимости исправляли код.

Для проверки разработчики использовали два ключевых инструмента: Composer и Symfony Profiler.

Также у Symfony есть подробная документация, в которой прописаны инструкции по обновлению и changelog — список различий и несовместимостей между версиями. Эти материалы также активно использовались при работе команды.

Переходы между версиями потребовали разного вложения времени и труда. Например, при обновлении на версию 3.0 практически не возникло конфликтов внешних зависимостей. А вот переход на версию 4.0 был относительно сложным и долгим: пришлось заменить большое число пакетов.

Обновление внешних зависимостей. Апгрейд настолько масштабного и сильно устаревшего проекта сложный процесс, потому что в коде используется около 60 внешних зависимостей. На каждом шаге нужно было контролировать, что все пакеты совместимы с новой версией фреймворка.

Так как последний апгрейд фреймворка в проекте произошел в 2014 году, то и большинство зависимостей сохранились с того же времени. При их обновлении возникали две ситуации:

Работа над бизнес-задачами клиента. Обновление Symfony до самой актуальной версии — важная, но не единственная задача Resolventa. Много внимания потребовали также различные бизнес-задачи и помощь в развитии проекта. Например, Resolventa внедрила новые функциональные возможности для покупателей подарочных карт в предпраздничный период, когда клиент готовился к большому наплыву пользователей.

Также команда занималась интеграцией системы IDology для качественной идентификации пользователей. Она повышает безопасность проекта и помогает избежать мошенничества, например, с использованием краденых кредитных карт.

РЕЗУЛЬТАТ

Проект клиента прошел через сложное обновление: кодовую базу перенесли на значительно более современный фреймворк Symfony 4.4. Кроме того, команда начала использовать актуальные инструменты разработки: Docker-контейнеры, автотесты, миграции баз данных. Программисты получили современную инфраструктуру, в которой удобно работать и обновлять проект. Благодаря этому проект стал более безопасным, он работает стабильнее и его проще развивать.

Resolventa продолжает совместную работу с внутренней командой клиента, усиливает и направляет ее. Дальнейшее обновление уже в стадии подготовки и стартует, когда это будет необходимо.

ТЕХНОЛОГИИ

PHP, Symfony, MySQL, Docker, React, Bitbucket Pipelines, AWS

ИНТЕГРАЦИИ

Stripe, PayPal, Facebook Business, Google, Twilio, Cloudinary, Mandril, Mailchimp, Algolia, Zendesk, IDology