Netbeans 和 PhpDocumentor

Question

我已经下载了 Netbeans 7.0 beta，因为我想给 PhpDoc 功能一个 bash，但不能让它工作。 我似乎对 netbeans 中 PhpDoc 的配置选项感到失望。它要求脚本位置，

但无论我输入什么，我都会得到错误；

** 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 . . . 

设置是在 Windows 机器上运行的 Netbeans 和 xampp。

非常感谢任何和所有帮助。

Answer 1

该错误表明 php.exe 可执行文件不在您的 Windows“PATH”中，因此，当 Windows 尝试运行 phpdoc 脚本时，它不知道如何运行。幸运的是，phpdoc 脚本本身会检查这种情况并在您发布的错误文本中向您解释。否则，Windows 错误会更加笼统，而且可能无济于事。

您需要确定 php.exe 文件的位置。然后，编辑 phpdoc.bat 脚本文件本身以硬编码绝对路径。查找设置 phpCli 值的开头附近的行。那是您应该放置 php.exe 文件的绝对路径的位置。

顺便说一句，我建议您在 NetBeans 中的“PhpDoc 脚本”设置应显式调用 phpdoc.bat 脚本，而不仅仅是“phpdoc”，例如D:\xampp\php\phpdoc.bat，因为这两个文件实际上都存在。我知道如果你告诉它在 foo 不存在并且 foo.bat 确实存在时执行“foo”，Windows 通常会寻找“foo.bat”，但是由于 phpdoc 和 phpdoc.bat 都存在，......我认为Windows 试图直接运行 phpdoc 而不是 phpdoc.bat 会给你带来麻烦。

此外，我看到您将 phpdoc.bat 文件本身列为 phpdoc 脚本的第一个“参数”。一旦您克服了“找不到 php.exe”错误，这可能会让您有些悲伤。你应该删除它......在命名脚本本身之后你应该给出的唯一参数是 phpDocumentor 期望的有效参数，特别是它 需要 的那些 - -o 用于输出模板，-t 用于哪里编写 doc 文件，-d 或 -f 告诉它您想要记录的 PHP 代码在哪里。

Answer 2

就我而言，在版本 2 中： 我更改了 phpdoc.bat 中的最后一行：

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

到

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

%PHP_PERAR_BIN_DIR% 在这种情况下为空，反斜杠在查找 phpdoc.php 文件时出错

Answer 3

我终于想出了一个在 Netbeans Windows 中使用 phpdoc 的简单方法！

梨？算了吧。问题太多了。

1. 直接下载-http://sourceforge.net/projects/phpdocu/files/
2. 下载 tar 文件，而不是 zip。 zip 存在错误，将输出 2 个字母扩展名而不是 3 个（即 .cs 而不是 .css）（从 1.4.3 开始）
3. 解压到任意位置
4. 打开 phpdoc.bat 文件，进行 2 处更改
5. a) 更改 phpcli 路径
6. b) 添加代码以导航到目录。

例如，我将 phpdocumentor 文件夹放在 d:\programs\xampp\php\phpdoc 中。修改phpdoc.bat文件：

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

然后在 Netbeans 中，您将其放入 phpdoc 脚本中：

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

请注意，当您设置目标时（右键单击项目 -> 属性 -> phpdoc），您需要手动将反斜杠更改为正斜杠。

• 正确 - D:/programs/xampp/htdocs/project/phpdoc
• 不正确 - D:\programs\xampp\htdocs\project\phpdoc（这将在您使用浏览按钮时生成）

祝你好运！

PS。请注意，您也可以直接从 dos 运行 phpdoc 批处理文件。你不需要通过 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