Jak funguje @return $this ve vašem IDE?

Díky @Xethilos, doplněno. Používáte někdo novější Eclipse? Co takhle Komodo nebo phpDesigner? Něco jiného?

Beru i chytré textové editory s pluginy pro PHP, chci prostě získat přehled. I o tom, co tady kdo v současnosti používá.

Zkusil jsem Eclipse Mars (4.5) a nic jiného, kromě self nepodporuje, přičemž self chápe jako static, takže následující kód funguje bez problému:

$input = new Nette\Forms\Controls\RadioList();
$input->setRequired(TRUE)->getSeparatorPrototype();

ad ApiGen – když tam doplní aktuální třídu, tak rozhodně nelže. Všechny navrácené hodnoty budou instancí (instanceof) té dané třídy. Kdyby PHP byl staticky typovaný jazyk, tak by jako typ návratové hodnoty byla taky uvedena samotná třída.

@jannek19: Díky za účast. Výsledek mě dost překvapil, takže jsem ho pro jistotu ověřil. Fakt že jo, dokud do anotace nenapíšu @return B, tak mi ST3 nerozpozná dva jako funkci. To je teda materiál…

PhpStorm 8.0.2:

• self – ano (chápe jako self)
• static – ano (chápe jako static)
• $this – ano (chápe jako static)
• this – ne – podle mě to bere jako normální název třídy

Doplním jak se k tomu staví ostatní frameworky (prošel jsem náhodné kusy kódu):

• Laravel používá zápis return $this
• Symfony používá zápis return ClassName + výjimečně return $this
• Zend používá return ClassName

Btw, interesting thing is that return self works as static and static is parse error http://3v4l.org/TvJjC. This is the end of discussion about @return self vs static.

return self funguje jako return self (tj. stejně jako return X v odkázaném příkladu), ale pochopitelně můžeš vrátit o podtyp.

Kdyby to fungovalo jako return static, tak by prošlo http://3v4l.org/vpMAS. Je to z toho důvodu, že PHP nepodporuje „Covariant return types“. V původním RFC to sice bylo, ale pak kluci z internals zjistili, že vzhledem k architektuře PHP to nejde naimplementovat.

Sorry, ztrácím se v tom, co jste chtěli říct, kluci ( @DavidGrudl a @JanTvrdík ). Pochopil jsem, že David upozornil na novou fíčuru PHP 7, která umožňuje definovat typ návratové hodnoty metody. Z typů, které tu probíráme zná pouze „self“ a rozumí pod tím objekt, přes nějž jsme metodu volali. Následující kód vrátí object(B)#1 (0) { }

<?php
class A { function test() : self { return $this; } }
class B extends A {}

$b = new B;
var_dump($b->test());
?>

Nevím, kde najít definici slova „static“, ale tohle vypadá jako to, o co mi v tomhle vlákně šlo.
Je mi jedno, co napíšeme do @return, já jen potřebuju, aby mi IDE (PhpStorm) napovídal potomky.

Honza pak upozornil, že návratovou hodnotu self nejde použít u přetěžovaných funkcí. Následující kód hodí chybu: `Fatal error: Declaration of B::test() must be compatible with A::test(): A `

<?php
class A { function test(): self { return $this; } }
class B extends A {	function test(): self { return $this; } }
?>

Takže to nakonec není ten static, o který mi v tomto vlákně šlo :-) Pochopil jsem to dobře?

Je z toho nějaký závěr? Jedeme dál přes PHPDoc a nadále se „static“ „self“?

Editoval petr.pavel (15. 8. 2015 14:22)

TridaRodice a self je z pohledu PHP to samé. To, co tě zajímá, je static.

Sám používám @return self ve smyslu @return static (jinak použiju return ClassName).

Diskuse je vlastně o tom, jestli nahradit @return self za @return static (ostatní varianty $this a this vůbec nepřipadají v úvahu, to první není typ a nelze použít pro return new static, to druhé představuje třídu s názvem this).

Nahradit by to v podstatě šlo, byť by bylo samozřejmě potřeba opravit ApiGen. (Zkomplikovalo by mi to život s PhpEd 8.1, který typu static nerozumí, což není podstatné, ale je to důvod, proč jsem takovou změnu sám neudělal.)

Nicméně přichází PHP 7, které umožňuje uvádět typy návratových hodnot, takže spousta anotací @return bude moci být nahrazena přímo kódem. A návratový typ může být jen self, nikoliv static.

Což dává smysl. Jenže tím se situace komplikuje ještě víc. Anotace @return static nemůže být plně nahrazena typehintem. Buď se na to rezignuje, nebo se bude kombinovat typehint s anotací, přičemž absolutně netušíme, jak takovou věc budou chápat editory.

Jinými slovy, situace se v případě PHP7 vrací na začátek.

David Grudl napsal(a):
(ostatní varianty $this a this vůbec nepřipadají v úvahu…)

To záleží, jak budeme chápat syntaxi PHPDoc pro @return. Existuje někde oficiální definice PHPDoc? Mám dojem, že ne. Takže je to de facto standard odvozený z jiného jazyka… a proč si ho nepřiohnout. Vnímám to tak, že phpdoc.org je o programu a o tom, co tento program podporuje, ne o standardu.

Ty předpokládáš @return <název střídy|self|static>. Pokud bychom byli ze srdce přesvědčení, že ten standard by měl být rozšířen na @return <název střídy|self|static|brundibal>, tak proč ne? Samozřejmě, je tu otázka, jak tento „rozšířený standard“ budou podporovat ostatní.

přičemž absolutně netušíme, jak takovou věc budou chápat editory.

Přesně tak. Už teď je v tom roky bordel, těžko říct, jestli PHP 7 self bude IDE motivovat k nějaké snaze o sjednocení.

Mě z toho vychází, že kromě „počkáme a uvidíme“ můžeme taky aktivně zaujmout stanovisko :-) a pokusit se ho protlačit. Přeci jen, třeba právě teď zrovna někdo z PhpEd brouzdá po webu a říká si „Safra, co s tím @return self, mrknu se, jak to dělají jinde. Hele Nette, to je pořádný framework…“

Rád bych ti slíbil, že ti pro to do PhpEd napíšu doplněk, ale to nedám. :-(