$request->missing()

リクエストミッシング（リクエストとバリデーション）

意味キーの不在確認

$request->missing()とは？

$request->missing()は、Laravelのリクエストオブジェクトで特定のキーが存在しないことを確認するメソッドです。指定したキーがリクエストデータに含まれていない場合にtrueを返し、含まれている場合にはfalseを返します。

$request->missing()の具体的な使い方

必須パラメータの欠落チェック

public function apiRequest(Request $request)
{
    if ($request->missing('api_key')) {
        return response()->json(['error' => 'APIキーが必要です。'], 400);
    }
    
    return response()->json(['success' => 'APIキーが提供されています。']);
}

👇出力結果

{"error":"APIキーが必要です。"}（または{"success":"APIキーが提供されています。"}）

この例では、APIリクエストに'api_key'パラメータが含まれていない場合にエラーメッセージを返します。APIキーが必須のエンドポイントで使用することができます。

複数の必須パラメータチェック

public function createPost(Request $request)
{
    $requiredParams = ['title', 'content', 'author_id'];
    
    $missingParams = array_filter($requiredParams, function($param) use ($request) {
        return $request->missing($param);
    });
    
    if (!empty($missingParams)) {
        return response()->json([
            'error' => '以下のパラメータが欠落しています: ' . implode(', ', $missingParams)
        ], 400);
    }
    
    return '全ての必須パラメータが提供されています。投稿を作成します。';
}

👇出力結果

{"error":"以下のパラメータが欠落しています: title, content"}（または全ての必須パラメータが提供されています。投稿を作成します。）

この例では、ブログ投稿の作成に必要な複数のパラメータ（タイトル、内容、著者ID）が全て存在するかチェックします。欠落しているパラメータがある場合、それらを列挙したエラーメッセージを返します。

$request->missing()に関するよくある質問

Q. $request->missing()の用途は？

A. 必須パラメータが欠落していないかチェックする際に使用します。特にAPIのバリデーションで、必要なパラメータが提供されていないケースを検出するのに役立ちます。

Q. $request->has()の反対？

A. はい、$request->missing()は$request->has()の逆の動作をします。has()がtrueを返す場合、missing()はfalseを返し、その逆も同様です。

Q. 複数のキーを同時にチェックできる？

A. はい、$request->missing(['key1', 'key2'])のように配列を渡すことで、複数のキーが全て存在しないことを同時にチェックできます。どれか1つでも存在すればfalseを返します。

$request->missing()が学べる書籍の紹介

「プログラミング単語帳」を使って、プログラミングの単語を英単語のように学習してみませんか？
プログラミング単語帳には、Laravelの$request->missing()や$request->file()、$request->hasFile()、$request->validate()、などのような実務でよく使われる単語が数百以上収録されています。
この書籍には、プログラミングの単語の意味や読み方、単語の使い方がわかる例文などが掲載されており、いつでもどこでもプログラミングの学習ができます。

よく使われる単語にだけ絞って学習することができるので、効率的にプログラミングが学習できます。