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).
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é.
à 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.
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 ?