com doc/zh: sync to en & remove outdated files.: appendices/ini.list.xml docnotes-bsd.txt make_chm_index.html
| From: | Bole Chen | Date: | Tue, 26 Jan 2021 01:24:16 +0000 |
| Subject: | com doc/zh: sync to en & remove outdated files.: appendices/ini.list.xml docnotes-bsd.txt make_chm_index.html | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-5944@lists.php.net to get a copy of this message | ||
Commit: 3042047601cab525c8c4a06ba11def7da79bb973
Author: Bole Chen <avenger@php.net> Tue, 26 Jan 2021 09:24:16 +0800
Parents: a82d174a8e9de407b9512ce8b8310cd1624734ae
Branches: master
Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=3042047601cab525c8c4a06ba11def7da79bb973
Log:
sync to en & remove outdated files.
Changed paths:
M appendices/ini.list.xml
D docnotes-bsd.txt
D make_chm_index.html
diff --git a/appendices/ini.list.xml b/appendices/ini.list.xml index 8cb4e377..4e8ea627 100644 --- a/appendices/ini.list.xml +++ b/appendices/ini.list.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> <!-- $Author$ --> -<!-- EN-Revision: f3d6ada6156b28791a28efebe2e5c070159c3a94 Maintainer: Avenger Status: ready --> +<!-- EN-Revision: 1fb41f1900406a130e59f37d6e66538a64048524 Maintainer: Avenger Status: ready --> <section xml:id="ini.list" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>&php.ini; 配置选项列表</title> @@ -434,12 +434,6 @@ <entry></entry> </row> <row> - <entry><link linkend="ini.define-syslog-variables">define_syslog_variables</link></entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - <entry>在 PHP 5.4.0 中移除该选项。</entry> - </row> - <row> <entry>detect_unicode</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> @@ -2048,7 +2042,7 @@ <entry>"1"</entry> <entry>PHP_INI_ALL</entry> <entry>从 PHP 7.0.0 起可用</entry> - </row> + </row> <row> <entry><link linkend="ini.session.name">session.name</link></entry> <entry>"PHPSESSID"</entry> diff --git a/docnotes-bsd.txt b/docnotes-bsd.txt deleted file mode 100755 index c7f31158..00000000 --- a/docnotes-bsd.txt +++ /dev/null @@ -1,341 +0,0 @@ -/*** $Id$ ***/ - - 怎样在 FreeBSD 9.1-Release 下进行 PHP 文档工作 - - 本文简单介绍了怎样在 FreeBSD 下逐步实现一个 PHP 文档工作的环境。所针对的是具有一定 -知识和经验的用户。对于有相当经验的高级用户可以直接跳到最后看简化步骤。 - -1.下载安装 FreeBSD - - 首先需要选择合适的版本,FreeBSD 目前最新版是 9.1。鉴于如今大部分电脑已经运行 64 - 位系统,因此建议用 amd64 体系(不论是 Intel 还是 AMD 的 CPU 都适用)。选择该体系的 - ISO 文件下载,由于只需要最小命令行功能,只需下载一个大小为 153MB 的 bootonly - 文件,具体地址为: - - ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/amd64/ISO-IMAGES/9.1/FreeBSD-9.1-RELEASE-amd64-bootonly.iso - - 但是此文件只能启动安装程序,在安装过程中还是需要联网下载所需文件。因此也可以考虑 - 下载大小为 718MB 的较完整安装文件: - - ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/amd64/ISO-IMAGES/9.1/FreeBSD-9.1-RELEASE-amd64-disc1.iso - - 至于安装则建议使用虚拟机,VMWare 或其它虚拟机软件等。对于当前主流为 8G 内存,1TB - 硬盘,3GHz 以上 64 位四核 CPU 的主机来说,占用资源很小。虚拟机建议 2G 内存,20GB - 硬盘。以下过程假定为在虚拟机下安装: - - 从光盘启动后的第一个界面是 Welcome,按回车选择 <Install> 即可; - 下一个界面是 Keymap Selection,不用麻烦,选择 < No >; - 下一个界面是 Set Hostname,选择主机名称,例如 docserver,按回车; - 下一个界面是 Distribution Select,上下箭头移动,空格切换 * 号,一个都不要选!然后按回车; - 下一个界面是 Network Installation,因为要从网上下载安装文件,所以需要配置网络; - 下一个界面是 Network Configuration,选择自己的网络接口,例如 em0;然后配置 IPv4, - 是否使用 DHCP 等,总之经过此步骤应该使该主机能够连接 Internet。之后的 IPv6 - 配置就可以跳过以省掉麻烦; - 然后到了 Mirror Selection 界面,选择一个自己访问速度最快的镜像服务器以下载安装文件; - 下一个界面是 Partition 进行硬盘分区,选择 <Guided> 即可; - 下一个界面是选择是否使用整个磁盘空间作为 FreeBSD 的分区或者一部分,选择 <Entire Disk> 即可; - 下一个界面是 Partition Editor,此时已经自动分好区,选择最后一项 <Finish> 即可; - 然后需要 < Commit > 提交分区信息,此时整个硬盘会被重新分区覆盖掉; - 分区格式化之后就是连接镜像服务器下载系统,此时只需最小的 base 和 kernal; - 然后是为系统管理员 root 用户设定密码; - 接下来是选择时区,选择 [ No ] 之后继续按提示依次选择自己所在大洲,国家,地区; - 下一个界面是 System Configuration,默认启动 sshd 进程,回车即可; - 下一个界面是 Dumpdev Configuration,避免麻烦选 < No >; - 下一个界面是 Add User Accounts,此时可以添加一个普通用户帐号,选 < Yes > - 之后按照提示输入用户名,例如 phpdoc,然后一路回车选默认值直到输入密码, - 最后输入 yes 确认添加此用户,然后再输入 no 不再继续添加; - 下一个界面是 Final Configuration,此时不需要再做什么,直接回车退出安装即可; - 最后一个界面是 Manual Configuration,选择 < No > 即退出安装,然后选择 <Reboot > - 重新启动,至此 FreeBSD 就成功安装。占用硬盘空间大约 1.4GB。 - - 仅为 PHP 文档工作而言,就使用 root 用户并无不妥,使用别的用户当然也可以。可以使用 - 小巧的 PuTTY 软件通过 SSH 远程登录上去。为了使 root 用户能够远程登录,可以编辑 - /etc/ssh/sshd_config 文件,在其中的大约第 46 行找到“#PermitRootLogin no”,去掉 # - 号,改成“PermitRootLogin yes”。然后重新启动 sshd 进程:“/etc/rc.d/sshd reload”。 - - Unix 下最基本的编辑工具是 vi,但是对于不熟悉的用户使用起来很费劲。对此的解决方案 - 是另一个编辑工具 ee。此外还有 GNU nano,不过 nano 不在最小安装中,需要远程安装: - - # pkg_add -r nano - - ee 和 nano 的用法和传统的 DOS 文本界面编辑器类似。 - -2.安装所需软件包 - - 首先要指出 FreeBSD 曾经因为一些漏洞的原因,把官方默认的 9.1 软件包拿掉了。这会导致用 - pkg_add 命令无法远程安装软件包。如果遇到此问题,所需要做的是设定环境变量指定一个远程路径: - - # setenv PACKAGESITE ftp://ftp.freebsd.org/pub/FreeBSD/ports/amd64/packages-9.1-release/Latest/ - - 其中路径根据自己需要选择相应体系以及镜像站点。然后就可以用 pkg_add 安装软件了。 - - 首先是安装 subversion: - - # pkg_add -r subversion - - 这个命令可以自动从上述路径下载最新版本的 subversion 及其所依赖的软件包并安装。完成后 - 可以用: - - # svn --version - - 查看版本信息,目前是 1.7.7 版。接着当然是安装 PHP: - - # pkg_add -r php5 - - 同样会自动下载所有依赖的包并安装,之后同样可以查看版本信息: - - # php -v - - 当前安装的是 5.4.7。还需要一个 DOM 库: - - # pkg_add -r php5-dom - - 然后设定所需要的 php.ini 文件: - - # cd /usr/local/etc - # cp php.ini-development php.ini - - 由于 PHP 5.3 版之后就要求必须设定时区,否则要发出警告,所以还必须在 php.ini - 中设定 date.timezone 指令,将其设定为自己所在的时区。所支持的时区列表见: - - http://www.php.net/manual/zh/timezones.php - - 如果身处中国大陆可以使用 Asia/Shanghai。 - - 这样就完成一个最基本的文档系统了。可以用 pkg_info 命令查看此时都安装了哪些软件包: - - # pkg_info - apr-1.4.6.1.4.1_1 Apache Portability Library - db42-4.2.52_5 The Berkeley DB package, revision 4.2 - expat-2.0.1_2 XML 1.0 parser written in C - gdbm-1.9.1 The GNU database manager - gettext-0.18.1.1 GNU gettext package - libiconv-1.14 A character set conversion library - libxml2-2.7.8_5 XML parser library for GNOME - neon29-0.29.6_4 An HTTP and WebDAV client library for Unix systems - pcre-8.31_1 Perl Compatible Regular Expressions library - php5-5.4.7 PHP Scripting Language - php5-dom-5.4.7 The dom shared extension for php - pkgconf-0.8.9 Utility to help to configure compiler and linker flags - sqlite3-3.7.14.1 An SQL database engine in a C library - subversion-1.7.7 Version control system - -3.取得 PHPDOC 文档 - - 对于中文文档系统,运行如下命令: - - % svn checkout https://svn.php.net/repository/phpdoc/modules/doc-zh phpdoc-zh - - 这样就在当前目录下建立了一个名为 phpdoc-zh 的目录,其中包含有所有英文和中文文档。 - 里面有三个子目录:doc-base,en 和 zh。然后验证一下: - - % cd phpdoc-zh - % php doc-base/configure.php --with-lang=zh - - 如果最后的结果是 All good 并有美洲虎图案的话,就说明文档没有问题,可以编译。 - -4.安装 PhD - - 还需要安装 PhD 才能编译文档。要安装 PhD,先要安装 PEAR: - - # pkg_add -r pear - - 这样就安装了 pear 和 php5-xml。然后用 pear 来安装 PhD。不过在此之前还需要一些 - PHP 的组件才能成功安装 PhD: - - # pkg_add -r php5-xmlreader - # pkg_add -r php5-sqlite3 - # pkg_add -r php5-zlib - - 然后就可以安装 PhD 了,由于会自动安装依赖的组件,所以直接安装 PhD_PHP 即可: - - # pear install doc.php.net/PhD_PHP - - 此时可以列出 PhD 所支持的包: - - # phd -l - Supported packages: - Generic - xhtml - bigxhtml - manpage - PHP - xhtml - bigxhtml - php - howto - manpage - pdf - bigpdf - kdevelop - chm - tocfeed - epub - enhancedchm - -5.编译文档 - - 要编译 xhtml 格式还需要再安装一个所需的库: - - # pkg_add -r php5-json - - 此时只需用以下命令就可以编译文档了(当前目录为 phpdoc-zh): - - % phd -d ./doc-base/.manual.xml -P PHP -f xhtml -o /wwwroot - - 此命令编译的格式是多个 html 小文件的格式,大约 12000 多个文件。并且输出目录是 - /wwwroot,因为不想输出到当前目录以免搞乱了 svn 的目录结构。在 Unix 下的运行速度 - 要比在 Windows 下快很多。 - - 如果要编译其它格式的文档,那 php.ini 中默认设置的内存限制(128M)可能就不够了, - 需要增加。要编译 chm 格式还需要几个扩展库: - - # pkg_add -r php5-bz2 - # pkg_add -r php5-iconv - - % phd -d ./doc-base/.manual.xml -P PHP -f chm -o /wwwroot - - 此时会报出一大堆 E_NOTICE,不用去理会,总之最后编译完成了。至此 FreeBSD 下的文档 - 系统已经完全可用。此时再看 FreeBSD 所安装的软件包: - - # pkg_info - apr-1.4.6.1.4.1_1 Apache Portability Library - db42-4.2.52_5 The Berkeley DB package, revision 4.2 - expat-2.0.1_2 XML 1.0 parser written in C - gdbm-1.9.1 The GNU database manager - gettext-0.18.1.1 GNU gettext package - libiconv-1.14 A character set conversion library - libxml2-2.7.8_5 XML parser library for GNOME - neon29-0.29.6_4 An HTTP and WebDAV client library for Unix systems - pcre-8.31_1 Perl Compatible Regular Expressions library - pear-1.9.4_1 PEAR framework for PHP - php5-5.4.7 PHP Scripting Language - php5-bz2-5.4.7 The bz2 shared extension for php - php5-dom-5.4.7 The dom shared extension for php - php5-iconv-5.4.7 The iconv shared extension for php - php5-json-5.4.7 The json shared extension for php - php5-sqlite3-5.4.7 The sqlite3 shared extension for php - php5-xml-5.4.7 The xml shared extension for php - php5-xmlreader-5.4.7 The xmlreader shared extension for php - php5-zlib-5.4.7 The zlib shared extension for php - pkgconf-0.8.9 Utility to help to configure compiler and linker flags - sqlite3-3.7.14.1 An SQL database engine in a C library - subversion-1.7.7 Version control system - -6.后续工作之一:安装 Apache - - 不妨安装一个 web 服务器,至少可以浏览自己编译出来的文档: - - # pkg_add -r apache22 - - 这将同时安装 perl。然后要让 Apache 在系统启动时同时启动,编辑 /etc/rc.conf,添加一行: - - apache22_enable="YES" - - 然后再编辑 /usr/local/etc/apache22/httpd.conf,在里面设定一个 ServerName,并将 - DocumentRoot 设定为 /wwwroot。通常还需要在 /etc/hosts 中加上 ServerName 设定的 - 主机名称的解析,注意后面主机名一定要以一个点“.”结尾,否则系统启动时会由于解析 - 不了主机名而等待很久。现在可以启动 Apache 了: - - # /usr/local/etc/rc.d/apache22 start - - 现在只要在浏览器中输入 FreeBSD 的主机名(如果能解析的话)或者 IP 地址,就可以 - 看到浏览器显示了目录结构,其中有 php-chunked-xhtml,点进去就显示手册了。 - -7.后续工作之二:安装 Samba - - 可以安装 Samba 以使 Windows 可以使用 FreeBSD 的共享目录。 - - # pkg_add -r samba36 - - 同样,又安装了一堆其所依赖的软件包。此时需要修改的是 /usr/local/etc/smb.conf, - 其中大约第 26 行修改为: - - workgroup = WORKGROUP - - 大约第 29 行修改为: - - server string = docserver - - 这里的 docserver 是网上邻居中所显示的主机名。然后运行以下命令: - - # smbpasswd -a dallas - - 这里的 dallas 是 FreeBSD 系统中已有的普通用户名,这里输入的密码和 FreeBSD 用户的 - 密码无关,只是通过网络共享访问时要输入的密码。这样就给该用户赋予了通过 Windows - 网络共享的权力,并且可以直接访问并修改该用户在 FreeBSD 系统中的用户主目录。同样 - 不要忘记在 /etc/rc.conf 中加入系统启动时自动启动 Samba 的选项: - - samba_enable="YES" - - 然后再运行以下命令启动 Samba: - - # /usr/local/etc/rc.d/samba start - -8.提交文件 - - 现在可以直接在 Windows 中用自己适应的编辑器编辑文件,完成后在 PuTTY 的终端窗口 - 提交即可。Subversion 使用以及 SVN 帐号问题不在本文范围。 - - -********************** 简化步骤 ********************** - - 从以下地址下载 FreeBSD 并最小化安装: - ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/amd64/ISO-IMAGES/9.1/FreeBSD-9.1-RELEASE-amd64-bootonly.iso - 编辑 /etc/ssh/sshd_config,设定 PermitRootLogin yes。然后重新启动 sshd 进程: - # /etc/rc.d/sshd reload - - 依次运行以下命令: - # setenv PACKAGESITE ftp://ftp.freebsd.org/pub/FreeBSD/ports/amd64/packages-9.1-release/Latest/ - # pkg_add -r subversion - # pkg_add -r php5 - # pkg_add -r php5-dom - # pkg_add -r php5-xmlreader - # pkg_add -r php5-sqlite3 - # pkg_add -r php5-zlib - # pkg_add -r php5-json - # pkg_add -r php5-bz2 - # pkg_add -r php5-iconv - # pkg_add -r pear - # pear install doc.php.net/PhD_PHP - - # cd /usr/local/etc - # cp php.ini-development php.ini - - 编辑 php.ini,设定: - date.timezone = Asia/Shanghai - memory_limit = 1024M - - # pkg_add -r apache22 - # pkg_add -r samba36 - # smbpasswd -a phpdoc (或将 phpdoc 换成自己在 FreeBSD 中的普通用户名) - # mkdir /wwwroot - # chmod 777 /wwwroot - - 编辑 /usr/local/etc/apache22/httpd.conf,设定 - ServerName docserver:80 # 这里是该主机的 IP 地址 - DocumentRoot "/wwwroot" # 这里原来是 "/usr/local/www/apache22/data" - <Directory "/wwwroot"> # 把原来的 "/usr/local/www/apache22/data" 替换成了 “/wwwroot” - - 编辑 /etc/hosts,在其中加入一行: - 192.168.1.8 docserver. docserver - 其中的 192.168.1.8 换成该主机实际的 IP 地址。注意后面主机名一定要以一个点“.”结尾, - 否则启动 Apache 时会由于解析不了主机名而等待很久。 - - 编辑 /usr/local/etc/smb.conf,设定 - workgroup = WORKGROUP - server string = docserver - - 编辑 /etc/rc.conf,加入以下两行: - apache22_enable="YES" - samba_enable="YES" - - 启动 Apache 和 Samba: - # /usr/local/etc/rc.d/apache22 start - # /usr/local/etc/rc.d/samba start - - 以上以 root 身份运行。以下可以以普通用户身份运行: - % svn checkout https://svn.php.net/repository/phpdoc/modules/doc-zh phpdoc-zh - % cd phpdoc-zh - % php ./doc-base/configure.php --with-lang=zh - % phd -d ./doc-base/.manual.xml -P PHP -f xhtml -o /wwwroot diff --git a/make_chm_index.html b/make_chm_index.html deleted file mode 100644 index 37dfda6a..00000000 --- a/make_chm_index.html +++ /dev/null @@ -1,56 +0,0 @@ -<HTML> -<!-- $Revision$ --> -<!-- EN-Revision: 3fab8aa04117d847174314d5bbdae38b450e82d8 Maintainer: dallas Status: ready --> -<HEAD> - <META HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8"> - <TITLE>PHP 手册</TITLE> - <LINK REL="STYLESHEET" HREF="style.css"> -</HEAD> -<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" TOPMARGIN="0" LEFTMARGIN="0"> -<TABLE BORDER="0" WIDTH="100%" HEIGHT="100%" CELLSPACING="0" CELLPADDING="0"> -<TR><TD COLSPAN="3"><DIV CLASS="NAVHEADER"><TABLE BGCOLOR="#CCCCFF" BORDER="0" -CELLPADDING="0" CELLSPACING="0" WIDTH="100%"><TR><TD><TABLE WIDTH="100%" BORDER="0" -CELLPADDING="3" CELLSPACING="0"><TR><TH COLSPAN="3">PHP 手册</TH></TR><TR><TD -COLSPAN="3" ALIGN="center"> </TD></TR></TABLE></TD></TR><TR BGCOLOR="#333366"> -<TD><IMG SRC="spacer.gif" BORDER="0" WIDTH="1" HEIGHT="1"><BR></TD></TR></TABLE></DIV></TD></TR> -<TR><TD><IMG SRC="spacer.gif" WIDTH="10" HEIGHT="1"></TD><TD HEIGHT="100%" VALIGN="MIDDLE" WIDTH="100%"><BR> - -<P><TABLE ALIGN="CENTER"> -<TR><TD ALIGN="CENTER"> -<H1 CLASS="title">PHP 手册</H1> -<H4 CLASS="EDITEDBY">主要作者:</H4> -<div class="author">Mehdi Achour</div> -<div class="author">Friedhelm Betz</div> -<div class="author">Antony Dovgal</div> -<div class="author">Nuno Lopes</div> -<div class="author">Hannes Magnusson</div> -<div class="author">Georg Richter</div> -<div class="author">Damien Seguy</div> -<div class="author">Jakub Vrana</div> -<H4 CLASS="EDITEDBY">编辑:</H4> -<H3 CLASS="editor">Philip Olson</H3> -<H4 CLASS="EDITEDBY">中文文档翻译:</H4> -<DIV CLASS="editor">肖盛文</DIV> -<DIV CLASS="editor">穆少磊</DIV> -<DIV CLASS="editor">宋琪</DIV> -<DIV CLASS="editor">黄啸宇</DIV> -<DIV CLASS="editor">王远之</DIV> -<DIV CLASS="editor">肖理达</DIV> -<DIV CLASS="editor">乔楚</DIV> -<DIV CLASS="editor">戴杰</DIV> -</TD></TR></TABLE> -<BR><P ALIGN="CENTER">此文件生成于: [GENTIME]<BR> -访问 <A HREF="http://www.php.net/docs.php">http://www.php.net/docs.php</A> -获取最新版本。</P> - -<BR><P CLASS="copyright" ALIGN="CENTER">PHP 文档组<A HREF="copyright.html">版权</A>所有 -© 1997 - <?dbtimestamp format="Y"?></P> - -</TD><TD><IMG SRC="spacer.gif" WIDTH="10" HEIGHT="1"></TD></TR> -<TR><TD COLSPAN="3"><DIV CLASS="NAVFOOTER"><TABLE BGCOLOR="#CCCCFF" BORDER="0" -CELLPADDING="0" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#333366"> -<TD><IMG SRC="spacer.gif" BORDER="0" WIDTH="1" HEIGHT="1"><BR></TD></TR> -<TR><TD><TABLE WIDTH="100%" BORDER="0" CELLPADDING="3" CELLSPACING="0"> -<TR><TD COLSPAN="3"> </TD></TR><TR><TD COLSPAN="3" ALIGN="center"> </TD> -</TR></TABLE></TD></TR></TABLE></DIV></TD></TR></TABLE> -</BODY></HTML>
diff --git a/appendices/ini.list.xml b/appendices/ini.list.xml index 8cb4e377..4e8ea627 100644 --- a/appendices/ini.list.xml +++ b/appendices/ini.list.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> <!-- $Author$ --> -<!-- EN-Revision: f3d6ada6156b28791a28efebe2e5c070159c3a94 Maintainer: Avenger Status: ready --> +<!-- EN-Revision: 1fb41f1900406a130e59f37d6e66538a64048524 Maintainer: Avenger Status: ready --> <section xml:id="ini.list" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>&php.ini; 配置选项列表</title> @@ -434,12 +434,6 @@ <entry></entry> </row> <row> - <entry><link linkend="ini.define-syslog-variables">define_syslog_variables</link></entry> - <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> - <entry>在 PHP 5.4.0 中移除该选项。</entry> - </row> - <row> <entry>detect_unicode</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> @@ -2048,7 +2042,7 @@ <entry>"1"</entry> <entry>PHP_INI_ALL</entry> <entry>从 PHP 7.0.0 起可用</entry> - </row> + </row> <row> <entry><link linkend="ini.session.name">session.name</link></entry> <entry>"PHPSESSID"</entry> diff --git a/docnotes-bsd.txt b/docnotes-bsd.txt deleted file mode 100755 index c7f31158..00000000 --- a/docnotes-bsd.txt +++ /dev/null @@ -1,341 +0,0 @@ -/*** $Id$ ***/ - - 怎样在 FreeBSD 9.1-Release 下进行 PHP 文档工作 - - 本文简单介绍了怎样在 FreeBSD 下逐步实现一个 PHP 文档工作的环境。所针对的是具有一定 -知识和经验的用户。对于有相当经验的高级用户可以直接跳到最后看简化步骤。 - -1.下载安装 FreeBSD - - 首先需要选择合适的版本,FreeBSD 目前最新版是 9.1。鉴于如今大部分电脑已经运行 64 - 位系统,因此建议用 amd64 体系(不论是 Intel 还是 AMD 的 CPU 都适用)。选择该体系的 - ISO 文件下载,由于只需要最小命令行功能,只需下载一个大小为 153MB 的 bootonly - 文件,具体地址为: - - ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/amd64/ISO-IMAGES/9.1/FreeBSD-9.1-RELEASE-amd64-bootonly.iso - - 但是此文件只能启动安装程序,在安装过程中还是需要联网下载所需文件。因此也可以考虑 - 下载大小为 718MB 的较完整安装文件: - - ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/amd64/ISO-IMAGES/9.1/FreeBSD-9.1-RELEASE-amd64-disc1.iso - - 至于安装则建议使用虚拟机,VMWare 或其它虚拟机软件等。对于当前主流为 8G 内存,1TB - 硬盘,3GHz 以上 64 位四核 CPU 的主机来说,占用资源很小。虚拟机建议 2G 内存,20GB - 硬盘。以下过程假定为在虚拟机下安装: - - 从光盘启动后的第一个界面是 Welcome,按回车选择 <Install> 即可; - 下一个界面是 Keymap Selection,不用麻烦,选择 < No >; - 下一个界面是 Set Hostname,选择主机名称,例如 docserver,按回车; - 下一个界面是 Distribution Select,上下箭头移动,空格切换 * 号,一个都不要选!然后按回车; - 下一个界面是 Network Installation,因为要从网上下载安装文件,所以需要配置网络; - 下一个界面是 Network Configuration,选择自己的网络接口,例如 em0;然后配置 IPv4, - 是否使用 DHCP 等,总之经过此步骤应该使该主机能够连接 Internet。之后的 IPv6 - 配置就可以跳过以省掉麻烦; - 然后到了 Mirror Selection 界面,选择一个自己访问速度最快的镜像服务器以下载安装文件; - 下一个界面是 Partition 进行硬盘分区,选择 <Guided> 即可; - 下一个界面是选择是否使用整个磁盘空间作为 FreeBSD 的分区或者一部分,选择 <Entire Disk> 即可; - 下一个界面是 Partition Editor,此时已经自动分好区,选择最后一项 <Finish> 即可; - 然后需要 < Commit > 提交分区信息,此时整个硬盘会被重新分区覆盖掉; - 分区格式化之后就是连接镜像服务器下载系统,此时只需最小的 base 和 kernal; - 然后是为系统管理员 root 用户设定密码; - 接下来是选择时区,选择 [ No ] 之后继续按提示依次选择自己所在大洲,国家,地区; - 下一个界面是 System Configuration,默认启动 sshd 进程,回车即可; - 下一个界面是 Dumpdev Configuration,避免麻烦选 < No >; - 下一个界面是 Add User Accounts,此时可以添加一个普通用户帐号,选 < Yes > - 之后按照提示输入用户名,例如 phpdoc,然后一路回车选默认值直到输入密码, - 最后输入 yes 确认添加此用户,然后再输入 no 不再继续添加; - 下一个界面是 Final Configuration,此时不需要再做什么,直接回车退出安装即可; - 最后一个界面是 Manual Configuration,选择 < No > 即退出安装,然后选择 <Reboot > - 重新启动,至此 FreeBSD 就成功安装。占用硬盘空间大约 1.4GB。 - - 仅为 PHP 文档工作而言,就使用 root 用户并无不妥,使用别的用户当然也可以。可以使用 - 小巧的 PuTTY 软件通过 SSH 远程登录上去。为了使 root 用户能够远程登录,可以编辑 - /etc/ssh/sshd_config 文件,在其中的大约第 46 行找到“#PermitRootLogin no”,去掉 # - 号,改成“PermitRootLogin yes”。然后重新启动 sshd 进程:“/etc/rc.d/sshd reload”。 - - Unix 下最基本的编辑工具是 vi,但是对于不熟悉的用户使用起来很费劲。对此的解决方案 - 是另一个编辑工具 ee。此外还有 GNU nano,不过 nano 不在最小安装中,需要远程安装: - - # pkg_add -r nano - - ee 和 nano 的用法和传统的 DOS 文本界面编辑器类似。 - -2.安装所需软件包 - - 首先要指出 FreeBSD 曾经因为一些漏洞的原因,把官方默认的 9.1 软件包拿掉了。这会导致用 - pkg_add 命令无法远程安装软件包。如果遇到此问题,所需要做的是设定环境变量指定一个远程路径: - - # setenv PACKAGESITE ftp://ftp.freebsd.org/pub/FreeBSD/ports/amd64/packages-9.1-release/Latest/ - - 其中路径根据自己需要选择相应体系以及镜像站点。然后就可以用 pkg_add 安装软件了。 - - 首先是安装 subversion: - - # pkg_add -r subversion - - 这个命令可以自动从上述路径下载最新版本的 subversion 及其所依赖的软件包并安装。完成后 - 可以用: - - # svn --version - - 查看版本信息,目前是 1.7.7 版。接着当然是安装 PHP: - - # pkg_add -r php5 - - 同样会自动下载所有依赖的包并安装,之后同样可以查看版本信息: - - # php -v - - 当前安装的是 5.4.7。还需要一个 DOM 库: - - # pkg_add -r php5-dom - - 然后设定所需要的 php.ini 文件: - - # cd /usr/local/etc - # cp php.ini-development php.ini - - 由于 PHP 5.3 版之后就要求必须设定时区,否则要发出警告,所以还必须在 php.ini - 中设定 date.timezone 指令,将其设定为自己所在的时区。所支持的时区列表见: - - http://www.php.net/manual/zh/timezones.php - - 如果身处中国大陆可以使用 Asia/Shanghai。 - - 这样就完成一个最基本的文档系统了。可以用 pkg_info 命令查看此时都安装了哪些软件包: - - # pkg_info - apr-1.4.6.1.4.1_1 Apache Portability Library - db42-4.2.52_5 The Berkeley DB package, revision 4.2 - expat-2.0.1_2 XML 1.0 parser written in C - gdbm-1.9.1 The GNU database manager - gettext-0.18.1.1 GNU gettext package - libiconv-1.14 A character set conversion library - libxml2-2.7.8_5 XML parser library for GNOME - neon29-0.29.6_4 An HTTP and WebDAV client library for Unix systems - pcre-8.31_1 Perl Compatible Regular Expressions library - php5-5.4.7 PHP Scripting Language - php5-dom-5.4.7 The dom shared extension for php - pkgconf-0.8.9 Utility to help to configure compiler and linker flags - sqlite3-3.7.14.1 An SQL database engine in a C library - subversion-1.7.7 Version control system - -3.取得 PHPDOC 文档 - - 对于中文文档系统,运行如下命令: - - % svn checkout https://svn.php.net/repository/phpdoc/modules/doc-zh phpdoc-zh - - 这样就在当前目录下建立了一个名为 phpdoc-zh 的目录,其中包含有所有英文和中文文档。 - 里面有三个子目录:doc-base,en 和 zh。然后验证一下: - - % cd phpdoc-zh - % php doc-base/configure.php --with-lang=zh - - 如果最后的结果是 All good 并有美洲虎图案的话,就说明文档没有问题,可以编译。 - -4.安装 PhD - - 还需要安装 PhD 才能编译文档。要安装 PhD,先要安装 PEAR: - - # pkg_add -r pear - - 这样就安装了 pear 和 php5-xml。然后用 pear 来安装 PhD。不过在此之前还需要一些 - PHP 的组件才能成功安装 PhD: - - # pkg_add -r php5-xmlreader - # pkg_add -r php5-sqlite3 - # pkg_add -r php5-zlib - - 然后就可以安装 PhD 了,由于会自动安装依赖的组件,所以直接安装 PhD_PHP 即可: - - # pear install doc.php.net/PhD_PHP - - 此时可以列出 PhD 所支持的包: - - # phd -l - Supported packages: - Generic - xhtml - bigxhtml - manpage - PHP - xhtml - bigxhtml - php - howto - manpage - pdf - bigpdf - kdevelop - chm - tocfeed - epub - enhancedchm - -5.编译文档 - - 要编译 xhtml 格式还需要再安装一个所需的库: - - # pkg_add -r php5-json - - 此时只需用以下命令就可以编译文档了(当前目录为 phpdoc-zh): - - % phd -d ./doc-base/.manual.xml -P PHP -f xhtml -o /wwwroot - - 此命令编译的格式是多个 html 小文件的格式,大约 12000 多个文件。并且输出目录是 - /wwwroot,因为不想输出到当前目录以免搞乱了 svn 的目录结构。在 Unix 下的运行速度 - 要比在 Windows 下快很多。 - - 如果要编译其它格式的文档,那 php.ini 中默认设置的内存限制(128M)可能就不够了, - 需要增加。要编译 chm 格式还需要几个扩展库: - - # pkg_add -r php5-bz2 - # pkg_add -r php5-iconv - - % phd -d ./doc-base/.manual.xml -P PHP -f chm -o /wwwroot - - 此时会报出一大堆 E_NOTICE,不用去理会,总之最后编译完成了。至此 FreeBSD 下的文档 - 系统已经完全可用。此时再看 FreeBSD 所安装的软件包: - - # pkg_info - apr-1.4.6.1.4.1_1 Apache Portability Library - db42-4.2.52_5 The Berkeley DB package, revision 4.2 - expat-2.0.1_2 XML 1.0 parser written in C - gdbm-1.9.1 The GNU database manager - gettext-0.18.1.1 GNU gettext package - libiconv-1.14 A character set conversion library - libxml2-2.7.8_5 XML parser library for GNOME - neon29-0.29.6_4 An HTTP and WebDAV client library for Unix systems - pcre-8.31_1 Perl Compatible Regular Expressions library - pear-1.9.4_1 PEAR framework for PHP - php5-5.4.7 PHP Scripting Language - php5-bz2-5.4.7 The bz2 shared extension for php - php5-dom-5.4.7 The dom shared extension for php - php5-iconv-5.4.7 The iconv shared extension for php - php5-json-5.4.7 The json shared extension for php - php5-sqlite3-5.4.7 The sqlite3 shared extension for php - php5-xml-5.4.7 The xml shared extension for php - php5-xmlreader-5.4.7 The xmlreader shared extension for php - php5-zlib-5.4.7 The zlib shared extension for php - pkgconf-0.8.9 Utility to help to configure compiler and linker flags - sqlite3-3.7.14.1 An SQL database engine in a C library - subversion-1.7.7 Version control system - -6.后续工作之一:安装 Apache - - 不妨安装一个 web 服务器,至少可以浏览自己编译出来的文档: - - # pkg_add -r apache22 - - 这将同时安装 perl。然后要让 Apache 在系统启动时同时启动,编辑 /etc/rc.conf,添加一行: - - apache22_enable="YES" - - 然后再编辑 /usr/local/etc/apache22/httpd.conf,在里面设定一个 ServerName,并将 - DocumentRoot 设定为 /wwwroot。通常还需要在 /etc/hosts 中加上 ServerName 设定的 - 主机名称的解析,注意后面主机名一定要以一个点“.”结尾,否则系统启动时会由于解析 - 不了主机名而等待很久。现在可以启动 Apache 了: - - # /usr/local/etc/rc.d/apache22 start - - 现在只要在浏览器中输入 FreeBSD 的主机名(如果能解析的话)或者 IP 地址,就可以 - 看到浏览器显示了目录结构,其中有 php-chunked-xhtml,点进去就显示手册了。 - -7.后续工作之二:安装 Samba - - 可以安装 Samba 以使 Windows 可以使用 FreeBSD 的共享目录。 - - # pkg_add -r samba36 - - 同样,又安装了一堆其所依赖的软件包。此时需要修改的是 /usr/local/etc/smb.conf, - 其中大约第 26 行修改为: - - workgroup = WORKGROUP - - 大约第 29 行修改为: - - server string = docserver - - 这里的 docserver 是网上邻居中所显示的主机名。然后运行以下命令: - - # smbpasswd -a dallas - - 这里的 dallas 是 FreeBSD 系统中已有的普通用户名,这里输入的密码和 FreeBSD 用户的 - 密码无关,只是通过网络共享访问时要输入的密码。这样就给该用户赋予了通过 Windows - 网络共享的权力,并且可以直接访问并修改该用户在 FreeBSD 系统中的用户主目录。同样 - 不要忘记在 /etc/rc.conf 中加入系统启动时自动启动 Samba 的选项: - - samba_enable="YES" - - 然后再运行以下命令启动 Samba: - - # /usr/local/etc/rc.d/samba start - -8.提交文件 - - 现在可以直接在 Windows 中用自己适应的编辑器编辑文件,完成后在 PuTTY 的终端窗口 - 提交即可。Subversion 使用以及 SVN 帐号问题不在本文范围。 - - -********************** 简化步骤 ********************** - - 从以下地址下载 FreeBSD 并最小化安装: - ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/amd64/ISO-IMAGES/9.1/FreeBSD-9.1-RELEASE-amd64-bootonly.iso - 编辑 /etc/ssh/sshd_config,设定 PermitRootLogin yes。然后重新启动 sshd 进程: - # /etc/rc.d/sshd reload - - 依次运行以下命令: - # setenv PACKAGESITE ftp://ftp.freebsd.org/pub/FreeBSD/ports/amd64/packages-9.1-release/Latest/ - # pkg_add -r subversion - # pkg_add -r php5 - # pkg_add -r php5-dom - # pkg_add -r php5-xmlreader - # pkg_add -r php5-sqlite3 - # pkg_add -r php5-zlib - # pkg_add -r php5-json - # pkg_add -r php5-bz2 - # pkg_add -r php5-iconv - # pkg_add -r pear - # pear install doc.php.net/PhD_PHP - - # cd /usr/local/etc - # cp php.ini-development php.ini - - 编辑 php.ini,设定: - date.timezone = Asia/Shanghai - memory_limit = 1024M - - # pkg_add -r apache22 - # pkg_add -r samba36 - # smbpasswd -a phpdoc (或将 phpdoc 换成自己在 FreeBSD 中的普通用户名) - # mkdir /wwwroot - # chmod 777 /wwwroot - - 编辑 /usr/local/etc/apache22/httpd.conf,设定 - ServerName docserver:80 # 这里是该主机的 IP 地址 - DocumentRoot "/wwwroot" # 这里原来是 "/usr/local/www/apache22/data" - <Directory "/wwwroot"> # 把原来的 "/usr/local/www/apache22/data" 替换成了 “/wwwroot” - - 编辑 /etc/hosts,在其中加入一行: - 192.168.1.8 docserver. docserver - 其中的 192.168.1.8 换成该主机实际的 IP 地址。注意后面主机名一定要以一个点“.”结尾, - 否则启动 Apache 时会由于解析不了主机名而等待很久。 - - 编辑 /usr/local/etc/smb.conf,设定 - workgroup = WORKGROUP - server string = docserver - - 编辑 /etc/rc.conf,加入以下两行: - apache22_enable="YES" - samba_enable="YES" - - 启动 Apache 和 Samba: - # /usr/local/etc/rc.d/apache22 start - # /usr/local/etc/rc.d/samba start - - 以上以 root 身份运行。以下可以以普通用户身份运行: - % svn checkout https://svn.php.net/repository/phpdoc/modules/doc-zh phpdoc-zh - % cd phpdoc-zh - % php ./doc-base/configure.php --with-lang=zh - % phd -d ./doc-base/.manual.xml -P PHP -f xhtml -o /wwwroot diff --git a/make_chm_index.html b/make_chm_index.html deleted file mode 100644 index 37dfda6a..00000000 --- a/make_chm_index.html +++ /dev/null @@ -1,56 +0,0 @@ -<HTML> -<!-- $Revision$ --> -<!-- EN-Revision: 3fab8aa04117d847174314d5bbdae38b450e82d8 Maintainer: dallas Status: ready --> -<HEAD> - <META HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8"> - <TITLE>PHP 手册</TITLE> - <LINK REL="STYLESHEET" HREF="style.css"> -</HEAD> -<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" TOPMARGIN="0" LEFTMARGIN="0"> -<TABLE BORDER="0" WIDTH="100%" HEIGHT="100%" CELLSPACING="0" CELLPADDING="0"> -<TR><TD COLSPAN="3"><DIV CLASS="NAVHEADER"><TABLE BGCOLOR="#CCCCFF" BORDER="0" -CELLPADDING="0" CELLSPACING="0" WIDTH="100%"><TR><TD><TABLE WIDTH="100%" BORDER="0" -CELLPADDING="3" CELLSPACING="0"><TR><TH COLSPAN="3">PHP 手册</TH></TR><TR><TD -COLSPAN="3" ALIGN="center"> </TD></TR></TABLE></TD></TR><TR BGCOLOR="#333366"> -<TD><IMG SRC="spacer.gif" BORDER="0" WIDTH="1" HEIGHT="1"><BR></TD></TR></TABLE></DIV></TD></TR> -<TR><TD><IMG SRC="spacer.gif" WIDTH="10" HEIGHT="1"></TD><TD HEIGHT="100%" VALIGN="MIDDLE" WIDTH="100%"><BR> - -<P><TABLE ALIGN="CENTER"> -<TR><TD ALIGN="CENTER"> -<H1 CLASS="title">PHP 手册</H1> -<H4 CLASS="EDITEDBY">主要作者:</H4> -<div class="author">Mehdi Achour</div> -<div class="author">Friedhelm Betz</div> -<div class="author">Antony Dovgal</div> -<div class="author">Nuno Lopes</div> -<div class="author">Hannes Magnusson</div> -<div class="author">Georg Richter</div> -<div class="author">Damien Seguy</div> -<div class="author">Jakub Vrana</div> -<H4 CLASS="EDITEDBY">编辑:</H4> -<H3 CLASS="editor">Philip Olson</H3> -<H4 CLASS="EDITEDBY">中文文档翻译:</H4> -<DIV CLASS="editor">肖盛文</DIV> -<DIV CLASS="editor">穆少磊</DIV> -<DIV CLASS="editor">宋琪</DIV> -<DIV CLASS="editor">黄啸宇</DIV> -<DIV CLASS="editor">王远之</DIV> -<DIV CLASS="editor">肖理达</DIV> -<DIV CLASS="editor">乔楚</DIV> -<DIV CLASS="editor">戴杰</DIV> -</TD></TR></TABLE> -<BR><P ALIGN="CENTER">此文件生成于: [GENTIME]<BR> -访问 <A HREF="http://www.php.net/docs.php">http://www.php.net/docs.php</A> -获取最新版本。</P> - -<BR><P CLASS="copyright" ALIGN="CENTER">PHP 文档组<A HREF="copyright.html">版权</A>所有 -© 1997 - <?dbtimestamp format="Y"?></P> - -</TD><TD><IMG SRC="spacer.gif" WIDTH="10" HEIGHT="1"></TD></TR> -<TR><TD COLSPAN="3"><DIV CLASS="NAVFOOTER"><TABLE BGCOLOR="#CCCCFF" BORDER="0" -CELLPADDING="0" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#333366"> -<TD><IMG SRC="spacer.gif" BORDER="0" WIDTH="1" HEIGHT="1"><BR></TD></TR> -<TR><TD><TABLE WIDTH="100%" BORDER="0" CELLPADDING="3" CELLSPACING="0"> -<TR><TD COLSPAN="3"> </TD></TR><TR><TD COLSPAN="3" ALIGN="center"> </TD> -</TR></TABLE></TD></TR></TABLE></DIV></TD></TR></TABLE> -</BODY></HTML>