【Laravel】$requestの値を変更する方法

▶

この記事の要点
Laravel で `$request` の値を変更したい場合は `merge()` / `replace()` `$request->merge([...])`: 既存値はそのまま、追加・上書き `$request->replace([...])`: 全部置き換え個別: `$request->headers->set(...)`（ヘッダ）ミドルウェアで前処理するのが推奨パターン

Request の値を変更する 3 つの方法

① merge() - 既存値はそのまま、追加・上書き

use Illuminate\Http\Request;

public function store(Request $request)
{
    // 元の入力に user_id を追加
    $request->merge([
        'user_id' => auth()->id(),
        'created_at' => now(),
    ]);

    // 既存キーがあれば上書きされる
    $request->merge(['status' => 'pending']);

    // この時点で $request->input('user_id') が取れる
    User::create($request->all());
}

② replace() - 全部置き換え

public function store(Request $request)
{
    // 元の入力を完全に上書き
    $request->replace([
        'name' => 'NewName',
        'email' => 'new@example.com',
    ]);
    // この時点で他のフィールドはすべて消える
}

③ 個別キーの設定

// 単一キーの追加・変更
$request->offsetSet('key', 'value');

// 配列アクセスで
$request['key'] = 'value';

// オブジェクトのように代入 (Laravel 8+)
$request->key = 'value';

Header の変更

// 追加・上書き
$request->headers->set('X-Custom-Header', 'value');

// 削除
$request->headers->remove('X-Custom-Header');

// 取得
$value = $request->header('X-Custom-Header');

Query Parameter の変更

// すべての query を取得
$queries = $request->query();

// 単一 query 変更
$request->query->set('page', 2);

// 全部置き換え
$request->query->replace(['page' => 1, 'limit' => 20]);

ミドルウェアで前処理する（推奨）

コントローラ内で $request を変更するより、ミドルウェアで前処理する方が責務分離できます:

// app/Http/Middleware/AddUserToRequest.php
namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class AddUserToRequest
{
    public function handle(Request $request, Closure $next)
    {
        if (auth()->check()) {
            $request->merge([
                'user_id' => auth()->id(),
                'user_name' => auth()->user()->name,
            ]);
        }
        return $next($request);
    }
}

// app/Http/Kernel.php
protected $middlewareGroups = [
    'web' => [
        // 既存のミドルウェア...
        \App\Http\Middleware\AddUserToRequest::class,
    ],
];

// または特定ルートで
Route::post('/posts', [PostController::class, 'store'])
    ->middleware(AddUserToRequest::class);

FormRequest で前処理する

バリデーション前後で値を加工:

// app/Http/Requests/StorePostRequest.php
class StorePostRequest extends FormRequest
{
    // バリデーション前に値を加工
    protected function prepareForValidation()
    {
        $this->merge([
            'slug' => Str::slug($this->title),
            'user_id' => auth()->id(),
        ]);
    }

    public function rules()
    {
        return [
            'title' => 'required|max:100',
            'slug' => 'required|unique:posts,slug',
            'user_id' => 'required|exists:users,id',
        ];
    }

    // バリデーション通過後の加工
    protected function passedValidation()
    {
        $this->merge([
            'content_html' => Str::markdown($this->content),
        ]);
    }
}

注意点

1. all() / input() のキャッシュ

Laravel は $request->all() の結果を内部的にキャッシュすることがあります。merge 後は再取得:

$data = $request->all();
$request->merge(['foo' => 'bar']);
$data2 = $request->all();  // 再取得すると foo が含まれる

2. validated() は変更前の値を見る場合がある

public function rules() { return ['name' => 'required']; }

// バリデーション後に merge しても validated() には反映されない
$request->validate($rules);
$request->merge(['name' => 'New']);
$validated = $request->validated();  // 元の値のまま

// 反映したい場合は prepareForValidation で merge

3. JSON リクエストでは all() に注意

JSON ボディと query 両方ある場合の挙動を確認してください:

// POST /users?source=admin
// Body: {"name": "Alice"}

$request->all();         // ['source' => 'admin', 'name' => 'Alice']
$request->query();       // ['source' => 'admin']
$request->json()->all(); // ['name' => 'Alice']
$request->input('name'); // 'Alice' (両方から検索)

エラー一覧 (Laravel)

編集

子ページ

子ページはありません

同階層のページ

2026-05-15 04:49:31 T 8712

最近更新/作成されたページ

Laravel キャッシュクリア完全ガイド（cache:clear / config:clear / 2026-05-18 07:42:07
プロジェクトの作成と削除 2026-05-18 07:42:07
インストール直後にNetbeansが反応しない 2026-05-18 07:42:07
動画やチャンネルの検索 2026-05-18 07:42:07
APIキー取得方法 2026-05-18 07:42:07
チャンネル情報の取得 2026-05-18 07:42:07
API 入門 — Web API（REST / GraphQL / gRPC / 2026-05-18 07:42:07
インストール(eclipseプラグイン) 2026-05-18 07:42:07
Laravel「Dotenv values containing spaces must be surrounded 2026-05-18 07:42:07
エラー一覧 2026-05-18 07:42:07
curl: (51) SSL: certificate subject name '～' does not match 2026-05-18 07:42:07
インストール方法(Windows版) 2026-05-18 07:42:07
JSONから配列に変換 2026-05-18 07:42:07
処理を一定時間待つ 2026-05-18 07:42:07
A non well formed numeric value encountered 2026-05-18 07:42:07

ページ一覧

その他