首页 > window下安装pear,phpDocument

window下安装pear,phpDocument

2012-12-20   hisenKing

windows下php环境没有go-pear.bat安装包,又使用的是php5.3.10,网上很多安装教程不适用,尝试的时候提示 “Sorry!  Your PHP version is too new (5.3.10) for this go-pear.”。那直接上pear官网http://pear.php.net/上查看查看如何安装pear。

1.根据官网的介绍首先下载 http://pear.php.net/go-pear.phar文件。这边我将它放在php的根目录。

2.使用命令

php go-pear.phar
安装 这边会让你选择安装的方式Are you installing a system-wide PEAR or a local copy? (system|local) [system] :  local 当然你也可以选在system

上图选择all后,敲回车就可以了。

到此pear就安装成功了。输入命令行参看

3.将pear添加到include目录中includepath = ".;D:\wamp\bin\php\php5.3.10\pear"。并测试是否已经包含,新建一个文件checkpear.php

<?php
require_once 'System.php';
var_dump(class_exists('System', false));
因为System.php is shipped with every PEAR installation and thus should be on your computer(system.php文件是被每一个pear安装包装载的,因此会在你的电脑上),所以当输出boolean true表明目录已经安装成功,否则表示失败。 安装phpDocument 写 文档是一项乏味却不得不做的工作,而编写API级的文档更是意味着大量的重复劳动和难以保持的一致性。phpDocumentor就是支持 PHP5 语法分析的文档工具。 使用phpDocumentor不仅可以自动从代码中提取出函数和方法定义,还可以自动处理各个class 之间的关系,并据此生成class tree 。你还可以选择将文档生成html、chm或者pdf。有了phpDocumentor,文档工作变得轻松了很多。 安装phpDocument也很简单,上面的pear安装后,会在pear的安装目录生成一个pear.bat文件。利用这个pear.bat就可以安装phpDocument了。方式如下: 在cmd窗口中cd到php的根目录,输入
pear.bat install -o PhpDocumentor
-o 的参数,意思是要 pear 把相依的套件也一起下载安装。 这里我运行下载的是phpDocument1.4.4版本。下载安装之后,会在根目录下生成一个phpdoc.php文件,pear文件夹下会多一个phpDocument文件夹。 在phpdoc.bat 所在目录下,输入
phpdoc –h
会输出一个详细的参数表,其中几个重要的参数如下: -f 要进行分析的文件名,多个文件用逗号隔开 -d 要分析的目录,多个目录用逗号分割 -t 生成的文档的存放路径 -o 输出的文档格式,结构为输出格式:转换器名:模板目录。例如:HTML:frames:phpedit -pp 输出文档包含私有方法与属性 下面是具体的一个使用例子:
<?php
/**
* @filename baseDoc.php
* @touch date Thu, 20 Dec 2012 13:10:41 GMT
* @package phpDocumentor demo
* @author HisenKing
* @version 1.0.0
* @copyright (c) 2012, HisenKing
*/

/**
* 取类的名称
* <code>
* $className = getClassName(book,language)
* </code>
* @deprecated
* @param string $name  前缀
* @param string|int  $type  类型
* @return string
*/
function getClassName($name,$type){
$className = $name . $type;
return $className
}
>
phpdoc -o HTML:frames:earthli -f D:\wamp\www\docTest\test.php
-t D:\wamp\www\docs

错误的信息会存放在D:\wamp\www\docs/errors.html文件中,进入D:\wamp\www\docs 用浏览器打开index.html 就可以看见生成的文档了

phpDocumentor相关的tags的说明见官方网站的说明 tags说明手册

好久没更新了,需要除除草