手册的格式

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

Note:

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

可以访问 » PHP.net 网站及其众多的镜像站点来在线阅读《PHP 参考手册》。为了保证最佳的访问速度,应该选择地理位置最接近的镜像站点。PHP 手册的在线版本目前有两种 CSS 样式表:便于浏览和便于打印。

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

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

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

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

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