[Doc] Mutateurs/Accesseurs PHP5, comment faites vs ?

[ePoX]

Salut,

Je ne fais habituellement jamais de doc générée (oui je sais pas bien), mais la j'ai envie d'essayer.
Par contre d'après mes divers test je n'ai pas trouvé de quoi documenter mes accesseurs/mutateurs.....
Qui pourtant joue un rôle très important.

Peut être n'ai je pas assez cherché, mais bon je me demandais si vous le faisiez, si oui comment, avec quels outils, quels méthodes ect.

Merci pour vos réponses,
bye

PS : Je parle bien des méthodes __set / __get.

[jeff_!]

salut
j'ai jamais tester
mais est-ce que cela a un sens de documenter __set/__get/__call?

[ePoX]

Si je pose la question c'est que je pense bien que oui...
Si je fais une doc HTML ce n'est pas pour aller trifouiller dans le code PHP des classe.
Sachant que les getters/setters peuvent apporter une plus value il me semble important de les documenter.

pour __call c'est effectivement pas trop necessaire vu comme sa... Mais bon je ne m'en suis jamais trop servi j'ai quelques difficulté à appréhender la portée de se mot clef...

Pour en revenir sur les getters, si j'ai une classe de date (par exemple) à base de timestamp (imaginons).
Pour exposer une transformation du timestamp il y 'à de fortes chance que j'utilise les getter.
Et non pas une fonction.

Si mes getters ne sont pas documenter je vais perdre une grande partie des capacités de la classe lors de la lecture de la doc HTML.

Fin c'est comme sa que je voit les choses....

bye

PS : je dit doc HTML mais sa pourrait fait en grain de sable ou cacahuètes se serait pareil...

[ska_root]

salut,

les accesseurs sont des fonctions comme les autres... tu peux donc les documenter avec tous les tags réservés au fonctions.

moi j'utilise phpDocumentor, il y a une doc bien fournie... je le trouve pratique, bon j'en ai pas essayé d'autres non plus...

[ePoX]

Tu peux m'expliquer une peu comment tu les documentes avec PhPdocumentator ??

Merci