1.3. Руководство по обновлению

1. Инструмент автоматического обновления

Чтобы сэкономить ваше время при обновлении, мы добавили команду Artisan, которая автоматизирует как можно больше частей процесса обновления.

После установки Livewire версии 3 выполните следующую команду, и вы получите подсказки для автоматического обновления каждого критического изменения:

php artisan livewire:upgrade

Хотя вышеуказанная команда может обновить большую часть вашего приложения, единственный способ гарантировать полное обновление — это следовать пошаговому руководству на этой странице.

Нанимайте нас для обновления вашего приложения

Если у вас крупное приложение на Livewire или вы просто не хотите заниматься обновлением с версии 2 до версии 3, вы можете нанять нас для выполнения этой задачи. Узнайте больше о нашей услуге по обновлению здесь.

2. Обновление версии PHP

Livewire теперь требует, чтобы ваше приложение работало на PHP версии 8.1 или выше.

3. Обновление Livewire до версии 3

Выполните следующую команду composer, чтобы обновить зависимость Livewire вашего приложения с версии 2 до версии 3:

composer require livewire/livewire "^3.0"
Совместимость пакетов с Livewire 3

Большинство крупных сторонних пакетов Livewire уже поддерживают Livewire 3 или работают над поддержкой в ближайшее время. Однако неизбежно будут пакеты, которым потребуется больше времени для выпуска поддержки Livewire 3.

4. Очистка кэша представлений

Выполните следующую команду Artisan из корневого каталога вашего приложения, чтобы очистить кэшированные/скомпилированные представления Blade и заставить Livewire перекомпилировать их для совместимости с Livewire 3:

php artisan view:clear

5. Объединение новой конфигурации

Livewire 3 изменил несколько параметров конфигурации. Если в вашем приложении опубликован конфигурационный файл (config/livewire.php), вам необходимо обновить его с учетом следующих изменений.

5.1. Новая конфигурация

В версии 3 были добавлены следующие ключи конфигурации:

'legacy_model_binding' => false,
 
'inject_assets' => true,
 
'inject_morph_markers' => true,
 
'navigate' => false,
 
'pagination_theme' => 'tailwind',

Вы можете обратиться к новому конфигурационному файлу Livewire на GitHub для описания дополнительных параметров и готового к использованию кода.

5.2. Измененная конфигурация

Следующие параметры конфигурации были обновлены с новыми значениями по умолчанию:

Новое пространство имен класса

Значение class_namespace по умолчанию в Livewire изменилось с App\Http\Livewire на App\Livewire. Вы можете оставить старое значение в конфигурации; однако, если вы решите обновить его на новое пространство имен, вам потребуется перенести ваши компоненты Livewire в каталог app/Livewire:

-'class_namespace' => 'App\\Http\\Livewire', 
+'class_namespace' => 'App\\Livewire',

5.3. Удаленная конфигурация

Livewire больше не распознает следующие параметры конфигурации.

app_url

Если ваше приложение обслуживается по URI, отличному от корневого, в Livewire 2 вы могли использовать параметр конфигурации app_url для настройки URL, который Livewire использует для выполнения AJAX-запросов.

В этом случае мы обнаружили, что строковая конфигурация слишком жесткая. Поэтому в Livewire 3 используется конфигурация во время выполнения. Вы можете обратиться к нашей документации по настройке конечной точки обновления Livewire для получения дополнительной информации.