Какова цель использования аннотации @method phpdoc для интерфейса вместо подписи метода ⇐ Php

[Anonymous]

Я смотрю на код Laravel Fortify. В поставщике услуг вы можете зарегистрировать классы действий для выполнения определенных заданий, подобных этим: < /p>

Код: Выделить всё

Fortify::createUsersUsing(CreateNewUser::class);
Fortify::updateUserProfileInformationUsing(UpdateUserProfileInformation::class);

Они связывают данный класс действия с интерфейсом в сервисном контейнере.
Интерфейс CreateSerewuser реализации достаточно типичны:

Код: Выделить всё

interface CreatesNewUsers
{
/**
* Validate and create a newly registered user.
*
* @param  array  $input
* @return \Illuminate\Foundation\Auth\User
*/
public function create(array $input);
}

Но интерфейс UpdateUserProfileinformation Реализации кажется странным:

Код: Выделить всё

/**
* @method void update(\Illuminate\Foundation\Auth\User $user, array $input)
*/
interface UpdatesUserProfileInformation
{
//
}
< /code>
Почему бы не определить подпись метода обычным способом? Что -то вроде этого: < /p>
interface UpdatesUserProfileInformation
{
public function update(\Illuminate\Foundation\Auth\User $user, array $input): void;
}

Какова цель использования аннотации @method ? Чего он достигает?

Подробнее здесь: https://stackoverflow.com/questions/797 ... ce-instead