com doc/zh: sync to en & remove outdated files.: appendices/ini.list.xml docnotes-bsd.txt make_chm_index.html
[email protected] (Bole Chen) Tue, 26 Jan 2021 01:24:16 +0000
| Newsgroups | php.doc.zh |
|---|---|
| Message-ID | <[email protected]> |
Commit: 3042047601cab525c8c4a06ba11def7da79bb973 Author: Bole Chen <[email protected]> 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_3042047601cab525c8c4a06ba11def7da79bb973.txt
(text/plain, 19.5 KB)
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>