通过 Phing 运行 phpdoc，phpdocumentor.ini 位置答案

【问题标题】：Running phpdoc through Phing, phpdocumentor.ini location通过 Phing 运行 phpdoc，phpdocumentor.ini 位置
【发布时间】：2013-10-07 10:59:17
【问题描述】：

我正在从头开始重建我的 xampp 和 CI 环境（在 win7 上），但在通过 phing 运行 phpdoc 时遇到问题。特别是，Phing 正在寻找一个不存在（也从未存在过）的地方的 phpdocumentor.ini。

Phing 和 PhpDocumentor 都已通过 Pear 安装，路径设置似乎很好，并且有以下版本：

php version 5.4.7
pear version 1.9.4
phpdoc version 2.0.1
phing version 2.6.1

系统上的相关路径为：

H:\xampp\php;
H:\xampp\php\pear;

在我的示例项目中：

我可以顺利运行 phpdoc，例如：phpdoc -d apps -t docs 运行良好。

这是我的 phpdoc 任务，过去运行良好：

<phpdoc title=Docs" destdir="${docsdir}" sourcecode="false" output="HTML:frames:earthli">
    <fileset dir="./apps">
        <include name="**/*.php" />
    </fileset>
    <projdocfileset dir=".">
        <include name="README" />
        <include name="INSTALL" />
        <include name="CHANGELOG" />
    </projdocfileset>
</phpdoc>

当我运行 Phing 时，phpdoc 失败并显示以下通知：

Parsing configuration file phpDocumentor.ini...
   (found in C:\php\pear\data/PhpDocumentor/)...
ERROR: cannot open phpDocumentor.ini in directory
-Is phpdoc in either the path or include_path in your php.ini file?

没有 c:\php... 目录，而且从来没有，所以我不知道这是从哪里来的。

如果我在 C: 上创建 Phing 预期的整个 PHPDocumentor 结构，我只能让它工作，但理想情况下，我希望更改 ini 文件的预期位置，以便我在一个驱动器上拥有所有东西。

有什么方法可以告知 Phing 我的 phpdocumentor.ini 的真实位置？

我没有发现 SO 上列出的这个特定问题，但我希望其他人已经看到并纠正了这个问题。 Phing 站点 docs/forum/trac 没有列出任何有关此问题的最新报告。

谢谢大家

【问题讨论】：

标签： xampp phpdoc phing

【解决方案1】：

看起来您正在尝试使用 phpDocumentor 2.x 并从 phpDocumentor 1.x 中看到一些行为。或许 XAMPP 源代码附带的一些 1.x 代码会持续存在并影响您干净地运行 2.x 的能力。

从 Phing 角度考虑，查看 Phing 手册，用于 phpDocumentor 2.x 的正确 Phing 任务似乎是 DocBlox 任务 [1] 而不是旧的 PhpDoc 任务。

[1] -- http://www.phing.info/docs/guide/stable/apcs52.html.

【讨论】：

为此干杯——我决定将 XAMPP 和我的 CI 进程分开处理，并且已经完成了一些 php/pear/phing/phpdocumentor 安装来尝试让这一切顺利进行——但遇到了一些错误或另一个当我开始运行我的构建时，所以我希望你建议的 DocBlox 任务能解决问题。在没有创建默认的 c:\php\pear 文件夹的情况下，它尝试了几次运行所有安装，但我小心翼翼地设法将所有东西都保存在一个驱动器上。最新安装完成后，我将更新我的 build.xml 并查看它的运行情况。
由于 GraphViz 的依赖而有所延迟，我很高兴告诉 Ashnazg，您的 DocBlox 建议奏效了 - 干杯。

【解决方案2】：

下载 XAMPP for Windows 的最新 zip 存档版本我看到该文件：

\xampp\php\pear\PhpDocumentor\phpDocumentor\Setup.inc.php

函数 parseIni() 直接引用上述路径：

enter code herephpDocumentor_out(" (在 " . 'C:\php\pear\data/PhpDocumentor' . PATH_DELIMITER . ")...\n");

因此，与我一直在升级或强制重新安装的任何组件相比，它更有可能是 XAMPP 问题。

【讨论】：