Discussion :

[RowanMayfair]

Bonjour,

Je suis un peu désespérée. Je cherche à utiliser phpDocumentor avec NetBeans, mais je n'y arrive pas.
J'en suis à plusieurs heures de recherche sur le net, sans succès, soit je tombe sur des vieux vieux trucs, ou d'autres environnements, bref.

Ce que j'ai fait :
- J'ai installé le dossier phpDocumentor-2.9.1 dans un répertoire user
- dans NetBeans, dans Tools -> Options -> PHP -> onglet Frameworks et Tools -> sélection phpDocumentor : sur la ligne 'phpDocumentor script', j'ai mis le chemin vers le fichier phpdoc.bat qui se trouve dans mon répertoire user
- j'ai créé un dossier "doc" dans mon projet (dans mon www)
- clilc droit sur le projet, puis properties, puis Documentation, j'ai sélectionné phpDocumentor et j'ai mis le lien vers mon répertoire "doc" créé à cet effet

Mais quand je clique sur "Generate Documentation" j'ai le message d'erreur suivant : Could not open input file: \phpdoc

Je n'ai absolument aucune idée de ce que j'ai pu mal faire, ou pas faire...

Quelqu'un aurait une idée svp ?

D'avance merci

[kevin254kl]

Salut,

J'utilise vscode ou phpstorm mais bon. Pourquoi pas passer par le terminal ? https://docs.phpdoc.org/latest/getti...mentation.html

[RowanMayfair]

Alors ... je ne suis pas fermée. Et j'ai obtenu une license étudiante pour les IDE JetBrains, donc je pourrai utiliser phpStorm. J'avais essayé d'ailleurs, mais je ne m'en suis pas sortie pour la configuration. Leur doc, on cherche un truc, et on nous dit qu'il faut faire ça avant, et quand on clique pour aller voir on nous redit qu'il y a encore autre chose à faire ...bref, c'est infini. Je n'ai pas eu la patience, donc je suis repassée sur NetBeans. D'autant que je suis aussi censée installer un sniffer et phpUnit.

Je ne suis pas fermée non plus sur phpDocumentor. Je cherche simplement un moyen de générer automatiquement de la doc.

J'ai déjà perdu beaucoup de temps là-dessus, et je ne m'en sors pas, donc ça me gave, et en + je me sens très c*nne, ce qui n'est jamais très agréable.

[kevin254kl]

C'est dans la difficulté que l'ont progresse!
Sur packagiste https://packagist.org/packages/phpdo.../phpdocumentor un

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

composer require --dev phpdocumentor/phpdocumentor

puis

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

phpdoc run -d <SOURCE_DIRECTORY> -t <TARGET_DIRECTORY>

Tu peux dans ton composer.json ajouter la commande (même démarche pour cssniffer et phpunit).

[RowanMayfair]

Je ne comprends pas. Je ne comprends pas la doc.

le

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

composer require --dev phpdocumentor/phpdocumentor

je tape ça où ? Dans quoi ? je suis vraiment totalement larguée

[kevin254kl]

Tu as un dossier ou est ton projet, par exemple my_project. Il faut à partir d'un terminal par exemple la console windows ou de netbeans que tu te place dans ce dossier.
Il faut aussi que tu es initialiser composer (composer permet de gérer tes librairies, si tu n'a pas de composer.json fait un composer init). Compsoer va installer tes librairie(phpdoc, phpcs) dans le dossier vendor ex: my_project/vendor .
Tu as juste après à executer la commande phpdoc dans my_project.
Compodrt pour windows au cas ou https://getcomposer.org/download/

[RowanMayfair]

Je ne m'en suis pas sortie ...

Finalement un camarade de promo m'a donné un coup de main.

Il m'a fait installer chocolatey, en ligne de commande.
C'est mignon, ça m'a récupéré (et maj) quelques paquets, et il m'a installé graphiz (que je n'avais pas ... pour ça que ça ne fonctionnait pas).
Et puis je suis allée télécharger phpDocumentor.phar

A partir de là, je suis retournée dans netBeans, dans Tools>Options>php>frameworks et tools>phpDocumentor j'ai mis le chemin de mon .phar

Et là ... magie de l'informatique, ça fonctionne.

Déjà j'avais pas compris qu'il fallait le .phar, et encore moins qu'il me manquait graphiz, en bref j'étais mal barrée.


Merci pour votre participation