附录 Q. 关于本手册

目录
手册的格式
关于用户注释
如何阅读函数的定义(函数原型)
本手册中所涉及的 PHP 版本
如何得到关于 PHP 更多的信息
如何帮助改进本文档
如何生成手册的各种格式
手册译文

手册的格式

《PHP 参考手册》提供了多种不同格式的版本,它们可以分为两组:在线阅读版本和可下载包。

注: 有些出版商可能已经出版了本手册的一些印刷版本,但不推荐使用它们,因为 PHP 参考手册更新得非常快,这些印刷版本的内容很快将过时。

可以访问 PHP.net 网站及其众多的镜像站点来在线阅读《PHP 参考手册》。为了保证最佳的访问速度,应该选择地理位置最接近的镜像站点。PHP 手册的 HTML 版本既有纯 HTML 版(便于打印的),也有看上去和感觉上和 PHP 站点上的手册一样的版本。

和绝大多数离线格式的手册相比,在线阅读版本有两个显著的优点,即它集成了用户注释,并且可以使用其中的 URL 快捷方式快速进入手册中想阅读的部分;但是,它的明显的缺点是必须保持一直在线来阅读。

目前,《PHP 参考手册》提供多种离线阅读格式,最适合于自己的格式取决于所使用的操作系统和个人的阅读习惯。关于《PHP 参考手册》如何被制作成如此多的版本,请查阅本附录中“如何生成手册的各种格式”一节。

跨平台性最好的格式是 HTML 格式格式。HTML 格式提供了两种方式:一种只有一个很大的 HTML 文件;另一种方式是每一节分成一个独立文件,它们形成一个包含有几千个文件的文件包。我们提供的是这两种版本的压缩包,需要使用解压缩工具解压出压缩包中的文件。

对于 Windows 平台,我们利用了 Windows 的超文本帮助应用程序结合本手册的 HTML 格式,形成了本手册的 Windows 超文本帮助版本。该版本提供手册的全文搜索、完整的索引以及书签功能。很多 Windows 平台下流行的 PHP 集成开发环境也集成了该版本的手册,以给开发者提供最方便快捷的参考。CHM 阅读器也有 Linux 版本,可以到 xCHMGnoCHM 网站了解更多信息。

同时,PHP 手册也有扩展 CHM 版本提供下载。它更新的速度比较慢,但是提供了附加的功能。由于制作帮助页面时采用的技术的特殊性,它只可在 Microsoft Windows 下工作。