Netbeans y PhpDocumentor

Question

He descargado Netbeans 7.0 beta porque quería darle un toque de gracia a la funcionalidad PhpDoc, pero no puedo hacer que funcione. Parece que me estoy cayendo en las opciones de configuración para PhpDoc en netbeans. Está pidiendo la ubicación de la secuencia de comandos,

pero cualquiera que ingrese me aparece el error;

** 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 configuración es Netbeans y xampp ejecutándose en una máquina con Windows.

Cualquier y toda ayuda muy apreciada.

Answer 1

Ese error indica que el archivo ejecutable php.exe no está en su "PATH" de Windows, y como tal, cuando Windows intenta ejecutar el script phpdoc, no sabe cómo. Afortunadamente, el script phpdoc comprueba esta condición y se lo explica en el mensaje de error que publicó. De lo contrario, el error de Windows habría sido mucho más genérico y probablemente inútil.

Debe determinar dónde se encuentra su archivo php.exe. Luego, edite el archivo de script phpdoc.bat para codificar la ruta absoluta. Busque la línea cerca del comienzo que establece el valor de phpCli. Ahí es donde debe colocar la ruta absoluta a su archivo php.exe.

Como comentario adicional, sugeriría que su configuración "PhpDoc script" en NetBeans debería llamar explícitamente al script phpdoc.bat en lugar de simplemente a "phpdoc", p. D: \ xampp \ php \ phpdoc.bat, ya que ambos archivos existen en realidad. Sé que Windows típicamente buscará "foo.bat" si le dices que ejecute "foo" cuando foo no existe y foo.bat existe, pero dado que phpdoc y phpdoc.bat existen, ... creo que Windows tratando de ejecutar phpdoc directamente en lugar de phpdoc.bat le dará problemas.

Además, veo que tiene el archivo phpdoc.bat en sí mismo como el primer "argumento" para el script phpdoc. Eso probablemente le cause algo de dolor una vez que pase el error "can not find php.exe". Debe eliminar eso ... los únicos argumentos que debe dar después de nombrar el script en sí son los argumentos válidos que phpDocumentor espera, particularmente los que requiere - -o para la plantilla de salida, -t para dónde escribir los archivos doc , -d o -f para decirle dónde está documentado el código PHP.

Answer 2

¡Finalmente descubrí una manera fácil de usar phpdoc en Netbeans Windows!

Pera? Déjalo caer. Hay demasiados problemas.

1. descargar directamente - http://sourceforge.net/projects/phpdocu/files/
2. Descargar el archivo tar, no la cremallera. La postal se molestó y extensiones voluntad la salida 2 de la letra en vez de 3 (es decir, en lugar de Cs .css) (a partir de 1.4.3)
3. descomprimirlo cualquier lugar que desee
4. abrir el archivo phpdoc.bat, y hacer 2 cambios
5. a) cambiar la ruta phpcli
6. b) Poner en el código para navegar hasta el directorio.

Así, por ejemplo, puse mi carpeta phpDocumentor en d: \ programas \ xampp \ php \ phpdoc. Modificando el phpdoc.bat:

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

Luego, en Netbeans, que puso esto para el guión phpdoc

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

Tenga en cuenta que cuando se establece el objetivo (clic derecho en el proyecto -> propiedades -> phpdoc), se necesitará cambiar manualmente las barras diagonales inversas para avanzar barras diagonales.

• correcta - D:/programas/XAMPP/htdocs/proyectos/PHPDoc
• incorrecta - D: \ programas \ xampp \ htdocs \ proyecto \ phpdoc (esto se generará cuando se utiliza el botón Examinar)

¡Buena suerte!

PS. Tenga en cuenta que también puede ejecutar el archivo por lotes phpdoc directamente desde dos. No necesitas hacerlo a través de 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 

Answer 3

para mi caso, en la versión 2: cambié la última línea de phpdoc.bat:

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

a

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

%PHP_PERAR_BIN_DIR% en este caso es el vacío & la barra invertida comete un error al encontrar el archivo phpdoc.php