Netbeans et PhpDocumentor

Question

J'ai téléchargé Netbeans 7.0 beta car je voulais essayer la fonctionnalité PhpDoc, mais je n'arrive pas à la faire fonctionner. Il semble que je tombe sur les options de configuration de PhpDoc dans Netbeans. Il demande l'emplacement du script,

mais quoi que j'entre, je reçois l'erreur ;

** ERROR *****************************************************************
* Sorry, can't find the php.exe file.
* You must edit this file to point to your php.exe (CLI version!)
*    [Currently set to C:\usr\local\php\cli\php.exe]
* 
* NOTE: In PHP 4.2.x the PHP-CLI used to be named php-cli.exe. 
*       PHP 4.3.x renamed it php.exe but stores it in a subdir 
*       called /cli/php.exe
*       E.g. for PHP 4.2 C:\phpdev\php-4.2-Win32\php-cli.exe
*            for PHP 4.3 C:\phpdev\php-4.3-Win32\cli\php.exe
**************************************************************************
Press any key to continue . . . 

La configuration est Netbeans et xampp fonctionnant sur une machine Windows.

Toute aide est la bienvenue.

Answer 1

Cette erreur indique que le fichier exécutable php.exe n'est pas dans votre "PATH" Windows, et en tant que tel, lorsque Windows essaie d'exécuter le script phpdoc script, il ne sait pas comment faire. Heureusement, le phpdoc script lui-même vérifie cette condition et vous l'explique, dans le texte d'erreur que vous avez posté. Sinon, l'erreur Windows aurait été beaucoup plus générique et probablement inutile.

Vous devez déterminer où se trouve votre fichier php.exe. Ensuite, éditez le fichier phpdoc.bat script lui-même pour coder en dur le chemin absolu. Recherchez la ligne près du début qui définit la valeur de phpCli. C'est là que vous devez placer le chemin absolu de votre fichier php.exe.

En passant, je suggérerais que votre paramètre "PhpDoc script" dans NetBeans devrait appeler explicitement le phpdoc.bat script plutôt que juste "phpdoc", par ex. D:\xampp\php\phpdoc.bat puisque les deux fichiers existent réellement. Je sais que Windows cherchera généralement "foo.bat" si vous lui demandez d'exécuter "foo" alors que foo n'existe pas et que foo.bat existe, mais puisque phpdoc et phpdoc.bat existent tous les deux, ... Je pense que si Windows essaie d'exécuter directement phpdoc plutôt que phpdoc.bat, vous aurez des problèmes.

De plus, je vois que vous avez le fichier phpdoc.bat lui-même listé comme le premier "argument" du script phpdoc script. Cela va probablement vous causer quelques soucis une fois que vous aurez passé l'erreur "can't find php.exe". Vous devriez supprimer cela... les seuls arguments que vous devriez donner après avoir nommé le script lui-même sont les arguments valides que phpDocumentor attend, en particulier ceux qu'il... nécessite -- -o pour le modèle de sortie, -t pour l'emplacement des fichiers doc, -d ou -f pour lui indiquer où se trouve le code PHP que vous voulez documenter.

Answer 2

Pour mon cas, dans la version 2 : j'ai changé la dernière ligne dans phpdoc.bat :

"%PHPBIN%" "%PHP_PERAR_BIN_DIR%\phpdoc.php" %*

à

"%PHPBIN%" "phpdoc.php" %*

%PHP_PERAR_BIN_DIR% dans ce cas, est vide et la barre oblique inverse entraîne une erreur dans la recherche du fichier phpdoc.php.

Answer 3

J'ai enfin trouvé un moyen facile d'utiliser phpdoc dans Netbeans Windows !

Poire ? Laisse tomber. Il y a beaucoup trop de problèmes.

1. Téléchargez-le directement - http://sourceforge.net/projects/phpdocu/files/
2. Téléchargez le fichier tar, pas le zip. Le zip présente un problème et affiche des extensions de 2 lettres au lieu de 3 (par exemple, .cs au lieu de .css) (à partir de la version 1.4.3).
3. Dézippez-le où vous voulez
4. Ouvrez le fichier phpdoc.bat, et faites 2 changements
5. a) Changez le chemin de phpcli
6. b) Ajoutez du code pour naviguer dans le répertoire.

Donc par exemple, je mets mon dossier phpdocumentor dans d : \programs\xampp\php\phpdoc. Modifier le fichier phpdoc.bat :

    SET phpCli=d:\programs\xampp\php\php.exe
    d:
    cd d:\programs\xampp\php\phpdoc

Puis dans Netbeans, vous mettez ceci pour le phpdoc script :

    D:\programs\xampp\php\phpdoc\phpdoc.bat -o HTML:frames:earthli

Notez que lorsque vous définissez la cible (clic droit sur le projet -> propriétés -> phpdoc), vous devrez changer manuellement les barres obliques inverses en barres obliques avant.

• Correct - D:/programs/xampp/htdocs/project/phpdoc
• Incorrect - D:\programs\xampp\htdocs\project\phpdoc (ceci sera généré lorsque vous utiliserez le bouton "browse")

Bonne chance !

PS. Notez que vous pouvez également exécuter le fichier batch phpdoc directement depuis dos. Vous n'avez pas besoin de passer par Netbeans.

    d:\programs\xampp\php\phpdoc\phpdoc.bat -d D:\programs\xampp\htdocs\project -t D:\programs\xampp\htdocs\project\phpdoc -o HTML:frames:phpedit