参考サイト：中国語（$request->validate()源码解读）

私は英語はあまりできないですが中国語は得意なので、中国語のサイトで調べることも多いです。というわけでここで書いてある内容は参考サイトにも書いてあるので、個人的なメモとして残しておきます。

validateメソッドとは

そしてLaravelのソースを見ていてなんだこりゃってのがありました。

@method array validate(array $rules, ...$params)

ところでこのvalidateはどこに定義されてるのか？ってお話で、この答えがtraitのMacroableになります。

※Requestクラスでuseしています。

/**
     * Dynamically handle calls to the class.
     *
     * @param  string  $method
     * @param  array  $parameters
     * @return mixed
     *
     * @throws \BadMethodCallException
     */
    public function __call($method, $parameters)
    {
        if (! static::hasMacro($method)) {
            throw new BadMethodCallException(sprintf(
                'Method %s::%s does not exist.', static::class, $method
            ));
        }

        $macro = static::$macros[$method];

        if ($macro instanceof Closure) {
            $macro = $macro->bindTo($this, static::class);
        }

        return $macro(...$parameters);
    }

ここで$macro = static::$macros[$method];という記載がありますが、この$macros配列はどうなっているのでしょうか？

空っぽの配列の定義はあるのですが、これがどこから来ているのか

trait Macroable
{
    /**
     * The registered string macros.
     *
     * @var array
     */
    protected static $macros = [];

すぐ下に定義されているメソッドを介して、配列に値が登録されることは明白です

/**
     * Register a custom macro.
     *
     * @param  string  $name
     * @param  object|callable  $macro
     * @return void
     */
    public static function macro($name, $macro)
    {
        static::$macros[$name] = $macro;
    }

FoundationServiceProvider

Foundationというのは土台とか基礎とかそういった意味があります。このサービスプロバイダーが鍵を握っています。

config/app.phpを見ると、このクラスの登録が行われています。

Illuminate\Foundation\Providers\FoundationServiceProvider::class,

そしてこのクラスのregisterメソッドに答えが書いてあります。

/**
     * Register the "validate" macro on the request.
     *
     * @return void
     *
     * @throws \Illuminate\Validation\ValidationException
     */
    public function registerRequestValidation()
    {
        Request::macro('validate', function (array $rules, ...$params) {
            return validator()->validate($this->all(), $rules, ...$params);
        });

        Request::macro('validateWithBag', function (string $errorBag, array $rules, ...$params) {
            try {
                return $this->validate($rules, ...$params);
            } catch (ValidationException $e) {
                $e->errorBag = $errorBag;

                throw $e;
            }
        });
    }

先ほどの配列への登録メソッドを呼び出しています。validateというkeyにValidatorのvalidateメソッドを登録しています。

/**
     * Create a new Validator instance.
     *
     * @param  array  $data
     * @param  array  $rules
     * @param  array  $messages
     * @param  array  $customAttributes
     * @return \Illuminate\Contracts\Validation\Validator|\Illuminate\Contracts\Validation\Factory
     */
    function validator(array $data = [], array $rules = [], array $messages = [], array $customAttributes = [])
    {
        $factory = app(ValidationFactory::class);

        if (func_num_args() === 0) {
            return $factory;
        }

        return $factory->make($data, $rules, $messages, $customAttributes);
    }

しかしこのValidatorを追ってみるとValidationFactory::classというのはインターフェースであるので、どこで実装クラスの紐づけが行われているのか？

<?php

namespace Illuminate\Contracts\Validation;

interface Factory
{

vendor\laravel\framework\src\Illuminate\Foundation\Application.phpに関係が記載されています。

'validator' => [\Illuminate\Validation\Factory::class, \Illuminate\Contracts\Validation\Factory::class],

つまり上記に従えばIlluminate\Validation\Factory.phpが該当します。

/**
     * Create a new Validator instance.
     *
     * @param  array  $data
     * @param  array  $rules
     * @param  array  $messages
     * @param  array  $customAttributes
     * @return \Illuminate\Validation\Validator
     */
    public function make(array $data, array $rules, array $messages = [], array $customAttributes = [])
    {
        $validator = $this->resolve(
            $data, $rules, $messages, $customAttributes
        );

        // The presence verifier is responsible for checking the unique and exists data
        // for the validator. It is behind an interface so that multiple versions of
        // it may be written besides database. We'll inject it into the validator.
        if (! is_null($this->verifier)) {
            $validator->setPresenceVerifier($this->verifier);
        }

        // Next we'll set the IoC container instance of the validator, which is used to
        // resolve out class based validator extensions. If it is not set then these
        // types of extensions will not be possible on these validation instances.
        if (! is_null($this->container)) {
            $validator->setContainer($this->container);
        }

        $validator->excludeUnvalidatedArrayKeys = $this->excludeUnvalidatedArrayKeys;

        $this->addExtensions($validator);

        return $validator;
    }

これ普通にやってるとは自分では紐解けないです。。それでも今回は@method array validate(array $rules, …$params)ってなんやねん？って疑問について少しは解消できたかと思います。

LaravelのRequest::validateとMacroable