By Altair (
eniac2008@php.net,
http://www.phpinternals.com)
非常感谢您打算参与PHP中文手册的翻译工作。在打算参与之前，您需要准备一些工具，主要包括：
（1） PHP命令行工具
（2） CVS客户端
（3） PHD
（4） XML编辑软件
当然你最好要有快一点的Internet连接。
由于使用Windows平台的朋友比较多，为了降低翻译工作的门槛，避免在翻译环境的准备过程中浪费不必要的时间，我在这里介绍一种在Windows平台下的最简单的翻译环境的配置方法，按照这种方式配置后，您马上就可以开始PHP手册的中文翻译工作。
下面我们就开始：
第一步：下载安装PHP 5.3.0命令行版本
现在PHP5.3还没有正式发布，不过没有关系，对于我们翻译工作没有影响，因为最新的PHD需要使用PHP5.3。
(1) 下载最新的PHP 5.3.0alpha3版本。下载网址：
http://windows.php.net/qa/，不要下载直接安装版本，下载 Windows x86 VC6(thread safe)版本：
http://windows.php.net/downloads ... 3-Win32-VC6-x86.zip
(2) 将上面下载的文件解压到硬盘，本文假定你解压至 d:\phpdoc\php53 文件夹下。解压后的php.exe应该位于 d:\phpdoc\php53\php.exe
(3) 修改php.ini文件。将d:\phpdoc\php53\php.ini-dist文件复制为php.ini，然后用文本编辑器打开php.ini, 找到下面的内容:
; Defines the default timezone used by the date functions
;date.timezone =
将date.timezone前面的分号去掉，整行的内容改为：
date.timezone = Asia/Shanghai
如果你不在国内，请改为你所在地的时区。PHP支持的所有的时区列表可以在这里找到：
http://www.php.net/manual/en/timezones.php
(4) 将d:\phpdoc\php53加入到系统环境变量PATH中，最好加到PATH的最前面。加入成功后你在DOS提示符的任意目录下键入命令: php –v，如果看到类似下面的提示：
PHP 5.3.0alpha3 (cli) (built: Dec 4 2008 20:40:51)
Copyright (c) 1997-2008 The PHP Group
Zend Engine v2.3.0, Copyright (c) 1998-2008 Zend Technologies
那么恭喜你，第一步工作已顺利完成!
第二步：下载安装CVS客户端
强烈建议大家使用TortoiseCVS。大家可以在下列网址下载TortoiseCVS:
http://www.tortoisecvs.org/download.shtml
TortoiseCVS目前的稳定版本是 1.10.9。其下载地址：
http://prdownloads.sourceforge.n ... toiseCVS-1.10.9.exe
下载后直接安装即可，它已经自动设置好环境变量。安装成功后在DOS命令提示符下键入cvs命令，如果看到类似的提示：
Usage: cvs [cvs-options] command [command-options-and-arguments]
where cvs-options are -q, -n, etc.
(specify --help-options for a list of options)
where command is add, admin, etc.
(specify --help-commands for a list of commands
or --help-synonyms for a list of command synonyms)
where command-options-and-arguments depend on the specific command
(specify -H followed by a command name for command-specific help)
Specify --help to receive this message
The Concurrent Versions System (CVS) is a tool for version control.
For CVS updates and additional information, see
the CVSNT home page at
http://www.cvsnt.org/
那么第二步的工作也顺利完成！
为了以后工作的便利：大家最好增加一个系统环境变量：
CVSROOT :pserver:cvsread@cvs.php.net:/repository
如果你已经有了翻译文档的CVS帐号，将上面的cvsread 改为自己的帐号名称就可以了。
第三步：下载安装PHP文档编译工具 PHD
(1) 在DOS命令提示符下进入d:\phpdoc目录。运行命令：
d:\phpdoc> cvs –d:pserver:cvsread@cvs.php.net:/repository login
提示输入密码时直接按回车键即可。
(2) 输入命令下载PHD:
d:\phpdoc> cvs –d:pserver:cvsread@cvs.php.net:/repository checkout phd
下载后的PHD位于d:\phpdoc\phd目录下。
如果已经在第二步中设置了CVSROOT系统环境变量，则只需要输入命令:
cvs login
cvs checkout phd
即可。
(3) 安装及设置PHD
以前的官方文档中说明的都是使用PEAR来安装的，但在我们上面下载的PHP 5.3alpha3中并没有包含PEAR。实际上我们只需要做一下简单的修改即可。修改分为两步：首先找到 d:\phpdoc\phd\phd.bat文件，用任意的文本编译器打开，将其中的内容改为：
@d:\phpdoc\php53\php.exe d:\phpdoc\phd\build.php %*
然后将d:\phpdoc\phd加入到系统环境变量PATH中即可。
第四步：准备XML编译器
支持XML的文本编辑软件有很多，例如使用EditPlus, UltraEdit, Notepad++等，大家选择自己熟悉的一种就可以了。注意你的文本编辑软件一定要至少支持GB2312, UTF-8格式的文本软件的编辑。
第五步：下载PHPDOC-ZH
经过1-4步的准备工作，其实翻译环境已经准备就绪。我们只需要通过CVS将phpdoc-zh文档下载下来就可以开始我们的翻译工作了。下载 PHPDOC-ZH很简单，在DOS提示符下进入 d:\phpdoc目录下，运行:
d:\phpdoc> cvs –d:pserver:cvsread@cvs.php.net:/repository checkout phpdoc-zh
如果与第三步的准备工作不是一次性完成的，也许你需要先输入命令 cvs login 。
这个下载的过程有点漫长，泡杯茶，慢慢等吧 :-)
这一步下载完成后的文档会在 d:\phpdoc\phpdoc-zh目录下。
第六步：尝试自己编译PHP文档
PHP文档的原始文件下载完成后，你可以先试着自己编译一下PHP文档。如果前面的准备工作都准备完成，那么编译PHP文档将会非常简单。
在DOS命令提示符下进入 d:\phpdoc\phpdoc-zh 目录下，运行命令：
d:\phpdoc\phpdoc-zh> php configure.php –with-lang=zh
稍等片刻，可以看到会生成.manual.xml 文件。然后使用phd编译一下这个文件就大功告成:
d:\phpdoc\phpdoc-zh> phd
编译完成后的手册在 d:\phpdoc\phpdoc-zh\html 目录下，用浏览器打开 index.html 文件，你自己编译的PHP文档就出现在你的面前了！！！怎么样？有没有一点点的成就感 :-)
备注
(1) 上面的配置并不能编译完全的PHP文档。但对于通常的翻译工作已经足够。当然在正式的翻译工作之前你还需要看一下phpdoc-zh\zh目录下的readme.first文件，最好还参考一下其它人翻译的XML文件。
(2) 上面的配置工作虽然比较简单，但总还是有点麻烦，我打算近期(2008.12.22之前)将其打包制作一个完整的安装程序。如果您有意制作此工具，可以发邮件给我 eniac2008 at php dot net ，这样我就不用做了 :-) 制作完成的工具我会放到网站：
http://www.phpinternals.com
