• リリース日：2026年3月17日
• バグ修正：2027年9月まで
• セキュリティ修正：2028年3月まで

1. ドキュメント
2. 必要なPHPバージョン

_ドキュメント

• Release Notes | Laravel 13.x - The clean stack for Artisans and agents

  Laravel is a PHP web application framework with expressive, elegant syntax. We've already laid the foundation — freeing you to create without sweating the small things.

  laravel.com/docs/13.x/releases
• Upgrade Guide | Laravel 13.x - The clean stack for Artisans and agents

  Laravel is a PHP web application framework with expressive, elegant syntax. We've already laid the foundation — freeing you to create without sweating the small things.

  laravel.com/docs/13.x/upgrade

_必要なPHPバージョン

• 8.3以上
  PHP 8.3 Released

  PHP8.3は、PHP言語のメジャーアップデートです。クラス定数の型付け、読み取り専用プロパティのクローン、ランダム機能追加など、多くの新機能が含まれています。さらにパフォーマンスの向上、バグフィックス、コードのクリーンナップも行われました。

  www.php.net/releases/8.3/ja.php

公式SDKの使い方そのままではLaravelらしくないのでFacadeを使ったLaravel流の使い方ができるようにしている。

use Revolution\Copilot\Facades\Copilot;

$response = Copilot::run(prompt: 'What is 2 + 2?');

echo $response->content();

use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Facades\Copilot;

Copilot::start(function (CopilotSession $session) {
    echo 'Starting Copilot session: '.$session->id();

    $response = $session->sendAndWait(prompt: 'Tell me something about PHP.');
    echo $response->content();

    $response = $session->sendAndWait(prompt: 'How about Laravel?');
    echo $response->content();
});

1. fake()

_fake()

いつからかLaravelで使われ出して最近はサードパーティパッケージでも普及しているfake()メソッドでのモック。
お馴染みMockeryのshouldReceive()、expects()はFacadeを使えば自動的に対応するので簡単だけどfake()を真似するのは中々大変。

こんなテストを書けるようにしたいのでがんばって対応。

use Revolution\Copilot\Facades\Copilot;

Copilot::fake('4');

$response = Copilot::run(prompt: 'What is 2 + 2?');

expect($response->content())->toBe('4');

Copilot::assertPrompt('What is *');
Copilot::assertPromptCount(1);

LaravelのHttpクライアントでhtmlを取得できるなら簡単で何も難しくない。今はJavaScriptで描写してることも多いのでリアルブラウザでのアクセスが必要な場合が難しい。
ここに関しても何年も前にLaravel Duskを参考にして作ってたパッケージがあった。リアルブラウザの管理が手間でアーカイブにして終了してたけど最近調べてPlaywrightが使えそうだったので復活させた。

つい最近Vercelからagent-browserが出てこれが使えないか試していた。

ここまで前振り。

Laravel Cloudならagent-browserをインストールできるだろうと試したらできなかった。
デプロイ時のBuild commandsでcomposer installやnpm ciを実行してるけどここはルート環境ではない。
sudo apt-get installで追加インストールしようとしてもsudoコマンドがなくて不可能。
まさかのルート権限がない。
Laravel ForgeならできるはずなのでこれもLaravel Cloudの制限。
システムへのインストールが必要なのでユーザーランドでの簡単な解決方法はなさそう。

引き続き調査。

Laravel VPSはスペックを上げると下げられない。EC2の感覚で使えない。
Cloudは柔軟に変更できるのでこっちのほうが良さそう。

自由に使える度はForge＞Cloud＞Vaporの順。
Laravelの普通の使い方の範囲からタスクスケジュール、キュー程度ならどれでも使える。

Forgeはサーバー1台を丸ごと管理してるので大体なんでも可能。BlueskyのLabelerのようなnginxの設定変更が必要なことをするならForgeでしかできない。

VaporはAWS Lambdaの制約に縛られるのでできないことが多い。タスクスケジュールとキューはVapor側の機能でなんとか実現できているけど他のバックグラウンドプロセスを動かし続けることはできない。

CloudはForgeとVaporの中間。バックグラウンドプロセスを長時間動かせるけどForgeほどの自由はない。Laravelの一般的な使い方の範囲ならCloudで困らない。

1. データベースはパブリックアクセス可能
2. 休止中はタスクスケジュールやキューは動かない
3. コスト

_データベースはパブリックアクセス可能

Laravel CloudのデータベースはMySQL(休止なし)とPostgreSQL(休止あり)が選べてどちらもパブリックアクセス可能にできる。
複数アプリで共有可能。
Cloudを使うのさえもったいない規模のアプリはDBだけCloudを使ってVercelなどの他のサーバーから接続するのもあり。

_休止中はタスクスケジュールやキューは動かない

Laravel Cloudは自動休止で余計な費用を抑えるようになっているけどその間はタスクスケジュールやキューも動かない。
小規模アプリの用途なんてタスクスケジュールをきっかけにした自動化なので期待通りに動かないこともある。
1日1回の低頻度ならGitHub Actionsなどの外部サービスで実行するのもあり。DBと合わせればRDSに接続していた以前と同じことができる。

逆にずっと動かしていたいアプリは休止機能を無効に。

_コスト

最低限の月額で計算。

• Forge: 12ドル+VPS(RAM1GB)6ドル=18ドル
• Vapor 39ドル+AWS費用。AWS使ってる人なら分かるようにRDSが一番高い。
• Cloud: Starterプラン0ドル+App cluster(Ohio, 1flex, RAM256MiB)4ドル+DB(MySQL, 5GB)5ドル = 9ドル

Growthプランなら20ドル。Starterで十分なので現実的なRAM1GBにしても7ドル。1アプリならCloudが一番安い。
ただしForgeはVPS1台に複数アプリを載せられるのでアプリ数が多い場合はForgeのほうが安くなる可能性がある。
CloudはアプリごとにApp clusterが必要。代わりに休止機能で費用を抑える設計。

Laravel VPSはRAM2GBに上げると13ドル。上で書いたように下げられない。
Cloudはアプリごとに別サーバーで動いてるので少ないRAMでも大丈夫。
Laravel VPSで2GB必要だったアプリがCloudでは1GBで十分。

VirginiaとOhioのアメリカリージョンだけ少し安い。今後日本リージョンに対応しても若干高いはず。

1. 新しいForge
2. Laravel VPS
3. メールはAWS SES
4. ストレージはS3互換のCloudflare R2
5. キャッシュもセッションもキューもdatabaseドライバー

_新しいForge

今年リニューアルしたForgeはゼロダウンタイムデプロイに対応してるけど新しく登録したサイトでしか有効化できないのでこの機会に全サイトを新サーバーで再登録。

_Laravel VPS

Forgeからのみ起動できるVPS。実体はDigitalOceanなので日本リージョンがない。
若干の遅さはCloudflareを挟んでなんとか誤魔化す。

今まではRDSでデータベースを分けてたけど今回はVPS内にDBも入れて、複数VPSでDBを分ける構成に。
RDSが単一障害点になってたので分散。
DBのレコードが多いサイトはVPS1台に1サイトで割り当てて、軽いサイトは複数まとめて1台に。

今後また変えるかもしれないのでこれでいいだろう。

Laravel CloudはAWS EC2+Cloudflare。こっちも日本リージョンには未対応だけどAWSなら対応の可能性はあるのでいずれはLaravel Cloudかも。

_メールはAWS SES

これだけAWS。

_ストレージはS3互換のCloudflare R2

Laravelのドキュメントでは.envで環境変数設定すれば使えるように書いてるけど他のAWSサービスと併用する場合はAWSの環境変数をそのままは使いにくい。
config/filesystems.phpにR2用の設定を増やして環境変数も変える。どこにも情報ないので分かりにくいけどregionはautoにする。

        'r2' => [
            'driver' => 's3',
            'key' => env('R2_AWS_ACCESS_KEY_ID'),
            'secret' => env('R2_AWS_SECRET_ACCESS_KEY'),
            'region' => env('R2_AWS_DEFAULT_REGION', 'auto'),
            'bucket' => env('R2_AWS_BUCKET'),
            'url' => env('R2_AWS_URL'),
            'endpoint' => env('R2_AWS_ENDPOINT'),
            'use_path_style_endpoint' => env('R2_AWS_USE_PATH_STYLE_ENDPOINT', false),
            'throw' => false,
            'report' => false,
        ],

_キャッシュもセッションもキューもdatabaseドライバー

最近のLaravelはdatabaseがデフォルト。速度は遅いはずだけどそこまで気にする必要がないなら全部databaseドライバーにすると管理しやすい。

Horizonを使っている場合のみredis。

1. OpenID Connect (OIDC)での認証

_OpenID Connect (OIDC)での認証

一番便利なのはこれで、Code Climate QualityをGitHub Actionsで使うにはリポジトリごとにCC_TEST_REPORTER_IDを設定する作業が必要だった。一度だけとはいえ毎回は手間。

      - name: Test & publish code coverage
        uses: paambaati/codeclimate-action@v9
        env:
          CC_TEST_REPORTER_ID: ${{ secrets.CC_TEST_REPORTER_ID }}

これがQltyでは不要になった。GitHub Actionsのワークフローファイルにid-token: writeやoidc: trueを書いておくだけで自動で認証される。
ここの説明通り。

permissions:
  contents: read
  id-token: write

- name: Test
  run: vendor/bin/phpunit
- name: Code Coverage
  uses: qltysh/qlty-action/coverage@v1
  with:
    oidc: true
    files: build/logs/clover.xml

• リリース日：2025年2月24日
• バグ修正：2026年8月まで
• セキュリティ修正：2027年2月まで

1. ドキュメント
2. 必要なPHPバージョン

_ドキュメント

• Release Notes | Laravel 12.x - The clean stack for Artisans and agents

  Laravel is a PHP web application framework with expressive, elegant syntax. We've already laid the foundation — freeing you to create without sweating the small things.

  laravel.com/docs/12.x/releases
• Upgrade Guide | Laravel 12.x - The clean stack for Artisans and agents

  Laravel is a PHP web application framework with expressive, elegant syntax. We've already laid the foundation — freeing you to create without sweating the small things.

  laravel.com/docs/12.x/upgrade

_必要なPHPバージョン

• 8.2以上
  PHP 8.2 Released

  PHP 8.2 は、PHP 言語のメジャーアップデートです。読み取り専用クラス、独立した型 null, true, false、動的なプロパティの非推奨化などの機能や、パフォーマンスの向上が含まれています。

  www.php.net/releases/8.2/ja.php

あくまで開発環境までの話。本番環境で動かす話は含まない。

1. 環境
2. 新規プロジェクト作成
3. Breezeインストール
4. docker-compose.ymlでReverbも起動
5. .envの変更
6. Sail起動
7. ReverbはWebSocketサーバー
8. 新規ユーザーを作成
9. PresenceChannel
10. PrivateChannel
11. 最後の動作確認
12. 片付け
13. 終わり

_環境

• Laravel 11.x
• PHP 8.3
• Sail 1.x
• Breeze 2.x Inertia(Vue)
• Reverb 1.x

Horizonは開発環境では使いにくいのでなし。

将来のバージョンではこのまま真似しても動かない可能性が高いので注意。

_新規プロジェクト作成

curl -s "https://laravel.build/sail-reverb-project" | bash

cd sail-reverb-project

Laravel11ではブロードキャスト機能はデフォルトでは無効なのでインストールして有効化。ここでReverbも一緒にインストールされる。

php artisan install:broadcasting

_Breezeインストール

PrivateChannelやPresenceChannelも試したいのでスターターキットをインストール。今回はBreezeのVue版。好きなスターターキットを使えばいい。ReactならEchoを使うのでほとんど同じ。Livewireを使うのが最も簡単。

composer require laravel/breeze --dev

php artisan breeze:install vue

_docker-compose.ymlでReverbも起動

    reverb:
        image: sail-8.3/app
        ports:
            - '${REVERB_PORT:-8080}:8080'
        environment:
            WWWUSER: '${WWWUSER}'
            LARAVEL_SAIL: 1
        volumes:
            - '.:/var/www/html'
        command: php artisan reverb:start --debug
        restart: always
        networks:
            - sail
        depends_on:
            - mysql
            - redis

_.envの変更

Sailで起動するなら重要。

REVERB_HOSTはdocker-compose.ymlのサービス名と合わせる。
VITE_REVERB_HOSTはDockerの外から接続する用なのでlocalhost。

REVERB_HOST="reverb"
VITE_REVERB_HOST="localhost"

DB_HOST=mysqlと同様reverbの名前で接続できる。内部ではLaravelのlaravel.testからReverbのreverb:8080にリクエストを送っている。REVERB_HOSTを変更してないとlaravel.testからlocalhost:8080に送ろうとしてエラーになる。

_Sail起動

migrateしてviteのdevサーバー起動。

sail up -d

sail art migrate

sail npm run dev

Sail外でもいい。

npm run dev

_ReverbはWebSocketサーバー

Pusherやbeyondcode/laravel-websockets使ってた部分の代わりがReverb。前回の記事でのこの辺りの作業が全部不要になった。

_新規ユーザーを作成

ここからはブロードキャスト機能の確認。

簡易的なのでチャットっぽいものを作るだけ。DBにログは残さずその場だけのチャット。

• PresenceChannel : ログイン中のユーザー共通のチャット。
• PrivateChannel : 自分だけのチャット。

前回の記事と同じなのでコピーして最新のInertiaで動くように修正しただけ。

_PresenceChannel

長くなったのでコードはGitHubで。

処理の流れ

1. DashboardのPresenceChannel.vueを表示したらEcho.join('presence')でPresenceChannelに参加。
2. フォームからチャットを送信。
3. Laravel側のPresenceController→PresenceSubmitイベントと進んでPresenceSubmitからブロードキャスト。
4. フロント側に戻ってきて.listen('PresenceSubmit',で受信。

VueかReactで変わる表示部分は重要ではないのでこの流れを理解。

_PrivateChannel

PresenceChannelとほとんど同じなのでファイルをコピーしてPrivateChannel用を作成。

_最後の動作確認

2ユーザー作ってPresenceChannelには両方のチャットが表示、PrivateChannelには送信したユーザーだけ表示されることを確認。

_片付け

終了時は

sail down

viteはCtrl+Cで終了。

_終わり

ここまでできれば後はLaravelのドキュメントを見てブロードキャスト機能を使っていける。

1. ドキュメント
2. Meta for Developersで「アプリ」を作るまで
3. ユースケースのカスタマイズ
4. Socialite用のClient IDとClient Secret
5. Threadsのトークン
6. トークンの使用
7. Threadsテスターに追加した自分のアカウントに投稿
8. 自分の投稿を取得
9. Socialiteで認証
10. 長期トークンの更新
11. 更新

_ドキュメント

_Meta for Developersで「アプリ」を作るまで

• Facebookアカウントが必要なはず
• 「アプリを作成」
• 「ビジネスポートフォリオをリンクしない」
• ユースケースでThreads APIを選択

_ユースケースのカスタマイズ

アプリのダッシュボードまで進んだら、ユースケースからThreads APIの設定をカスタマイズ。

アクセス許可

threads_basicは必須なので最初から有効。投稿のためにthreads_content_publish、削除用にthreads_delete、検索用にthreads_keyword_searchも有効化する。

設定

Threadsテスターに自分のThreadsアカウントを追加。Threadsのウェブサイトで許可。トークンを生成。自分のアカウントに投稿するだけならこのトークンだけでいい。

Socialite/OAuthで認証してトークンを取得するならコールバックURLの設定も必要。これは後からでいい。

_Socialite用のClient IDとClient Secret

アプリ設定→ベーシックの「ThreadsアプリID」と「Threads App Secret」を使う。

上側に「アプリID」と「app secret」があるけどこっちは違う。

_Threadsのトークン

短期トークンと長期トークンがある。

Socialiteで取得できるのは短期トークン。短期トークンを長期トークンに変換すれば60日か90日間有効なトークンを得られる。長期トークンを更新すれば有効期限が伸びた新しい長期トークンを得られるので更新しながら使えばずっと使える。

Threadsテスターで生成されるのは最初から長期トークンなのでSocialiteは不要。

長期トークンの更新が必要なので.envに書いたままずっと使うことはできない。一人分だとしてもDBかキャッシュに保存して更新できるようにしておく。

APIの利用に必須なのは長期トークンだけなのでトークンについて理解できれば十分。

_トークンの使用

ドキュメントではクエリパラメータで使用しているけど

&access_token=<ACCESS_TOKEN>

AuthorizationヘッダーでもいいのでLaravelのHttpクライアントならwithToken()が使える。ちょっと投稿するだけならパッケージ使う必要はなくHttpクライアントでいい。

Http::withToken('')->post();

_Threadsテスターに追加した自分のアカウントに投稿

トークンはプロフィールページに入力欄作ってusersテーブルに保存して$user->threads_tokenで使える、と仮定。この辺は好きなように。

Threadsへの投稿は「text, image, videoを投稿する」と「publishで公開する」の2段階の工程が必要。

use Revolution\Threads\Facades\Threads;

Threads::token($user->threads_token);

$id = Threads::createText('test');
Threads::publish($id)

imageやvideoは公開されてるURLが必要。直接アップロードはできない。
Storage内のファイルを使うならurlで指定する。

use Revolution\Threads\Facades\Threads;
use Illuminate\Support\Facades\Storage;

Threads::token($user->threads_token);

$id = Threads::createImage(url: Storage::url('cat.png'), text: 'test');
Threads::publish($id)

動画の場合は30秒待ったほうがいいらしいのでpublish時に何秒sleepを入れるか指定できる。publish時に待ってもいいし、Threads::status()でチェックしてもいいし、キューで30秒遅らせてもいい。

use Revolution\Threads\Facades\Threads;
use Illuminate\Support\Facades\Storage;

Threads::token($user->threads_token);

$id = Threads::createVideo(url: Storage::url('dog.mov'), text: 'test');
Threads::publish($id, sleep: 30)

2段階に分かれてるのは複数のimage, videoをまとめて投稿できるカルーセル機能のためと予想。

use Revolution\Threads\Facades\Threads;
use Illuminate\Support\Facades\Storage;

Threads::token($user->threads_token);

$id1 = Threads::createImage(url: Storage::url('cat1.png'), is_carousel: true);
$id2 = Threads::createImage(url: Storage::url('cat2.png'), is_carousel: true);
$id = Threads::createCarousel(children: [$id1, $id2], text: 'test');
Threads::publish($id)

一時変数を使うのはLaravelらしくない使い方になるけどカルーセルのことを考えるとこれが無難。

_自分の投稿を取得

use Revolution\Threads\Facades\Threads;

$posts = Threads::token($user->threads_token)->posts()->json('data');

v0.3以降、posts()の返り値はIlluminate\Http\Client\Responseに変更。

        $posts->each(function (array $post) {
            //dump($post);
            // $post['text'] ?? '';
            // Arr::get($post, 'text');
        });

投稿データは「画像だけの投稿にはtextがない」とか意外と項目の抜けがあるので注意が必要。

取得件数のデフォルトは25。上限は100。limitで指定できる。

use Revolution\Threads\Facades\Threads;

$posts = Threads::token($user->threads_token)->posts(limit: 50);

全部省略できるけどposts()は引数が多くなった。
名前付き引数が登場してから「配列で渡す」や「専用のクラスを渡す」よりも「省略すればいいだけなので引数を増やす」傾向が強くなった。

_Socialiteで認証

configと.envに追加。

config/services.php

    'threads' => [
        // Threads App ID
        'client_id' => env('THREADS_CLIENT_ID'),
        // Threads App Secret
        'client_secret' => env('THREADS_CLIENT_SECRET'),
        'redirect' => env('THREADS_REDIRECT_URL', '/threads/callback'),
    ],

.env

THREADS_CLIENT_ID=
THREADS_CLIENT_SECRET=
THREADS_REDIRECT_URL=/threads/callback

ユースケースのコールバックURLのリダイレクト先を設定。
httpsが必須。localhostでも保存はできるけど実際には動かないかもしれない。
面倒なので最初からサーバーに公開して動かすのが早い。

コールバックURLリダイレクト：https://example.com/threads/callback
他2つは同じでもhttps://example.com/でもいい。必要なら後で設定。

routes/web.phpでの例。

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
use Laravel\Socialite\Facades\Socialite;
use Revolution\Threads\Facades\Threads;

Route::get('threads/redirect', function () {
    return Socialite::driver('threads')->redirect();
})->middleware('auth');

Route::get('threads/callback', function (Request $request) {
    if ($request->missing('code')) {
        dd($request);
    }

    /** @var \Laravel\Socialite\Two\User $user */
    $user = Socialite::driver('threads')->user();

    dump($user);

    $long_token = Threads::exchangeToken($user->token, config('services.threads.client_secret'))['access_token'];
    dump($long_token);

    $request->user()->fill(['threads_token' => $long_token])->save();

})->middleware('auth');

いつものSocialiteだけどThreads::exchangeToken()で短期トークンから長期トークンへの変換が必要。
長期トークンさえ取得できれば後はThreadsテスターと同じ。

_長期トークンの更新

ここまでは省略してるけど使う時に毎回更新するか、タスクスケジュールで定期的に更新する。

use Revolution\Threads\Facades\Threads;

$token = Threads::token($user->threads_token)->refreshToken()['access_token'] ?? null;
$user->fill(['threads_token' => $token])->save();

_更新

• 2025/06 v0.3以降のパッケージでは返り値をarrayからIlluminate\Http\Client\Responseに変更しているので記事内のコードは古いかもしれない。