フォームリクエストバリデーションでsometimesを利用する

ドキュメントにあるsometimesメソッドは他方のフィールドの値によって自身のフィールドのルールを追加できる便利な関数です。

公式のドキュメントを読んでも、sometimesメソッドはValidatorインスタンスの関数であることは書かれているのですが、フォームリクエストからの呼び出し方については書かれていません。

フォームリクエストからValidatorインスタンスにアクセスするにはwithValidatorメソッドを利用します。withValidatorメソッドはIlluminate\Foundation\Http\FormRequestクラスのgetValidatorInstanceメソッドの中で呼ばれます。
ドキュメントを確認すると、Laravel 9.xまでは記載があるのですが、10.xからは記載がありませんが実装はされています。

実装サンプルは下記のようになります。

StorePostRequest.php

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Support\Fluent;
use Illuminate\Validation\Validator;

class StorePostRequest extends FormRequest
{
    /**
     * Determine if the user is authorized to make this request.
     */
    public function authorize(): bool
    {
        return false;
    }

    /**
     * Get the validation rules that apply to the request.
     *
     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
     */
    public function rules(): array
    {
        return [
            //
        ];
    }

    /**
     * Configure the validator instance.
     *
     * @param  \Illuminate\Validation\Validator  $validator
     * @return void
     */
    public function withValidator(Validator $validator)
    {
        $validator->sometimes('reason', 'required|max:500', function (Fluent $input, Fluent $data) {
            return $input->games >= 100;
        });
    }
}

似たような機能としてafterメソッドがあります。こちらはバリデーションの実施後に追加でバリデーションを行う機能となります。つまり、rulesメソッドで定義したルールに従ってバリデーションが行われた後なので、sometimesメソッドでルールを追加してもバリデーションが行われません。

[AD]