编辑“PhpDocumentor”（章节）

==phpDocumentor安装==
官方提供了两种phpDocumentor的安装方法。第一种方法是从pear.php.net和sourceforge.net[[下载]]和解压缩任一可用的档案，另一种方法是通过[[PEAR]]安装工具安装。已有一个名为“Phing任务”的计划，准备通过其它新的有前途的安装框架来分发，例如ZZ/OS安装工具。然而，phpDocumentor的开发者只为上述两种官方的安装方法提供支持。

*'''从Pear.Php.net或Sourceforge.net下载'''   
在从pear.php.net或sourdeforge.net下载.zip或tar包来安装phpDocumentor之前，请先确认你要使用 phpDocumentor的Web界面还是命令行界面(参考“phpDocumentor工具的基本用法”一节来帮助你做这个决定)。

如果想要使用命令行界面，把文档解压到任意一个目录，比如/home/myuser/phpdoc或C:\Program Files\phpdoc，然后把目录添加到你的path语句。运行“phpdoc”命令来使用它。在[[Windows]]中，你需要编辑phpdoc.bat 文件，把第一行改为PHP的CLI版本的路径(默认情况下通常是C:\php4\cli\php.exe)。

如果想要使用Web界面，你必须安装Web[[服务器]]，例如[[Apache]]，这个Web服务器必须有能工作的PHP sapi。为了测试这一点，把下面的代码([code]和[/code]之间的内容)保存为phpinfo.php，把这个文件放到Web服务器的根目录下，浏览<nowiki>http://localhost/phpinfo.php。</nowiki>
<pre>
phpinfo.php:
[code]
       <?php
       phpinfo();
       ?>
[/code]
</pre>
如果你看到漂亮的PHP信息显示出来，那么你的PHP安装就是能工作的。要使用phpDocumentor的Web界面，只要简单地把档案解压缩到Web 服务器根目录的一个子目录(例如phpdoc)，然后浏览那个位置(<nowiki>http://localhost/phpdoc)。</nowiki>

要观看更新的Web界面，需要一个支持[[Javascript]]的[[浏览器]]，例如[[Netscape]]、[[Mozilla]]、[[Internet Explorer]]、[[Opera]]或[[Konqueror]]。如果你想要使用不支持Javascript的浏览器，例如links/lynx，请使用旧的Web界面，phpdoc.php，它位于<nowiki>http://localhost/phpdoc/phpdoc.php</nowiki>。

*'''从PEAR安装'''
要从PEAR安装phpDocumentor，你首先必须有一个能够工作的安装好的PEAR。关于正确安装PEAR的操作指南位于PEAR的官方网站(<nowiki>http://pear.php.net</nowiki>)。phpDocumentor的开发者不对PEAR的安装问题提供支持，作为替代的，请从PEAR的开发者那里寻求帮助。
   
安装命令行的phpDocumentor非常简单，运行：
<pre>
$ pear install PhpDocumentor
</pre>
然后你就可以完全访问phpdoc命令了，不管是在Windows下还是[[Linux]]下，不需要进一步配置。
   
安装使用Web界面的phpDocumentor，首先你必须修改PEAR的配置变量data_dir，把它指向你的Web服务器根目录的一个子目录。完成这项工作的最简单的办法是通过PEAR的命令行界面运行：
<pre>
 $ pear config-set data_dir /path/to/document_root/pear
</pre>
从Web界面来配置这个值也很简单。单击左边帧里的配置图标，在data_dir文本框中键入地址。(这个Web界面的入口在哪里我也没有搞清楚，不过从命令行配置确实是一个好办法)

一旦配置完成，使用上面第二段中的命令就可以简单地安装phpDocumentor，然后你可以浏览<nowiki>http://localhost/pear/PhpDocumentor</nowiki>来访问Web界面。一旦这步配置完成，就无须再做改变，通过使用pear的upgrade命令你可以毫不费力地升级到未来的 phpDocumentor版本。
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*