@use, @return @author... c'est quoi ?Résolu

Question

Comme le pose la question : dans certains codes du site, je trouve dans les scripts ceci
   @use
   @return
   @author
   @require

C'est quoi extactement ? J'ai fait des rechers sur le web mais je trovue pas ce que c'est !
Merci

malalam · Accepted Answer

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 · Answer

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 · Answer

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. a +

Entraide, dépannage et vulgarisation informatique : Mon site de vulgarisation informatique

malalam · Answer

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.

Epoc22 · Answer

merci les gars vous m'avez appeir un nouveau truc dans ma pauvre vie..

aller ciao @@+++ tout le monde !

In PHP We Trust

@use, @return @author... c'est quoi ?

5 réponses

Votre réponse