0

我正在从头开始重建我的 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 没有列出任何有关此问题的最新报告。

谢谢大家

4

2 回答 2

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。

于 2013-10-07T16:39:15.630 回答
0

下载适用于 Windows 的 XAMPP 的最新 zip 存档版本，我看到该文件：

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

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

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

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

于 2013-10-07T13:55:07.457 回答