-
:salut: Premièrement et en temps que petit nouveau parmi vous, bien le bonjour
J'ai lu avec attention et intérêt l'ensemble du topic.
J'utilise personnellement PHP Documentor et j'ai découvert récemment PHPXref que je teste actuellement.
Personnellement il me conviendrait mieux que PHP Documentor, sauf que je rencontre un petit problème :
- En local tout va bien
- Dès que je le mets en ligne, tous les fichiers *.php me donne un erreur : "Vous n'avez pas d'accès..."
Quelqu'un d'entre-vous utilise-t-il ce soft et aurait-il déjà eu ce problème ?
-
Yep jbboschung,
Dis moi je viens de voir ta trouvaille : "PhpXref"
Je m'y suis donc interessé de suite car moi j'utilise Doxygen et si je peux trouver mieux, je fais le saut.
Je me suis rendu sur leur site : les snapshots m'ont convaincu, donc je me suis empressé de downloader leur version pour windows (avec perl). J'ai dézipper le tout puis lancer : phpxref.exe
Apparemment il faut que les sources soient à la racine (ce qui me plait pas trop) donc je me suis dit que jbboschung savait quels arguments utiliser !
En résumé, quels sont les arguments permettant de spécifier notre répertoire source et notre répertoire de destination (par exemple), ou comment fais-tu pour générer ta doc ?
Merci d'avance
-
Oyé oyé, me revoilà !
Bon j'ai m'y un peu plus le nez dans phpXref et j'ai trouvé. En fait, à la racine du dossier contenant les fichiers phpXref, il y a un fichier nommé : phpxref.cfg qui contient toute la configuration.
Le fichier est assez bien commenté et permet de préciser le répertoire source, le répertoire de destination, le nom du projet... bref un tas de choses.
En espèrant que ca serve...
Tchao
-
Slt,
DSL assez pris ces temps, je viens de voir ta question à laquelle tu as parfaitement répondu.
J'ai perso mis une doc en ligne (Xoops 2.0.16) ici générée avec PHPXref que personnellement j'aime assez bien.
J'ai la même avec PHPDocumentor, histoire de comparer ici
J'ai par contre rencontré un gros problème (mais qui a été résolu) à la mise ne ligne de ces deux doc. Que ce soit PHPXref ou PHPDocumentor (je connais pas les autres prog de génération de doc), ils créent une nultitude de fichier avec des extensions multiples, ex.: myfile.php.html. Hors chez certain hébergeur, dont le mien, ces multiples extensions sont interdites et bloquées pour des raisons de sécurité.
La solution à donc été, car je n'avais pas le temps de modifier le code, de tout rennomer, tant les noms de fichiers que les liens dans chaque fichier, ex.: myfile.php.html -> myfile_php.html.
Voilà, gros boulot mais réalisable avec un bon soft permettant de rechercher et renommer autant dans les fichiers qu'au niveau du nom.
-
Salut,
Je viens d'aller voir tes deux documentations, et franchement celle générée avec PhpDocumentor est magnifique (comme celle de phpxRef aussi d'ailleurs) ! très bon gout ! (je veux bien le skin :oops: )
Autrement concernant ton problème, je n'y ai pas été confronté pour le moment mais je garde ta solution sous le coude au besoin.
Autre question : as-tu remarqué comme moi, que phpXref retourne bien les méthodes des objets parsés mais pas les attributs ?? existe-t-il une configuration pour résoudre ce problème ou est-ce moi qui utiise des mauvais tags pour les attributs ?
Merci d'avance