附录 Q. 关于本手册

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

手册的格式

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

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

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

和绝大多数离线格式的手册相比,在线阅读版本有一个很大的优点,即它集成了用户注释;同时,它的明显的缺点是您必须保持一直在线来阅读。

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

跨平台性最好的格式是 HTML 格式和纯文本格式。HTML 格式提供了两种方式:一种只有一个很大的 HTML 文件;另一种方式是每一节分成一个独立文件,它们形成一个包含有几千个文件的文件包。HTML 和纯文本格式的《PHP 参考手册》都是以 bzip2 方式压缩的 tar 文件提供。文件的后缀名为 tar.bz2。

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

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

对于手掌机及其兼容设备的用户来说,该平台最理想的格式是 Palm 文档或者 iSilo 格式。您可以在日常工作中带着您的手掌机,利用 DOCiSilo 阅读器来温习 PHP 知识,当然,也可以作为快速的参考。

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