$request->filled()

リクエストフィルド（リクエストとバリデーション）

意味キーの存在と値の確認

$request->filled()とは？

$request->filled()は、Laravelのリクエストオブジェクトで特定のキーが存在し、かつその値が空でないことを確認するメソッドです。指定したキーが存在し、値が空文字列、null、または空の配列でない場合にtrueを返します。

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

検索クエリの存在と非空値確認

public function search(Request $request)
{
    if ($request->filled('query')) {
        $searchTerm = $request->input('query');
        return '検索クエリ: ' . $searchTerm;
    } else {
        return '検索クエリが入力されていないか、空です。';
    }
}

👇出力結果

検索クエリ: ユーザー入力（または検索クエリが入力されていないか、空です。）

この例では、'query'キーが存在し、値が空でない場合に検索クエリを表示します。検索フォームでユーザーが実際に何かを入力した場合にのみ処理を行うのに適しています。

複数の必須フィールドチェック

public function registerUser(Request $request)
{
    if ($request->filled(['name', 'email', 'password'])) {
        return '全ての必須フィールドが入力されています。ユーザー登録を進めます。';
    } else {
        return '一部の必須フィールドが入力されていないか、空です。';
    }
}

👇出力結果

全ての必須フィールドが入力されています。ユーザー登録を進めます。（または一部の必須フィールドが入力されていないか、空です。）

この例では、ユーザー登録フォームで'name'、'email'、'password'の全てのフィールドが存在し、かつ空でないことを確認しています。全てのフィールドが適切に入力されている場合にのみ登録処理を進めます。

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

Q. $request->filled()と$request->has()の違いは？

A. $request->filled()はキーの存在に加えて、値が空でないことも確認します。一方、$request->has()はキーの存在のみを確認し、値が空でもtrueを返します。

Q. どんな値が「空」とみなされる？

A. null、空文字列('')、空の配列([])が「空」とみなされます。0や'0'は空とみなされません。

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

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

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

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

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