malalam
Messages postés10839Date d'inscriptionlundi 24 février 2003StatutMembreDernière intervention 2 mars 201025 8 sept. 2006 à 09:54
Hello,
il s'agit d'une convention de nommage pour les commentaires de codes php.
Ils proviennent essentiellement d'un outil opensource qui s'appelle phpdocumentor (enfin...je veux dire que c'est plus ou moins grâce à ce package que cette norme existe).
franco_se
Messages postés151Date d'inscriptionsamedi 1 novembre 2003StatutMembreDernière intervention30 juillet 20182 8 sept. 2006 à 11:26
A noter tout de meme su'il ne faut pas confondre cette norme, avec l'utilisation du @ suivie d'une fonction. dans ce cas du figure, il premet d'eviter le renvoi d'une erreur.
Par exemple, tu fais un include vers une page qui n'existe pas:
# include('page.php');
Cela renverra une erreur du type
Warning: include(page.php) [function.include]: failed to open stream: No such file or directory in C:\Program Files\xampp\htdocs\Untitled-1.php on line 2
Warning: include() [function.include]: Failed opening 'page.php' for inclusion (include_path='.;C:\Program Files\xampp\php\pear\') in C:\Program Files\xampp\htdocs\Untitled-1.php on line 2
avec @function(), l'erreur existera toujours, mais aucun message ne sera renvoyé.
cs_Anthomicro
Messages postés9433Date d'inscriptionmardi 9 octobre 2001StatutMembreDernière intervention13 avril 20078 8 sept. 2006 à 19:08
Salut,
à noter : ça provient de la javadoc qui utilise cette convention. Lorsque tu renseignes tes méthodes et attributs avec cette convention, java peut te générer une documentation en html automatique.
malalam
Messages postés10839Date d'inscriptionlundi 24 février 2003StatutMembreDernière intervention 2 mars 201025 9 sept. 2006 à 01:33
En effet, Antho a raison, au tout départ, cela nous vient de java :-)
Avec le temps, c'est devenu une norme répandue et utilisée par plusieurs générateurs de documentation pour PHP.
Vous n’avez pas trouvé la réponse que vous recherchez ?