Php/docs/about.formats
手册的格式
《PHP 参考手册》提供了多种不同格式的版本,它们可以分为两组:在线阅读版本和可下载打包版本。
Note:
有些出版商可能已经出版了本手册的一些印刷版本。不推荐印刷版,因为 PHP 参考手册更新得非常快,这些印刷版本的内容很快将过时。
可以访问 » PHP.net 网站及其众多的镜像站点来在线阅读《PHP 参考手册》。为了保证最佳的访问速度,应该选择地理位置最接近的镜像站点。PHP 手册的在线版本目前有两种 CSS 样式表:便于浏览和便于打印。
和绝大多数离线格式的手册相比,在线阅读版本有两个显著的优点,即它集成了用户注释,并且可以使用其中的 [https://www.php.net/urlhowto.php » URL 快捷方式]快速进入手册中想阅读的部分;但是,它的明显的缺点是必须要联网才能阅读。
目前,《PHP 参考手册》提供多种离线阅读格式,最适合于自己的格式取决于所使用的操作系统和个人的阅读习惯。关于《PHP 参考手册》如何被制作成如此多的版本,请查阅本附录中如何生成手册的各种格式一节。
跨平台性最好的格式是 HTML 格式格式。HTML 格式提供了两种方式:一种只有一个很大的 HTML 文件;另一种方式是每一节分成一个独立文件(它们形成一个包含有几千个文件的文件包)。我们提供的是这两种版本的压缩包,需要使用解压缩工具解压出压缩包中的文件。
对于 Windows 平台,我们利用了 Windows HTML 帮助应用程序结合本手册的 HTML 格式,形成了本手册的 Windows HTML 帮助版本。该版本提供手册的全文搜索、完整的索引以及书签功能。很多 Windows 平台下流行的 PHP 集成开发环境也集成了该版本的手册,以给开发者提供最方便快捷的参考。CHM 阅读器也有 Linux 版本,可以到 » xCHM 或 » GnoCHM 网站了解更多信息。
同时,PHP 手册也有[https://www.php.net/docs-echm.php » 扩展 CHM 版本]提供下载。它更新的速度比较慢,但是提供了附加的功能。由于制作帮助页面时采用的技术的特殊性,它只可在 Microsoft Windows 下工作。