Laravelのアップグレード手順

こんにちはー！むちょこです。

まだまだLaravel5.5を利用している方も多いかと思いますが、このバージョンは2020年8月30日にサポートが終了します。

この記事では、LTSのより新しいバージョンである6系にバージョンアップするための手順をご紹介します。他のバージョンへアップグレードする場合でも、基本的には同様の手順でアップグレードできるはずです。

各バージョンごとにサーバ要件が異なるので、まず開発環境で要件が揃っているか確認します。

コマンド

# PHPのバージョン
$ php -v

# PHPモジュール
$ php -m

もし現行サーバが要件を満たしていない場合は、別のサーバを用意するなどして要件を満たした開発環境を構築します。

LAMP環境の構築手順を忘れてしまった方はこちらをご覧ください✨

まずは現在の本番環境と同じ状態を再現します。

バージョンを一気に上げると、互換性のない部分の対応が抜け落ちてしまうリスクが増えるので地道に1段階ずつアップグレードしていきます。

アップグレードの手順や注意点は公式ドキュメントに掲載されています。

バージョンアップの必要があるパッケージや、互換性のないコードについて記載されていますので必ず熟読し漏れがないよう対応していきましょう。

composer.jsonを編集し、composer updateコマンドで更新します。

更新に時間がかかったり停止してしまうことがありますが、-vvvオプションをつけるとリアルタイムで状況が確認できるので便利です。

コマンド

$ vim composer.json
$ composer update -vvv

エラーが出たら都度解消します。

Killedと表示され途中で終了しまった場合は、慌てず再度実行しましょう。何度も終了してしまう場合はswap領域を増やしてください。

もしもSomething’s changed, looking at all rules againの途中で止まってしまうようでしたら、依存関係の解決に失敗している可能性があります。

サードパーティーの（プロジェクト特有の）パッケージを入れている場合は、そちらのバージョンも忘れずに合わせましょう。

composer updateが上手くいったらLaravelのバージョンが更新されていることを確認します。

コマンド

$ php artisan --version
Laravel Framework 5.6.39

プロジェクトの中に廃止された機能を使っている箇所があれば、コードを編集して対応させます。

該当箇所はgrepで探すと楽です。

コマンド

$ grep -R 探したいコード 探すディレクトリ

phpunitや実際にブラウザから操作してテストし、異常を見つけたら都度修正します。

3を繰り返して、目的のバージョンまでアップグレードしたら完了です。

お疲れ様でした✨