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">&nbsp;</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">&nbsp;</TD></TR><TR><TD COLSPAN="3" ALIGN="center">&nbsp;</TD>
-</TR></TABLE></TD></TR></TABLE></DIV></TD></TR></TABLE>
-</BODY></HTML>