附录 Q. 关于本手册

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

手册的格式

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

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

您可以访问 PHP.net 网站 及其众多的镜像站点来在线阅读《PHP 参考手册》。为了保证最佳的访问速度,您应该选择离您的地理位置最接近的镜像站点。您可以选择阅读可直接打印的 HTML 版本,也可以阅读集成在 PHP 官方站点中的 HTML 版本,该版本让您感觉《PHP 参考手册》就是该网站的一部分。

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

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

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

另一种流行的跨平台格式,也是最适合打印的格式,是 PDF(也就是 Adobe Acrobat)格式。不过,当您急匆匆地下载该版本,并点击“打印”按钮的时候,我们需要提醒您本手册超过 2000 页,并且还在不断地被修订。

注: 如果您还没有可以直接阅读 PDF 格式文档的软件,您可能需要下载 Adobe Acrobat Reader

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

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