php的pear编程: phpDocumentor的使用?

pfc: php基础类库;
pecl: php扩展公共库
pear: php extension and application repository. php的扩展和应用库
phar: ['fa:], 是已经编译好了的php二进制文件

gzip是gnu zip, 是linux下的zip压缩, 比winzip更保守。 压缩率和速度要慢点?? 但是在linux世界更通用。
tar + gzip = *.tgz

pear的用法, 就如同yum的是一样的。 包括安装, 下载等 应用包。 也是package包的概念。。。

如: pear install pack_name ; pear download pack_name; pear download-all; pear list ; pear upgrades; pear uninstall pack_name...

  • pear install pack_name, 这个是从远程pear仓库 在线安装package。

  • pear install pack_name.tgz: 这个是安装已经下载下来的包, 你看这个包已经是tgz了嘛。

pear安装时会默认安装几个包, 如Mail package, 使用 “pear list可以查看已经安装了的包”

可以再php.ini中修改pear的包含目录: include_path=".; /path/to/your/pear/install/dir"

使用 “require_once('pear_package_name'); " 可以测试pear是否安装成功。

// 如果没有go-pear.bat文件, 可以使用下面的方法: http://pear.php.net/go-pear
去http://pear.php.net/go-pear 把内容存成php文件,放到你本地网站里,然后用浏览器访问这个php文件。或者用php命令行访问。

Pear的很多代码已经成php行业的工业标准。比如你要测试代码的执行速度,你当然可以自己写代码来测试,然后公布你的测试结果和测试方法。但更好的做法是引入Pear的BenchMark,这样的测试结果会更严肃更权威


pecl, composer和pear的区别?
都是php用来 管理 包、类依赖的工具。 但是pear主要使用于全局的wide domain, 而composer更多的是使用于单个程序或项目.
如果在我们的代码中, 使用 require 'vendor/Foo.class.php', 你需要解决类的自动加载的问题..., 包括你在tp中,也要解决自动加载的类库问题, 使用import等方法

但是, 如果使用了 pear或 composer, 他会自动加载所需要的类库.

pear更多的是倾向于, yum的方式, 它的在线仓库应该是: http://pear.php.net/... 包括它的命令方式和操作方式;
而composer, 则是通过使用 composer.json 来配置所需要的依赖类. 相比pear都是一样, 一个pear是用命令, 而composer是用配置json文件, 的方式, 都是自动完成安装的. 差别不大

可以把pear命令, 看作是:php composer.phar 这个组合命令, 两种是相等的.

pear上的包, 如果没有维护了, 如: unmaintained, 表示已经没有维护了, 但只要没有说deprecated, 那么就说明这个包(类库) 已经是一个稳定的包了.不需要维护了...


php 本身也是一个命令程序, 可以在命令行中, 带[options]选项进行执行, 如 mysql一样...
php 可以有多个配置文件, 而且多个配置文件之间是相互补充的,

在wamp的bin的PEAR文件夹中, 有 go-pear.phar, 它是一个php文件!
注意 phar: 是一个php的打包文件, 是将多个php文件打包成一个文件, 就是phar, 如同java中的 jar包一样. 而php5.3以上是支持phar了的, 在php.ini中有一个 [Phar]节.


wamp2.5中的bin/php/php5.3.5/PEAR/中是包含了, 自带了一个go-pear.phar的。
go-pear实际上是一个 installer 即pear的安装器。 这个go-pear.phar既可以用webbased来安装, 也可以使用命令行php -d/-q ? PEAR/go-pear.phar来安装

安装时提示: not have a signaturePHP? ...failed to open phar stream..?

解决方法是: 将php.ini中的 【phar】section 节中的 ; phar.require_hash= On明确地改为Off就可以了。
也可以使用php的 -d 选项, -d是临时改变配置项:

也可以将http://pear.php.net/go-pear内容复制 保存在www目录下,文件名可以是任意的, 只要是php类型就可以, 如: mypear.php, 然后在localhost/mypear.php下运行就可以用web方式来安置了。

workaround: [w2:k2raund], n. 变通方案, 变通方法。。。


wamp中的pear的版本比较低, 是0.9, 新下载的版本更高, 是1.1....


require 和 require_once的区别?
一般情况下, 两者是没有区别的, require_once主要是用在 , 在一个文件中, 要包含多个文件的时候, 才可能有区别. require会原样包含多个文件, 即使多个文件中重复包含时(迭代包含), 也不会去检测, 就有可能造成 变量和函数的重复定义 而出现 fatal error. 比如当: a include b, 然后当c include b, c include a的时候, 就有可能出现b中定义的变量重复定义了.

但是当require_once时, 会检测包含多个文件之间是否有重复包含的, 如果有包含链 , 就会检查不会去重复包含, 以免产生变量重复定义的问题...

而当只包含 一个文件, 或者 多个被包含的文件之间 没有迭代包含的时候, require和require_once其实是没有区别的.


require和include的区别?
主要是:

  1. 错误机制不同: require是致命错误, 会中断执行, 而include不会中断,只是会产生一个警告
  2. 两者的效率不同: require只会在代码程序执行前包含一次, 解释执行一次; 而include会反复执行多次, 因此, 最大的区别是: 在条件语句, 控制语句中, 通常使用include语句, 而在控制语句中使用require是没有意义的.

phpDocumentor 老版本叫 phpDoc,从1.3.0开始改名的, 只是用来提取/生成 注释文档的工具, 但是 注释还得自己写, 而且需要有一定的格式要求, 参考这篇文章: https://yq.aliyun.com/articles/33058

通常, 在linux中的分隔符是: , 而windows的分隔符是分号;
通常,缩写是采用的大写,如: XML_Parser, XML_Beautifier
XML_Parser is 'deprecated in favor of 'XML_Parser2'.

take over: 接替, 接管: have a rest, i'll take over.

/**
 * some comments // 前面有一个空格
 * @param ..
 * @access
 * @return...

 * some other comments
 */

分为类/函数前面(即外部)的注释部分, 和 类/函数内部的注释部分.




安装phpdoc时,需要Structures/Graph.php, 下载下来的是tgz压缩文件, 不要害怕, tgz压缩文件可以被: rar解压缩!


可以通过禁用/启用有线/无线网络的方式来切换, 当有线和无线都可以使用时, 想优先使用"有线"网络, 即如何设置网络连接的优先级?

在"更改网络连接-> 有线和无线网络连接 列表"的界面, 资源管理器窗口实际上是一个"程序", 它的菜单是"根据当前窗口中的内容来决定, 和动态改变的, 一定要有 把资源管理器当作一个程序窗口来看待的思想", 选择 "高级 -> 高级设置" 调整有线和无线网络连接 在列表中 的先后顺序 即可.


使用phpdoc的必须的参数, 有两个, 一个是-f(或-d), 一个是-t(--target)...

phpdoc -f, -t
-f: 是要解析的文件,
-t: 是要生成的doc内容(包括很多, 并不只是一个文件, 包括多个文件和目录等等)所要存放的路径/目录/文件夹
而-o是 --output是用来指定输出格式和输出方式的...



只是发现, 使用phpDocumentor后,其实并没有多少用处! 就只是把文档注释提取出来, 但是即使生成了docs也没有多少用处, 只是说, 熟悉了 php pear, pear-phpDocumentor的用法.

原文地址:https://www.cnblogs.com/bkylee/p/6640005.html