PHP 8: план обновления

Как обновиться на PHP 8.0?

https://www.php.net/manual/ru/migration80.php

https://stitcher.io/blog/new-in-php-8

https://php.watch/versions/8.0

В первую очередь, ещё до обновления на PHP 8.0, нужно убедиться, что текущая кодовая база не выбрасывает никаких сообщений о deprications на текущей версии языка. Если такие есть, то их нужно поправить. То, что сегодня отображается как уведомление deprecated, завтра, на новой версии языка, может уже выбрасывать Fatal Error!

В PhpStorm есть инспекция «Language Level»: запустить её можно через меню Code -> RunInspection by Name… и в появившемся диалоге не забыть выбрать версию языка PHP 8 по ссылке Languages & Frameworks / PHP.

Хорошим подспорьем для плавного перехода будет кодовая база, написанная с использованием declare(strict_types=1); или покрытая статическим анализом типа Psalm,  PHPStan и т.п. Но если сейчас этого нет, то не стоит сломя голову добавлять типы, проще перейти на PHP 8.0 как есть, поправив все несовместимости. Однако, не имея типов, эти несовместимости будет сложнее найти.

Следующий полезный инструмент для проверки кода – это пакет PHPCompatibility. Устанавливается через composer и, по сути, это набор правил и проверок для PHP_CodeSniffer.

При первом запуске PHP_CodeSniffer у меня упал по недостатку памяти (не хватило 2Гб). И упал он на парсинге какого-то JavaScript файла. Поскольку JS нам не интересен, нужно добавить аргумент командной строки --extensions=php

Приложу ссылку на статью с подробным описанием, как запускать PHP_CodeSniffer вместе с PHPCompatibility: https://enzo.weknowinc.com/articles/2015/06/07/how-to-check-php-compatibility

После статической проверки и исправления собственного кода, нужно проверить зависимости, проверить пакеты перечисленные в composer.json и их зависимости.

В composer.json нужно установить значение config.platform.php и require.php в 8.0 и попробовать выполнить composer update – если какие-то из зависимостей, включая транзитивные, ещё не поддерживают PHP 8, то увидим подробное описание найденных несовместимостей.

Кстати, а чем отличаются эти две опции в composer.json — config.platform.php и версия PHP указанная в require? Хороший вопрос для отдельного выпуска Пятиминутки PHP. Впрочем, всё есть в документации к composer: https://getcomposer.org/doc/06-config.md#platform

Если нашлись несовместимые пакеты, что делать?

Проверить, возможно в composer.json зафиксированы слишком старые версии пакетов и их можно обновить на более свежие? А если в каких-то пакетах всё ещё нет поддержки PHP 8, то придётся делать fork. Кстати, чтобы использовать свой fork пакета вместо официального репозитория, в composer.json можно указать собственный альтернативный git репозиторий: https://matthewsetter.com/series/tooling/composer/forked-repositories/

Далее обратим внимание на используемые расширения PHP. Работают ли все подключённые внешние или не стандартные расширения с PHP 8? Все стандартные расширения «в поставке» точно поддерживают. А вот какие-то сторонние и экзотические нужно смотреть отдельно по их документации и последним обновлениям. Например, Xdebug уже поддерживает PHP 8!

Если все предварительные проверки пройдены, устанавливаем PHP 8 на локальную машину, чтобы прогнать тесты и проверить работоспособность кода в runtime.

Дальше, по идее, нужно обновлять production сервера. Но на деле не всегда это возможно сделать сразу. Поэтому какое-то время на production всё ещё будет крутиться предыдущая версия PHP. Как не запутаться и не испортить код?

Сначала нужно откатить версию в настройках composer config.platform.php до версии соответствующей production и сделать composer update.

Затем переключить Language Level в PhpStorm на более старую версию, чтобы случайно не написать какую-нибудь конструкцию в новом синтаксисе PHP 8. На самом деле PhpStorm автоматически подхватывает настройки версии PHP указанные в composer.json, но лучше ещё раз перепроверить и убедиться, что Language Level в PhpStorm соответствует production.

Не забудем про Continues Integration, чтобы в этот переходный период тесты гонялись и под текущую production версию PHP, и под PHP 8, таким образом мы сразу заметим случайную деградации кода.

После полного перехода на PHP 8, когда уже и на production серверах будет стоять свежая версия языка, можно начинать использовать новые фишки синтаксиса в коде. Обновить все исходники за раз до современного вида поможет утилита Rector – про неё я рассказывал в 81 эпизоде Пятиминутки PHP. Есть целый набор правил для Rector модифицирующих код под PHP 8, например, он может заменить switch/case на match (https://stitcher.io/blog/php-8-match-or-switch) где возможно или повсеместное внедрить constructor property promotion (https://stitcher.io/blog/constructor-promotion-in-php-8). 

Список доступных модификаций Rector далеко не полный, они не покрывают все возможности PHP8, это лишь начало пути.

Также я рекомендую применять правила Rector по одному и делать внимательный code review, т. к. иногда может что-то сломаться и потребуются ручные правки.

Нужно ли обновлять весь код на новый синтаксис единовременно? Обновление синтаксиса одним коммитом (или даже нескольким коммитами) сделает не релевантным git blame — возможно, это будет не очень удобно.

Я уже обновился на PHP 8.0 и записывал этот подкаст по памяти, возможно, упустил какие-то детали или нюансы. Если есть что добавить, пишите в комментариях на SoundCloud или на YouTube.