Если в своём проекте вы следуете PSR-11, используя контейнеры для зависимостей, то наверняка сталкиваетесь с проблемой автокомплита кода в вашей IDE. PHP, к великому сожалению, не поддерживает generic’и и нельзя указать какой тип будет у возвращаемого значения.

Обычно это решается при помощи дополнительного phpdoc’а для переменной. PHPStorm позволяет настроить файл с meta-данными для проекта.

Читать статью