Laravel 9.x アップグレードガイド

重要度の高い変更

重要度が中程度の変更

８．ｘから９．０へのアップグレード

アップグレード時間の見積もり：３０分

Note: 私たちは、互換性のない変更を可能な限りすべて文書化するよう努力しています。これらの互換性のない変更の一部はフレームワークの不明瞭な部分であり、こうした変更の一部が実際にあなたのアプリケーションに影響を与える可能性があります。時間を節約したいですか？Laravel Shift を使用すると、アプリケーションのアップグレードを自動化できます。

依存パッケージのアップデート

影響の可能性： 高い

PHP8.0.2が必要

今回より、Laravelを動作させるには、PHP8.0.2以上が必要になりました。

Composerの依存パッケージ

アプリケーションのcomposer.jsonファイルにある、以下の依存パッケージを更新してください。

  • laravel/frameworkを^9.0に変更
  • nunomaduro/collisionを^6.1に変更

さらに、アプリケーションのcomposer.jsonファイル中の、facade/ignitionを"spatie/laravel-ignition": "^1.0"へ置き換え、（該当する場合は）pusher/pusher-php-serverを"pusher/pusher-php-server": "^5.0"へ置き換えてください。

さらに、以下のファーストパーティパッケージは、Laravel9.x をサポートするために新しくメジャーリリースしました。当てはまる場合、Laravelをアップグレードする前に、それぞれのアップグレードガイドを読んでください。

最後に、アプリケーションで使用している他のサードパーティパッケージを調べ、Laravel9をサポートする適切なバージョンを使用していることを確認してください。

PHPの戻り値タイプ

PHPでは、offsetGetやoffsetSetなどのPHPメソッドへ、戻り値のタイプの定義を義務付ける方向に移行し始めています。これを踏まえ、Laravel9ではコードベースにこれらの戻り値の型を実装しています。通常、ユーザーが書いたコードには影響しませんが、Laravelのコアクラスを拡張してこれらのメソッドをオーバーライドしている場合は、これらの戻り値の型を自分のアプリケーションやパッケージのコードに追加することが必要になります。

  • count(): int
  • getIterator(): Traversable
  • getSize(): int
  • jsonSerialize(): array
  • offsetExists($key): bool
  • offsetGet($key): mixed
  • offsetSet($key, $value): void
  • offsetUnset($key): void

さらに、PHPのSessionHandlerInterfaceを実装したメソッドに戻り値のタイプが追加されました。繰り返しますが、この変更があなた自身のアプリケーションやパッケージのコードに、影響を与えることはまずないでしょう。

  • open($savePath, $sessionName): bool
  • close(): bool
  • read($sessionId): string|false
  • write($sessionId, $data): bool
  • destroy($sessionId): bool
  • gc($lifetime): int

アプリケーション

Application契約

影響の可能性： 低い

Illuminate\Contracts\Foundation\ApplicationインターフェイスのstoragePathメソッドを更新し、$path引数を取るようにしました。このインターフェイスを実装している場合、それに応じて実装を更新する必要があります。

public function storagePath($path = '');

同様に、Illuminate\Foundation\ApplicationクラスのlangPathメソッドを更新し、$path引数を取るようになりました。

public function langPath($path = '');

例外ハンドラのignoreメソッド

影響の可能性： 低い

例外ハンドラのignoreメソッドが、protectedからpublicへ変更しました。このメソッドはデフォルトのアプリケーションスケルトンには含まれていません。しかし、もしこのメソッドを独自に定義している場合は、可視性をpublicへ更新する必要があります。

public function ignore(string $class);

例外ハンドラ契約の依存結合

影響の可能性： かなり低い

以前、Laravelのデフォルト例外ハンドラをオーバーライドするには、\App\Exceptions\Handler::classタイプのカスタム実装を使い、サービスコンテナへ依存結合していました。しかし今後は、\Illuminate\Contracts\Debug\ExceptionHandler::classタイプを使用して依存結合する必要があります。

Blade

レイジーコレクションと$loop変数

影響の可能性： 低い

Bladeテンプレート内のLazyCollectionインスタンスを反復処理すると$loop変数は使用できなくなります。この変数にアクセスすると、LazyCollection全体がメモリに読み込まれるため、このシナリオではレイジーコレクションの使用が無意味になるためです。

Checked／Disabled／Selected Bladeディレクティブ

影響の可能性： 低い

新しい@checked、@disabled、@selected Bladeディレクティブは、同名のVueイベントと競合する可能性があります。@@でディレクティブをエスケープすると、この衝突を回避できます。

コレクション

Enumerable契約

影響の可能性： 低い

Illuminate\Support\Enumerable契約に、soleメソッドを定義しました。このインターフェイスを実装している場合は、この新しいメソッドを反映するよう実装を更新してください。

public function sole($key = null, $operator = null, $value = null);

reduceWithKeysメソッド

reduceメソッドが同じ機能を提供しているため、reduceWithKeysメソッドを削除しました。reduceWithKeysの代わりに、reduceを呼び出すようにコードを更新するだけです。

reduceManyメソッド

reduceManyメソッドは、他の同様のメソッドと名前の一貫性を保つため、reduceSpreadへ名前を変更しました。

コンテナ

Container契約

影響の可能性： とても低い

Illuminate\Contracts\Container\Container契約は、scopedとscopedIfの２メソッド定義を受けるようにしました。この契約を実装している場合は、これらの新しいメソッドを反映するように実装を更新してください。

ContextualBindingBuilder契約

影響の可能性： とても低い

Illuminate\Contracts\Container\ContextualBindingBuilder契約で、giveConfigメソッドを定義しました。このインターフェイスを実装している場合は、この新しいメソッドを反映するように更新してください。

public function giveConfig($key, $default = null);

データベース

Postgres "Schema"設定

影響の可能性： 中程度

アプリケーションのconfig/database.php設定ファイルで、Postgres接続検索パスを設定するために使用するschema設定オプションの名前をsearch_pathへ変更してください。

Schema Builder registerCustomDoctrineType Method

影響の可能性： 低い

registerCustomDoctrineTypeメソッドは、Illuminate\Database\Schema\Builderクラスから削除しました。代わりに、DBファサードで、registerDoctrineTypeメソッドを使用するか、config/database.php設定ァイルで、カスタムDoctrineタイプを登録できます。

Eloquent

カスタムキャストとnull

影響の可能性： 中程度

Laravel の以前のリリースでは、カスタムキャストクラスのsetメソッドは、キャスト属性がnullに設定されている場合には呼び出しませんでした。しかし、この動作はLaravelのドキュメントと矛盾していました。Laravel9.xでは、キャストクラスのsetメソッドは$value引数にnullを指定しても起動されます。したがって、カスタムキャストがこのシナリオを確実に処理できるようにしてください。

/**
 * 指定値を保存のために準備
 *
 * @param  \Illuminate\Database\Eloquent\Model  $model
 * @param  string  $key
 * @param  AddressModel  $value
 * @param  array  $attributes
 * @return array
 */
public function set($model, $key, $value, $attributes)
{
    if (! $value instanceof AddressModel) {
        throw new InvalidArgumentException('The given value is not an Address instance.');
    }

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

Belongs To ManyのfirstOrNew、firstOrCreate、updateOrCreateメソッド

影響の可能性： 中程度

belongsToManyリレーションシップのfirstOrNew、firstOrCreate、updateOrCreateメソッドの最初の引数に、属性の配列が渡されます。Laravelの以前のリリースでは、この属性の配列は、既存のレコードの「ピボット」／中間テーブルと比較されていました。

しかし、この動作は期待されておらず、一般的に望まれないものでした。代わりに、これらのメソッドは関連モデルのテーブルに対して属性の配列を比較するようになりました。

$user->roles()->updateOrCreate([
    'name' => 'Administrator',
]);

さらに、firstOrCreateメソッドの第２引数に、$values配列を取るようになりました。この配列は、関連モデルが存在していない場合に、メソッドの第１引数（$attributes）へマージします。この変更により、このメソッドは他のリレーションタイプで提供しているfirstOrCreateメソッドと動作が一致するようになりました。

$user->roles()->firstOrCreate([
    'name' => 'Administrator',
], [
    'created_by' => $user->id,
]);

touchメソッド

影響の可能性： 低い

touchメソッドへ、属性を指定できるようになりました。以前このメソッドを上書きしていた場合は、この新しい引数を反映させるためにメソッドの引数指定を変更してください。

public function touch($attribute = null);

暗号化

Encrypter契約

影響の可能性： 低い

Illuminate\Contracts\Encryption\Encrypter契約で、getKeyメソッドを定義しました。このインターフェイスを実装している場合は、それに応じて更新してください。

public function getKey();

ファサード

getFacadeAccessorメソッド

影響の可能性： 低い

getFacadeAccessorメソッドは常にコンテナ結合キーを返す必要があります。Laravelの以前のリリースでは、このメソッドはオブジェクトのインスタンスを返すことができましたが、この動作はもうサポートしません。独自のファサードを記述している場合は、このメソッドがコンテナ結合文字列を返すようにしなければなりません。

/**
 * コンポーネントの登録名取得
 *
 * @return string
 */
protected static function getFacadeAccessor()
{
    return Example::class;
}

ファイルシステム

FILESYSTEM_DRIVER環境変数

影響の可能性： 低い

FILESYSTEM_DRIVER環境変数は、より正確にその使用目的を反映するため、FILESYSTEM_DISKへ名前を変更しました。この変更はアプリケーションのスケルトンにしか影響しませんが、もし望むなら、あなた自身のアプリケーションの環境変数を更新し、この変更を反映させてもかまいません。

"Cloud"ディスク

影響の可能性： 低い

ディスク設定オプションのcloudは、２０２０年１１月にデフォルトのアプリケーションスケルトンから削除しました。この変更は、アプリケーションのスケルトンにのみ影響します。アプリケーション内でcloudディスクを使用している場合は、この設定値を自分のアプリケーションのスケルトンに残しておく必要があります。

Flysystem 3.x

影響の可能性： 高い

Laravel9.xは、Flysystem1.xから3.xへ移行しました。Flysystem は、Storageファサードが提供するすべてのファイル操作メソッドを裏で提供しています。これにより、あなたのアプリケーションでいくらかの変更が必要になるかもしれません。しかし、私たちはこの移行を可能な限りシームレスに行えるように努めました。

ドライバ要件

S3、FTP、SFTPドライバを使用する前に、Composerパッケージマネージャで適切なパッケージをインストールする必要があります。

既存ファイルの上書き

put、write、writeStreamなどの書き込み操作は、デフォルトで既存のファイルを上書きするようになりました。既存のファイルを上書きしたくない場合は、書き込み操作を行う前に、ファイルの存在を確認してください。

Writeの例外

put、write、writeStreamなど書き込み操作で、書き込みに失敗しても例外を投げなくなりました。代わりに、falseを返します。例外を投げる以前の動作を維持する場合は、ファイルシステムのディスク設定配列で、throwオプションを定義してください。

'public' => [
    'driver' => 'local',
    // ...
    'throw' => true,
],

存在しないファイルからの読み込み

存在しないファイルから読み込もうとすると、nullを返すようにしました。以前のLaravelのリリースでは、Illuminate\Contracts\Filesystem\FileNotFoundExceptionを投げていました。

存在しないファイルの削除

存在しないファイルをdeleteしようとすると、trueを返すようにしました。

キャッシュ済みアダプタ

Flysystemは、「キャッシュ済みアダプタ」をサポートしなくなりました。そのため、Laravel から削除し、関連する設定（ディスク設定内のcacheキーなど）もすべて削除しました。

カスタムファイルシステム

カスタムファイルシステムドライバの登録に必要な手順が若干変更されました。したがって、もしあなたが独自のカスタムファイルシステムドライバを定義していたり、カスタムドライバを定義しているパッケージを使用していた場合は、あなたのコードと依存を更新する必要があります。

たとえば、Laravel8.xのカスタムファイルシステムの登録は、以下のようでした。

use Illuminate\Support\Facades\Storage;
use League\Flysystem\Filesystem;
use Spatie\Dropbox\Client as DropboxClient;
use Spatie\FlysystemDropbox\DropboxAdapter;

Storage::extend('dropbox', function ($app, $config) {
    $client = new DropboxClient(
        $config['authorization_token']
    );

    return new Filesystem(new DropboxAdapter($client));
});

しかし、Laravel9.xから、Storage::extendメソッドへ与えられるコールバックは、直接Illuminate\Filesystem\FilesystemAdapterインスタンスを返さなければなりません。

use Illuminate\Filesystem\FilesystemAdapter;
use Illuminate\Support\Facades\Storage;
use League\Flysystem\Filesystem;
use Spatie\Dropbox\Client as DropboxClient;
use Spatie\FlysystemDropbox\DropboxAdapter;

Storage::extend('dropbox', function ($app, $config) {
    $adapter = new DropboxAdapter(
        new DropboxClient($config['authorization_token'])
    );

    return new FilesystemAdapter(
        new Filesystem($adapter, $config),
        $adapter,
        $config
    );
});

ヘルパ

data_getヘルパとIterableオブジェクト

影響の可能性： とても低い

以前は、data_getヘルパを使用して、配列およびCollectionインスタンスのネストされたデータを取得できました。しかし今、このヘルパは、すべての反復可能なオブジェクトのネストされたデータを取得するようになりました。

strヘルパ

影響の可能性： とても低い

Laravel9.xでは、グローバルなstrヘルパ関数を取り入れました。アプリケーションでグローバルなstrヘルパを定義している場合は、Laravel自身のstrヘルパと競合しないように、名前を変更するか削除する必要があります。

when／unlessメソッド

影響の可能性： 中程度

お気づきでしょうが、whenメソッドとunlessメソッドは、フレームワーク全体のさまざまなクラスで提供しています。これらのメソッドは、メソッドの最初の引数のブール値がtrue、またはfalseと評価された場合、条件付きでアクションを実行するために使用します。

$collection->when(true, function ($collection) {
    $collection->merge([1, 2, 3]);
});

そのため、以前のLaravelのリリースでは、whenまたはunlessメソッドにクロージャを渡すとは、クロージャオブジェクト（または他のオブジェクト）に対し緩い比較が行われるため、常に結果はtrueに評価され、条件付き操作が常に実行されることを意味しました。これはしばしば、予想外の結果を生みました。なぜなら、開発者はクロージャの 結果 が、条件付きアクションが実行されるかどうかを決定するブール値として使用されることを期待していたからです。

そのため、Laravel9.xではwhenやunlessメソッドに渡されたクロージャは実行され、クロージャが返す値がwhenやunlessメソッドが使う理論値とみなすようにしました。

$collection->when(function ($collection) {
    // このクロージャは実行される
    return false;
}, function ($collection) {
    // クロージャが"false"を返しているため、実行されない
    $collection->merge([1, 2, 3]);
});

HTTPクライアント

デフォルトタイムアウト

影響の可能性： 中程度

HTTPクライアントのデフォルトのタイムアウトを３０秒にしました。つまり、３０秒以内にサーバから応答がない場合、例外が発生していました。以前は、HTTPクライアントにデフォルトのタイムアウトの長さが設定されていなかったため、リクエストが永久に「ハングアップ」することがありました。

もし、指定するリクエストへより長いタイムアウトを指定したい場合は、timeoutメソッドを使用して指定できます。

$response = Http::timeout(120)->get(/* ... */);

HTTP Fakeとミドルウェア

影響の可能性： 低い

以前は、HTTPクライアントが "fake"されていても、Laravelは指定されたGuzzle HTTPミドルウェアを実行しませんでした。しかし、Laravel 9.xでは、HTTPクライアントがFakeであっても、Guzzle HTTPミドルウェアは実行されます。

HTTP Fakeと依存注入

影響の可能性： 低い

Laravelの以前のリリースでは、Http::fake()メソッドを起動しても、クラスコンストラクタへ注入されたIlluminate\Http\Client\Factoryインスタンスに影響を与えませんでした。しかし、Laravel9.xでは、Http::fake()は、依存注入により他のサービスへ注入されたHTTPクライアントがFakeレスポンスを返すことを保証します。この動作は、他のファサードやFakeの動作とより一貫性があります。

Symfony Mailer

影響の可能性： 高い

Laravl9.xの最大の変更点は、２０２１年１２月をもってメンテナンスが終了したSwiftMailerから、Symfony Mailerへの移行したことです。しかし、私たちはあなたのアプリケーションで、この移行ができるだけシームレスになるように努めました。とはいえ、あなたのアプリケーションで完全に互換を保てるように、以下の変更点のリストを十分に確認してください。

ドライバ要求

Mailgunトランスポートを引き続き使用するには、symfony/mailgun-mailerとsymfony/http-client Composerパッケージがアプリケーションに必要です。

composer require symfony/mailgun-mailer symfony/http-client

wildbit/swiftmailer-postmark Composerパッケージをアプリケーションから削除する必要があります。代わりに、symfony/postmark-mailer、symfony/http-client Composerパッケージが必要です。

composer require symfony/postmark-mailer symfony/http-client

戻り値の変更

Illuminate\Mail\Mailerのsend、html、text、plainメソッドは、voidを返さなくしました。代わりに、Illuminate\Mail\SentMessageインスタンスを返します。このオブジェクトには、getSymfonySentMessageメソッドでアクセス、もしくはオブジェクトのメソッドを動的に呼び出すことでアクセスできるSymfony\Component\Mailer\SentMessageインスタンスが含まれています。

"Swift"メソッドの変更

一部は文書化されていない、さまざまなSwiftMailer関連のメソッドは、Symfony Mailerの対応するメソッドへ名前を変更しました。たとえば、withSwiftMessageメソッドの名前をwithSymfonyMessageに変更しました。

// Laravel8.x
$this->withSwiftMessage(function ($message) {
    $message->getHeaders()->addTextHeader(
        'Custom-Header', 'Header Value'
    );
});

// Laravel9.x
use Symfony\Component\Mime\Email;

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

Warning!! Symfony\Component\Mime\Emailオブジェクトと関わるすべてに関して、Symfony Mailerドキュメントを徹底的に確認してください。

以下のリストには、改名されたメソッドの概要がより詳細に記載されています。これらのメソッドの多くは SwiftMailer／Symfony Mailer と直接やりとりするための低レベルのメソッドなので、ほとんどの Laravel アプリケーションの中で一般的に使われることはないと思われます。

Message::getSwiftMessage();
Message::getSymfonyMessage();

Mailable::withSwiftMessage($callback);
Mailable::withSymfonyMessage($callback);

MailMessage::withSwiftMessage($callback);
MailMessage::withSymfonyMessage($callback);

Mailer::getSwiftMailer();
Mailer::getSymfonyTransport();

Mailer::setSwiftMailer($swift);
Mailer::setSymfonyTransport(TransportInterface $transport);

MailManager::createTransport($config);
MailManager::createSymfonyTransport($config);

Illuminate\Mail\Messageメソッドのプロキシ処理

Illuminate\Mail\Messageは通常、見つからないメソッドを裏で動作しているSwift_Messageインスタンスへプロキシしていました。しかし、見つからないメソッドは、代わりにSymfony\Component\Mime\Emailインスタンスへプロキシするようにしました。したがって、これまで見つからないメソッドがSwiftMailerへプロキシされる動作に依存していたコードは、対応するsymfony Mailerのメソッドへ更新する必要があります。

繰り返しますが、Laravelのドキュメントに記載されていないため、多くのアプリケーションはこれらのメソッドと関わっていないでしょう。

// Laravel8.x
$message
    ->setFrom('taylor@laravel.com')
    ->setTo('example@example.org')
    ->setSubject('Order Shipped')
    ->setBody('<h1>HTML</h1>', 'text/html')
    ->addPart('Plain Text', 'text/plain');

// Laravel9.x
$message
    ->from('taylor@laravel.com')
    ->to('example@example.org')
    ->subject('Order Shipped')
    ->html('<h1>HTML</h1>')
    ->text('Plain Text');

生成するメッセージID

SwiftMailerは、mime.idgenerator.idright設定オプションで、生成するメッセージIDに含めるカスタムドメインを定義することが可能でした。これはSymfony Mailerではサポートされていません。代わりに、Symfony Mailerは送信者に基づいてメッセージIDを自動的に生成します。

MessageSentイベントの変更

Illuminate\Mail\Events\MessageSentイベントのmessageプロパティは、Swift_Messageインスタンスの代わりに、Symfony\Component\Mime\Emailインスタンスを含むようにしました。このメッセージは、送信前の電子メールを表します。

さらに、MessageSentイベントへ、新しくsentプロパティを追加しました。このプロパティはIlluminate\Mail\SentMessageインスタンスを含み、メッセージIDなど送信したメールに関する情報を含んでいます。

再接続の強制

トランスポートの再接続を強制することはできなくなりました。（例：メーラーがデーモンプロセスで動作している場合）代わりに、Symfony Mailerは自動的にトランスポートへの再接続を試み、再接続が失敗した場合は例外を投げます。

SMTPストリームオプション

SMTPトランスポートのストリームオプションの定義をサポートしなくなりました。代わりに、関連オプションがサポートされている場合、設定内で直接定義する必要があります。例として、TLSピア認証を無効にする場合をご覧ください。

'smtp' => [
    // Laravel8.x
    'stream' => [
        'ssl' => [
            'verify_peer' => false,
        ],
    ],

    // Laravel9.x
    'verify_peer' => false,
],

利用可能な設定オプションの詳細は、Symfony Mailer documentationを確認してください。

Warning!! 上記に例として挙げましたが、SSL認証を無効にすることは、「中間者」攻撃の可能性をもたらすので、一般的にはおすすめできません。

SMTP auth_mode

SMTPのauth_modeをmail設定ファイルで定義する必要はなくなりました。認証モードは、Symfony MailerとSMTPサーバの間で自動的にネゴシエーションされます。

Failed Recipients

メッセージ送信後に、失敗した受信者のリストを取得できなくなりました。代わりに、メッセージの送信に失敗すると、Symfony\Component\Mailer\Exception\TransportExceptionInterface例外が投げられるようになりました。メッセージ送信後に無効なメールアドレスの取得する代わりに、メッセージ送信前にメールアドレスの検証を行うことを推奨します。

パッケージ

langディレクトリ

影響の可能性： 中程度

新しいLaravelアプリケーションでは、resources/langディレクトリがプロジェクトのルートディレクトリのlangへ配置しました。もし、あなたのパッケージがこのディレクトリへ直接言語ファイルをリソース公開していれば、パスをハードコードせずに、app()->langPath()へ確実にリソース公開してください。

キュー

opis/closureライブラリ

影響の可能性： 低い

Laravelの依存パッケージのopis/closureをlaravel/serializable-closureへ置き換えました。opis/closureライブラリを直接操作していない限り、これによりアプリケーションへ互換性がない変更は起きません。付け加えて、以前、非推奨にしたIlluminate\Queue\SerializableClosureFactoryとIlluminate\Queue\SerializableClosureクラスを削除しました。もし、opis/closureライブラリを直接操作したり、削除されたクラスを使用している場合は、代わりに Laravelシリアライズ可能クロージャ を使用してください。

失敗したジョブプロバイダのflushメソッド

影響の可能性： 低い

Illuminate\Queue\Failed\FailedJobProviderInterfaceインターフェイスで定義したflushメソッドは、$hours引数を受けるようにしました。これは失敗したジョブをqueue:flushコマンドでフラッシュするまで何時間待つかを決定します。FailedJobProviderInterfaceを手作業で実装している場合、この新しい引数を反映するように実装を更新する必要があります。

public function flush($hours = null);

セッション

getSessionメソッド

影響の可能性： 低い

Laravel自身のIlluminate\Http\Requestクラスへ拡張されていたSymfony\Component\HttpFoundaton\Requestクラスは、現在のセッションストレージハンドラを取得するgetSessionメソッドを提供しています。ほとんどのLaravelアプリケーションは、Laravel自身のsessionメソッドを通してセッションと対話するので、Laravelはこのメソッドを文書化していません。

以前のgetSessionメソッドは、Illuminate\Session\Storeインスタンスかnullを返していましたが、Symfony6.XはSymfony\Component\HttpFoundation\Session\SessionInterfaceタイプを返すように強制しています。そのため、getSessionは、SessionInterfaceの実装を返すか、セッションが存在しないときは\Symfony\Component\HttpFoundation\Exception\SessionNotFoundExceptionを投げるようになりました。

テスト

assertDeletedメソッド

影響の可能性： 中程度

assertDeletedメソッドのすべての呼び出しをassertModelMissingへ更新してください。

信用できるプロキシ

影響の可能性： 低い

Laravel8プロジェクトをLaravel9にアップグレードする際、既存のアプリケーションコードを全く新しいLaravel9アプリケーションスケルトンへインポートする場合、アプリケーションの「信用できるプロキシ」ミドルウェアを更新する必要がある場合があります。

app/Http/Middleware/TrustProxies.phpファイル中の、use Fideloper\Proxy\TrustProxies as Middlewareをuse Illuminate\Http\Middleware\TrustProxies as Middlewareへ変更してください。

次に、app/Http/Middleware/TrustProxies.php中の$headersプロパティ定義を更新します。

// 変更前
protected $headers = Request::HEADER_X_FORWARDED_ALL;

// 変更後
protected $headers =
    Request::HEADER_X_FORWARDED_FOR |
    Request::HEADER_X_FORWARDED_HOST |
    Request::HEADER_X_FORWARDED_PORT |
    Request::HEADER_X_FORWARDED_PROTO |
    Request::HEADER_X_FORWARDED_AWS_ELB;

最後に、アプリケーションからfideloper/proxyComposerの依存パッケージを削除します。

composer remove fideloper/proxy

バリデーション

フォームリクエストのvalidatedメソッド

影響の可能性： 低い

フォームリクエストが提供しているvalidatedメソッドは、$keyと$default引数を取るようにしました。このメソッドの定義を独自に上書きしている場合は、これらの新しい引数を反映させるように更新してください。

public function validated($key = null, $default = null)

passwordルール

影響の可能性： 中程度

与えられた入力値が認証済みユーザーの現在のパスワードと一致するかをバリデートするpasswordルールの名前をcurrent_passwordへ変更しました。

Unvalidated Array Keys

影響の可能性： 中程度

Laravelの以前のリリースでは、Laravelのバリデータが返す「バリデーション済み」データから、バリデーションしていない配列キーを除外するには、手作業で指示する必要がありました。特に、許容するキーのリストを指定しないarrayルールと組み合わせた場合です。

しかし、Laravel9.xでは、arrayルールで許可するキーを指定していない場合でも、バリデーションしていない配列キーは常に「バリデーション済み」データから除外されます。通常、この動作は最も期待されている動作であり、以前のexcludeUnvalidatedArrayKeysメソッドは、Laravel8.xで下位互換性を保つための一時的な措置として追加したものでした。

推奨はしませんが、アプリケーションのサービスプロバイダのbootメソッド内で、新しいincludeUnvalidatedArrayKeysメソッドを呼び出し、以前のLaravel8.x の動作を選択することもできます。

use Illuminate\Support\Facades\Validator;

/**
 * アプリケーションの全サービスの登録
 *
 * @return void
 */
public function boot()
{
    Validator::includeUnvalidatedArrayKeys();
}

その他

また、laravel/laravel GitHubリポジトリで、変更点を確認することをおすすめします。これらの変更の多くは必須ではありませんが、これらのファイルをあなたのアプリケーションへ同期させておくとよいでしょう。こうした変更の一部は、このアップグレードガイドでカバーしますが、設定ファイルやコメントの変更のような他のものは、カバーしません。GitHub比較ツールで簡単に変更点を確認し、どの更新が皆さんにとって重要か選択できます。

ドキュメント章別ページ

はじめに
リリースノート アップグレードガイド 貢献ガイド
利用開始
インストール 設定 ディレクトリ構造 フロントエンド スターターキット デプロイ
構成概念
ライフサイクル サービスコンテナ サービスプロバイダ ファサード
基礎
ルーティング ミドルウェア CSRF保護 コントローラ リクエスト レスポンス ビュー Bladeテンプレート アセットの構築 URL生成 セッション バリデーション エラー処理 ログ
より深く知る
Artisanコンソール ブロードキャスト キャッシュ コレクション 契約 イベント ファイルストレージ ヘルパ HTTPクライアント 多言語化 メール 通知 パッケージ開発 キュー レート制限 タスクスケジュール
安全
認証 認可 メール確認 暗号化 ハッシュ パスワードリセット
データベース
準備 クエリビルダ ペジネーション マイグレーション シーディング Redis
Eloquent ORM
Eloquentの準備 リレーション コレクション ミューテタ／キャスタ APIリソース シリアライズ ファクトリ
テスト
テストの準備 HTTPテスト コンソールテスト ブラウザテスト データベーステスト モック
パッケージ
Breeze Cashier (Stripe) Cashier (Paddle) Dusk Envoy Fortify Homestead Horizon Jetstream Mix Octane Passport Pint Sail Sanctum Scout Socialite Telescope Valet
API
APIドキュメント
言語 ファイル
auth.php pagination.php passwords.php validation.php

ヘッダー項目移動

注目：アイコン：ページ内リンク設置（リンクがないヘッダーへの移動では、リンクがある以前のヘッダーのハッシュをURLへ付加します。

移動

クリックで即時移動します。

リンク
サイトホーム ページ上部へ
言語
バージョン
10.x 9.x 8.x 7.x 6.x LTS 5.8 5.7 5.6 5.5 LTS 5.4 5.3 5.2 5.1 LTS 5.0 5.dev 4.2

設定

適用ボタンクリック後に、全項目まとめて適用されます。

カラーテーマ
和文指定 Pagination
和文指定 Scaffold
Largeスクリーン表示幅
インデント
本文フォント
コードフォント
フォント適用確認

フォントの指定フィールドから、フォーカスが外れると、当ブロックの内容に反映されます。EnglishのDisplayもPreviewしてください。

フォント設定時、表示に不具合が出た場合、当サイトのクッキーを削除してください。

バックスラッシュを含むインライン\Code\Blockの例です。

以下はコードブロックの例です。

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * ユーザに関連する電話レコードを取得
     */
    public function phone()
    {
        return $this->hasOne('App\Phone');
    }
}

設定を保存する前に、表示が乱れないか必ず確認してください。CSSによるフォントファミリー指定の知識がない場合は、フォントを変更しないほうが良いでしょう。

キーボード・ショートカット

オープン操作

P／D／C

ページ（章）移動の左オフキャンバスオープン

H／A

ヘッダー移動モーダルオープン

M／S

移動／設定の右オフキャンバスオープン

ヘッダー移動

T

最初のヘッダーへ移動

E

最後のヘッダーへ移動

N／J

次ヘッダー(H2〜H4)へ移動

B／K

前ヘッダー(H2〜H4)へ移動

その他

?

このヘルプページ表示
閉じる