Интерфейсы PHP 7, хинтинг типа возвращаемого значения и self

self не относится к экземпляру, это относится к текущему классу. Интерфейс не может указать, что должен быть возвращен один и тот же экземпляр - использование self в той манере, которую вы пытаетесь сделать, только принудит, чтобы возвращаемый экземпляр был того же класса.

Тем не менее, объявления возвращаемого типа в PHP должны быть инвариантными, в то время как то, что вы пытаетесь сделать, является ковариантным.

Использование вами self эквивалентно:

interface iFoo
{
    public function bar (string $baz) : iFoo;
}

class Foo implements iFoo
{

    public function bar (string $baz) : Foo  {...}
}

что не допускается.

В объявлениях типа возврата RFC есть вот что сказать:

Применение объявленного возвращаемого типа во время наследования инвариантно; это означает, что когда подтип переопределяет родительский метод, тогда тип возвращаемого значения дочернего элемента должен точно соответствовать родительскому и не может быть пропущен. Если родитель не объявляет возвращаемый тип, потомку разрешается объявить его.

...

Этот RFC изначально предлагал ковариантные возвращаемые типы, но был изменен на инвариантный из-за нескольких проблем. В какой-то момент в будущем возможно добавить ковариантные возвращаемые типы.

На данный момент лучшее, что вы можете сделать, это:

interface iFoo
{
    public function bar (string $baz) : iFoo;
}

class Foo implements iFoo
{

    public function bar (string $baz) : iFoo  {...}
}

Это также может быть решением, если вы не определяете явно тип возвращаемого значения в интерфейсе, только в PHPDoc, а затем вы можете определить определенный тип возвращаемого значения в реализациях:

interface iFoo
{
    public function bar (string $baz);
}

class Foo implements iFoo
{
    public function bar (string $baz) : Foo  {...}
}

В случае, если вы хотите принудительно из интерфейса, этот метод вернет объект, но тип объекта будет не типом интерфейса, а самим классом, тогда вы можете написать это так:

interface iFoo {
    public function bar(string $baz): object;
}

class Foo implements iFoo {
    public function bar(string $baz): self  {...}
}

Он работает с PHP 7.4.

PHP 8 добавит статический тип возврата, который решит вашу проблему.

Ознакомьтесь с этим RFC: https://wiki.php.net/rfc/static_return_type

Мне это кажется ожидаемым поведением.

Просто измените свой метод Foo::bar, чтобы он возвращал iFoo вместо self, и покончим с этим.

Объяснение:

self при использовании в интерфейсе означает «объект типа iFoo».
self при использовании в реализации означает «объект типа Foo».

Следовательно, типы возвращаемых значений в интерфейсе и реализации явно не совпадают.

В одном из комментариев упоминается Java и будет ли у вас эта проблема. Ответ - да, у вас была бы такая же проблема , если бы Java позволяла вам писать подобный код - а это не так. Поскольку Java требует, чтобы вы использовали имя типа вместо PHP self ярлык, вы никогда этого не увидите. (См. здесь для обсуждения аналогичная проблема в Java.)