Autor Zpráva
Milan1236000
Profil
Zdravím, v php jsem znám jen tyto komentáře
// jednořádkový
/* více-
řádkový */

Tohle je taky komentář?
/** komentář jinou barvou
* (PSPad ho obarvuje jinak než klasický komentář) */
jefitto44
Profil
To je to isté, kvôli prehľadnosti to takto píšu. Je to proste niečo ako dokumentácia k funkciám. Tuším existujú aj nejaké programy, čo to vedia čítať a generovať z toho dokumenty atď atď.

V skutočnosti je to to isté, čo /*vice
radkovy */

V podstate je už jedno, čo je medzi hviezdičkami
Fisir
Profil
Reaguji na Milana1236000:
To je PHPDoc komentář. Ty slouží k dokumentaci tříd, metod, funkcí a dalších věcí. Když bys použil nějaké PHP IDE, tak ti podle obsahu těchto komentářů bude napovídat například datové typy parametrů funkcí. Pak taky existují nástroje, které proskenují soubory tvého projektu a na základě těchto komentářů vytvoří online dokumentaci tříd a metod. To pak ale není jedno, co do takového komentáře vložíš (jak píše jeffitto44), ale je třeba dodržet definovaný formát.
Radek9
Profil
PHPDoc komentáře je navíc možné za běhu číst pomocí ReflectionClass::getDocComment, ReflectionFunctionAbstract::getDocComment a ReflectionProperty::getDocComment, což využívají i některé ORM frameworky (namátkou si vzpomenu na Doctrine). Všechny ostatní komentáře se zahazují.
Milan1236000
Profil
Skvěle, díky všem za informace.

Vaše odpověď

Mohlo by se hodit


Prosím používejte diakritiku a interpunkci.

Ochrana proti spamu. Napište prosím číslo dvě-sta čtyřicet-sedm: