バージョン: 9.x

リリースノート (Release Notes)

バージョン管理スキーム
サポートポリシー
Laravel9

バージョン管理スキーム (Versioning Scheme)

Laravel とその他のファーストパーティパッケージはセマンティックバージョニングに従います。メジャーフレームワークリリースは毎年 (~2 月) リリースされますが、マイナーリリースとパッチリリースは毎週リリースされる場合があります。マイナーリリースとパッチリリースには重大な変更が含まれてはなりません**。

Laravel のメジャーリリースには重大な変更が含まれるため、アプリケーションまたはパッケージから Laravel フレームワークまたはそのコンポーネントを参照する場合は、必ず ^9.0 などのバージョン制約を使用する必要があります。ただし、私たちは常に 1 日以内に新しいメジャーリリースに更新できるように努めています。

名前付き引数

名前付き引数は、Laravel の下位互換性ガイドラインではカバーされていません。 Laravel コードベースを改善するために、必要に応じて関数の引数の名前を変更することもできます。したがって、Laravelメソッドを呼び出すときに名前付き引数を使用する場合は、パラメータ名が将来変更される可能性があることを理解した上で、慎重に行う必要があります。

サポートポリシー (Support Policy)

すべての Laravel リリースでは、バグ修正は 18 か月間提供され、セキュリティ修正は 2 年間提供されます。 Lumen を含むすべての追加ライブラリについては、最新のメジャーリリースのみがバグ修正を受けます。さらに、データベースのバージョン Laravelによってサポートされていますを確認してください。

バージョン	PHP(*)	リリース	バグ修正まで	セキュリティ修正の期限
6 (LTS)	7.2～8.0	2019年9月3日	2022 年 1 月 25 日	2022 年 9 月 6 日
7	7.2～8.0	2020年3月3日	2020年10月6日	2021年3月3日
8	7.3 - 8.1	2020年9月8日	2022 年 7 月 26 日	2023 年 1 月 24 日
9	8.0～8.2	2022 年 2 月 8 日	2023 年 8 月 8 日	2024 年 2 月 6 日
10	8.1～8.3	2023 年 2 月 14 日	2024 年 8 月 6 日	2025 年 2 月 4 日

End of life

Security fixes only

(*) サポートされている PHP バージョン

Laravel9 (Laravel 9)

ご存知かもしれませんが、Laravel 8 のリリースにより、Laravel は年次リリースに移行しました。以前は、メジャーバージョンは 6 か月ごとにリリースされていました。この移行は、コミュニティのメンテナンスの負担を軽減し、開発チームが重大な変更を導入することなく、驚くべき強力な新機能をリリースできるようにすることを目的としています。したがって、私たちは下位互換性を損なうことなく、並列テストのサポート、改良された Breeze スターターキット、HTTP クライアントの改善、さらには「多くのうちの 1 つを持っている」などの新しい Eloquent 関係タイプなど、さまざまな堅牢な機能を Laravel 8 に出荷しました。

したがって、現在のリリース中に優れた新機能をリリースするというこの取り組みにより、将来の「メジャー」リリースは主に上流の依存関係のアップグレードなどの「メンテナンス」タスクに使用されることになる可能性が高く、これはこれらのリリースノートで確認できます。

Laravel 9は、Symfony 6.0コンポーネント、Symfony Mailer、Flysystem 3.0のサポート、改良されたroute:list出力、Laravel Scoutデータベースドライバ、新しいEloquentアクセサー/ミューテタ構文、Enumsによる暗黙的なルートバインディング、その他のさまざまなバグ修正と使いやすさの向上により、Laravel 8.xで行われた改良を継続しています。

PHP8.0

Laravel 9.x には、最小 PHP バージョン 8.0 が必要です。

Symfony Mailer

Symfony Mailer のサポートは、ドリス・ヴィンツ、ジェームズ・ブルックス、およびジュリアス・キークブッシュによって提供されました。

Laravel の以前のリリースでは、送信電子メールの送信に迅速なメーラーライブラリを利用していました。ただし、そのライブラリは現在は保守されておらず、Symfony Mailer に引き継がれています。

アプリケーションが Symfony Mailer と互換性があることを確認する方法の詳細については、アップグレードガイドを参照してください。

フライシステム 3.x

Flysystem 3.x のサポートは、ドリス・ヴィンツ によって提供されました。

Laravel 9.x は、アップストリームの Flysystem 依存関係を Flysystem 3.x にアップグレードします。 Flysystem は、Storage ファサードによって提供されるすべてのファイルシステム対話を強化します。

アプリケーションが Flysystem 3.x と互換性があることを確認する方法の詳細については、アップグレードガイドを参照してください。

改良された Eloquent アクセサー / ミューテタ

改善された Eloquent アクセサー / ミューテタは、テイラー・オトウェル によって提供されました。

Laravel 9.x は、Eloquent アクセサとミューテタを定義する新しい方法を提供します。 Laravel の以前のリリースでは、アクセサーとミューテタを定義する唯一の方法は、次のようにモデル上でプレフィックス付きメソッドを定義することでした。

public function getNameAttribute($value)
{
    return strtoupper($value);
}

public function setNameAttribute($value)
{
    $this->attributes['name'] = $value;
}

ただし、Laravel 9.x では、Illuminate\Database\Eloquent\Casts\Attribute の戻り値の型をタイプヒントすることで、単一のプレフィックスのないメソッドを使用してアクセサーとミューテタを定義できます。

use Illuminate\Database\Eloquent\Casts\Attribute;

public function name(): Attribute
{
    return new Attribute(
        get: fn ($value) => strtoupper($value),
        set: fn ($value) => $value,
    );
}

さらに、アクセサーを定義するこの新しいアプローチは、カスタムキャストクラスと同様に、属性によって返されるオブジェクト値をキャッシュします。

use App\Support\Address;
use Illuminate\Database\Eloquent\Casts\Attribute;

public function address(): Attribute
{
    return new Attribute(
        get: fn ($value, $attributes) => new Address(
            $attributes['address_line_one'],
            $attributes['address_line_two'],
        ),
        set: fn (Address $value) => [
            'address_line_one' => $value->lineOne,
            'address_line_two' => $value->lineTwo,
        ],
    );
}

Enum Eloquent 属性のキャスト

警告 Enum キャストは PHP 8.1 以降でのみ使用できます。

Enum キャストはモハメド・サイード によって提供されました。

Eloquent では、属性値を PHP 「バックアップされた」列挙型にキャストできるようになりました。これを実現するには、モデルの $casts プロパティ配列にキャストする属性と列挙型を指定します。

use App\Enums\ServerStatus;

/**
 * The attributes that should be cast.
 *
 * @var array
 */
protected $casts = [
    'status' => ServerStatus::class,
];

モデルでキャストを定義すると、指定した属性は、属性を操作するときに列挙型との間で自動的にキャストされます。

if ($server->status == ServerStatus::Provisioned) {
    $server->status = ServerStatus::Ready;

    $server->save();
}

列挙型を使用した暗黙的なルートバインディング

Implicit Enum バインディングはヌーノ・マドゥロ によって提供されました。

PHP 8.1 では、Enums のサポートが導入されています。 Laravel 9.x では、ルート定義で Enum をタイプヒントする機能が導入されており、Laravel は、そのルートセグメントが URI 内の有効な Enum 値である場合にのみルートを呼び出します。それ以外の場合は、HTTP 404 応答が自動的に返されます。たとえば、次の列挙型があるとします。

enum Category: string
{
    case Fruits = 'fruits';
    case People = 'people';
}

{category} ルートセグメントが fruits または people の場合にのみ呼び出されるルートを定義できます。それ以外の場合は、HTTP 404 応答が返されます。

Route::get('/categories/{category}', function (Category $category) {
    return $category->value;
});

ルートバインディングの強制スコープ設定

強制スコープバインディングはクラウディオ・デッカー によって提供されました。

Laravel の以前のリリースでは、ルート定義で 2 番目の Eloquent モデルのスコープを設定し、それが以前の Eloquent モデルの子である必要がある場合があります。たとえば、特定のユーザーのスラッグによってブログ投稿を取得する次のルート定義について考えてみましょう。

use App\Models\Post;
use App\Models\User;

Route::get('/users/{user}/posts/{post:slug}', function (User $user, Post $post) {
    return $post;
});

カスタムのキー付き暗黙的バインディングをネストされたルートパラメーターとして使用する場合、Laravel は、親の関係名を推測する規則を使用して、親によってネストされたモデルを取得するためにクエリのスコープを自動的に設定します。ただし、この動作は、以前は子ルートバインディングにカスタムキーが使用されていた場合にのみ Laravel でサポートされていました。

ただし、Laravel 9.x では、カスタムキーが提供されていない場合でも、「子」バインディングをスコープするように Laravel に指示できるようになりました。これを行うには、ルートを定義するときに scopeBindings メソッドを呼び出します。

use App\Models\Post;
use App\Models\User;

Route::get('/users/{user}/posts/{post}', function (User $user, Post $post) {
    return $post;
})->scopeBindings();

または、ルート定義のグループ全体にスコープ付きバインディングを使用するように指示することもできます。

Route::scopeBindings()->group(function () {
    Route::get('/users/{user}/posts/{post}', function (User $user, Post $post) {
        return $post;
    });
});

コントローラルートグループ

ルートグループの改善は、ルーク・ダウニング によって提供されました。

これで、controller メソッドを使用して、グループ内のすべてのルートに共通のコントローラを定義できるようになりました。次に、ルートを定義するときに、ルートが呼び出すコントローラメソッドを指定するだけで済みます。

use App\Http\Controllers\OrderController;

Route::controller(OrderController::class)->group(function () {
    Route::get('/orders/{id}', 'show');
    Route::post('/orders', 'store');
});

全文インデックス / Where 句

全文インデックスと「where」句は、テイラー・オトウェルおよびドリス・ヴィンツ によって提供されました。

MySQL または PostgreSQL を使用する場合、fullText メソッドを列定義に追加して、フルテキストインデックスを生成できるようになりました。

$table->text('bio')->fullText();

さらに、whereFullText メソッドと orWhereFullText メソッドを使用して、全文インデックスを持つ列のクエリにフルテキストの "where" 句を追加することもできます。これらのメソッドは、Laravel によって基礎となるデータベースシステムに適した SQL に変換されます。たとえば、MySQL を利用するアプリケーションに対して MATCH AGAINST 句が生成されます。

$users = DB::table('users')
           ->whereFullText('bio', 'web developer')
           ->get();

Laravel Scout データベースエンジン

Laravel Scout データベースエンジンは、テイラー・オトウェルおよびドリス・ヴィンツ によって提供されました。

アプリケーションが小規模から中規模のデータベースとやり取りする場合、またはワークロードが軽い場合は、Algolia や MeiliSearch などの専用の検索サービスの代わりに Scout の「データベース」エンジンを使用できるようになります。データベースエンジンは、既存のデータベースからの結果をフィルタリングするときに「where like」句と全文インデックスを使用して、クエリに該当する検索結果を決定します。

Scout データベースエンジンの詳細については、Scoutの文書を参照してください。

インラインBlade テンプレートのレンダリング

インライン Blade テンプレートのレンダリングは、ジェイソン・ベッグスによって提供されました。インライン Blade コンポーネントのレンダリングは、トビー・ゼルナーによって提供されました。

場合によっては、生の Blade テンプレート文字列を有効な HTML に変換する必要があるかもしれません。これは、Blade ファサードによって提供される render メソッドを使用して実行できます。 render メソッドは、Blade テンプレート文字列と、テンプレートに提供するオプションのデータ配列を受け入れます。

use Illuminate\Support\Facades\Blade;

return Blade::render('Hello, {{ $name }}', ['name' => 'Julian Bashir']);

同様に、renderComponent メソッドを使用して、コンポーネントインスタンスをメソッドに渡すことで、特定のクラスコンポーネントをレンダリングできます。

use App\View\Components\HelloComponent;

return Blade::renderComponent(new HelloComponent('Julian Bashir'));

スロット名のショートカット

スロット名のショートカットはカレブ・ポルツィオによって提供されました。

Laravel の以前のリリースでは、スロット名は x-slot タグの name 属性を使用して提供されていました。

<x-alert>
    <x-slot name="title">
        Server Error
    </x-slot>

    <strong>Whoops!</strong> Something went wrong!
</x-alert>

ただし、Laravel 9.x 以降では、便利で短い構文を使用してスロット名を指定できるようになりました。

<x-slot:title>
    Server Error
</x-slot>

チェック/選択されたBlade ディレクティブ

チェックおよび選択された Blade ディレクティブは、アッシュ・アレンおよびテイラー・オトウェル によって寄稿されました。

便宜上、@checked ディレクティブを使用して、特定の HTML チェックボックス入力が「チェックされている」かどうかを簡単に示すことができるようになりました。このディレクティブは、指定された条件が true と評価される場合、checked をエコーします。

<input type="checkbox"
        name="active"
        value="active"
        @checked(old('active', $user->active)) />

同様に、@selected ディレクティブを使用して、特定の選択オプションを「選択」する必要があるかどうかを示すことができます。

<select name="version">
    @foreach ($product->versions as $version)
        <option value="{{ $version }}" @selected(old('version') == $version)>
            {{ $version }}
        </option>
    @endforeach
</select>

ブートストラップ 5 ページネーションビュー

Bootstrap 5 ページネーションビューは、ジャレッド・ルイス によって寄稿されました。

Laravel には、ブートストラップ 5 を使用して構築されたページ分割ビューが含まれるようになりました。デフォルトの Tailwind ビューの代わりにこれらのビューを使用するには、App\Providers\AppServiceProvider クラスの boot メソッド内でページネータの useBootstrapFive メソッドを呼び出すことができます。

use Illuminate\Pagination\Paginator;

/**
 * Bootstrap any application services.
 *
 * @return void
 */
public function boot()
{
    Paginator::useBootstrapFive();
}

ネストされた配列データの検証の改善

ネストされた配列入力の検証の改善は、スティーブ・バウマン によって提供されました。

属性に検証ルールを割り当てるときに、特定のネストされた配列要素の値にアクセスする必要がある場合があります。 Rule::forEach メソッドを使用してこれを実行できるようになりました。 forEach メソッドは、検証中の配列属性の反復ごとに呼び出されるクロージャを受け入れ、属性の値と明示的な完全に展開された属性名を受け取ります。クロージャは、配列要素に割り当てるルールの配列を返す必要があります。

use App\Rules\HasPermission;
use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

$validator = Validator::make($request->all(), [
    'companies.*.id' => Rule::forEach(function ($value, $attribute) {
        return [
            Rule::exists(Company::class, 'id'),
            new HasPermission('manage-company', $value),
        ];
    }),
]);

Laravel Breeze API と Next.js

Laravel Breeze API スキャフォールディングと Next.js スターターキットは、テイラー・オトウェルおよびミゲル・ピエドラフィタ によって提供されました。

Laravel Breeze スターターキットには、「API」スキャフォールディングモードと無料の Next.js フロントエンドの実装が含まれています。このスターターキットスキャフォールディングは、バックエンドとして機能する Laravel アプリケーション (JavaScript フロントエンド用の Laravel Sanctum 認証済み API) をすぐに開始するために使用できます。

点火例外ページの改善

Ignition は Spatie によって開発されました。

Spatie が作成したオープンソースの例外デバッグページである Ignition は、根本から再設計されました。新しく改良された Ignition は Laravel 9.x に同梱されており、ライト/ダークテーマ、カスタマイズ可能な「エディタで開く」機能などが含まれています。

`route:list` CLI 出力の改善

改良された route:list CLI 出力は、ヌーノ・マドゥロ によって提供されました。

route:list CLI 出力は Laravel 9.x リリースで大幅に改善され、ルート定義を探索するときに美しく新しいエクスペリエンスを提供します。

Artisan `test` コマンドを使用したカバレッジのテスト

Artisan test コマンド使用時のテストカバレッジは、ヌーノ・マドゥロ によって提供されました。

Artisan test コマンドに、テストがアプリケーションに提供するコードカバレッジの量を調査するために使用できる新しい --coverage オプションが追加されました。

php artisan test --coverage

テストカバレッジの結果は、CLI 出力内に直接表示されます。

さらに、テストカバレッジパーセンテージが満たさなければならない最小しきい値を指定したい場合は、--min オプションを使用できます。指定された最小しきい値が満たされていない場合、テストスイートは失敗します。

php artisan test --coverage --min=80.3

Soketi Echo サーバー

Soketi Echo サーバーはアレックス・レノキ によって開発されました。

Laravel 9.x に限定されたものではありませんが、Laravel は最近、Node.js 用に作成された Laravel Echo 互換の Web ソケットサーバーである Soketi のドキュメントを支援しました。 Soketi は、独自の Web Socket サーバーを管理することを好むアプリケーション向けに、Pusher や Ably に代わる優れたオープンソースの代替手段を提供します。

Soketi の使用方法の詳細については、放送ドキュメントおよびソケティのドキュメントを参照してください。

コレクション IDE サポートの改善

コレクション IDE サポートの改善は、ヌーノ・マドゥロ によって提供されました。

Laravel 9.x では、改良された「汎用」スタイル型定義がコレクションコンポーネントに追加され、IDE と静的分析のサポートが改善されています。 PHPStorm などの IDE や PHPStan などの静的分析ツールは、Laravel コレクションをネイティブに理解できるようになりました。

新しいヘルパ

Laravel 9.x では、独自のアプリケーションで使用できる 2 つの新しい便利なヘルパ関数が導入されています。

`str`

str 関数は、指定された文字列の新しい Illuminate\Support\Stringable インスタンスを返します。この関数は、Str::of メソッドと同等です。

$string = str('Taylor')->append(' Otwell');

// 'Taylor Otwell'

str 関数に引数が指定されていない場合、関数は Illuminate\Support\Str のインスタンスを返します。

$snake = str()->snake('LaravelFramework');

// 'laravel_framework'

`to_route`

to_route 関数は、指定された名前付きルートのリダイレクト HTTP 応答を生成し、ルートとコントローラから名前付きルートにリダイレクトする表現力豊かな方法を提供します。

return to_route('users.show', ['user' => 1]);

必要に応じて、リダイレクトに割り当てる HTTP ステータスコードと追加の応答ヘッダーを、to_route メソッドの 3 番目と 4 番目の引数として渡すことができます。

return to_route('users.show', ['user' => 1], 302, ['X-Framework' => 'Laravel']);

バージョン管理スキーム (Versioning Scheme)​

名前付き引数​

サポートポリシー (Support Policy)​

Laravel9 (Laravel 9)​

PHP8.0​

Symfony Mailer​

フライシステム 3.x​

改良された Eloquent アクセサー / ミューテタ​

Enum Eloquent 属性のキャスト​

列挙型を使用した暗黙的なルート バインディング​

ルートバインディングの強制スコープ設定​

コントローラルートグループ​

全文インデックス / Where 句​

Laravel Scout データベース エンジン​

インラインBlade テンプレートのレンダリング​

スロット名のショートカット​

チェック/選択されたBlade ディレクティブ​

ブートストラップ 5 ページネーション ビュー​

ネストされた配列データの検証の改善​

Laravel Breeze API と Next.js​

点火例外ページの改善​

route:list CLI 出力の改善​

Artisan test コマンドを使用したカバレッジのテスト​

Soketi Echo サーバー​

コレクション IDE サポートの改善​

新しいヘルパ​

str​

to_route​