Laravel 8 から 9 へのアップグレード

{
  "require": {
    "php": "^8.0.2",
    "laravel/framework": "^9.0",
    "spatie/laravel-ignition": "^1.0"
  },
  "require-dev": {
    "nunomaduro/collision": "^6.1"
  }
}

composer update

# Mailgun を使う場合のみ追加
composer require symfony/mailgun-mailer symfony/http-client

# Postmark を使う場合は SwiftMailer 向けパッケージを削除して置き換える
composer remove wildbit/swiftmailer-postmark
composer require symfony/postmark-mailer symfony/http-client

// Laravel 8.x: SwiftMailer ベース
$this->withSwiftMessage(function ($message) {
    $message->getHeaders()->addTextHeader('Custom-Header', 'Header Value');
});

// Laravel 9.x: Symfony Mailer ベース
use Symfony\Component\Mime\Email;

$this->withSymfonyMessage(function (Email $message) {
    $message->getHeaders()->addTextHeader('Custom-Header', 'Header Value');
});

return [
    'mailers' => [
        'smtp' => [
            // Laravel 8.x の設定
            'stream' => [
                'ssl' => [
                    'verify_peer' => false,
                ],
            ],

            // Laravel 9.x の設定
            'verify_peer' => false,
        ],
    ],
];

# Amazon S3 ドライバー
composer require -W league/flysystem-aws-s3-v3 "^3.0"

# FTP ドライバー
composer require league/flysystem-ftp "^3.0"

# SFTP ドライバー
composer require league/flysystem-sftp-v3 "^3.0"

return [
    'disks' => [
        'public' => [
            'driver' => 'local',
            // 書き込み失敗時に例外を投げたい場合だけ有効にする
            'throw' => true,
        ],
    ],
];

// 関連モデルのテーブルに対して name を検索・更新する
$user->roles()->updateOrCreate([
    'name' => 'Administrator',
]);

// 新規作成時だけ created_by をマージする
$user->roles()->firstOrCreate([
    'name' => 'Administrator',
], [
    'created_by' => $user->id,
]);

public function set($model, $key, $value, $attributes)
{
    // Laravel 9 では null が渡される可能性がある
    if ($value === null) {
        return [
            'address_line_one' => null,
            'address_line_two' => null,
        ];
    }

    if (! $value instanceof AddressModel) {
        throw new InvalidArgumentException('AddressModel を渡してください。');
    }

    return [
        'address_line_one' => $value->lineOne,
        'address_line_two' => $value->lineTwo,
    ];
}

use Illuminate\Support\Facades\Http;

// 長めの API 呼び出しだけ個別にタイムアウトを延長する
$response = Http::timeout(120)->get('https://example.com/api/status');

// コアクラスをオーバーライドしている場合は戻り値型を合わせる
public function offsetGet($key): mixed
{
    return parent::offsetGet($key);
}

return [
    'pgsql' => [
        // Laravel 8.x
        'schema' => 'public',

        // Laravel 9.x
        'search_path' => 'public',
    ],
];

// 変更前
$this->assertDeleted($user);

// 変更後
$this->assertModelMissing($user);

// 固定パスではなく langPath() を使って公開先を決める
$this->publishes([
    __DIR__.'/../lang' => app()->langPath('vendor/package-name'),
]);

// 変更前
'password' => ['required', 'password'],

// 変更後
'password' => ['required', 'current_password'],

$collection->when(function ($collection) {
    // ここで返した値が条件式として評価される
    return false;
}, function ($collection) {
    // false が返ったのでこの処理は実行されない
    $collection->merge([1, 2, 3]);
});

use Illuminate\Support\Facades\Validator;

public function boot()
{
    // Laravel 8 と同じ挙動に戻したい場合のみ有効にする
    Validator::includeUnvalidatedArrayKeys();
}