Skip to content

Commit fe5fb30

Browse files
mowangjuanzimowangjuanzi
committed
Update install/language
1 parent 311dda9 commit fe5fb30

File tree

9 files changed

+363
-312
lines changed

9 files changed

+363
-312
lines changed

‎install/fpm/configuration.xml

Lines changed: 70 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 78cfb58c46cab7bd81921faeacd1c6830d807dbd Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: fe2ce5304bfe7eaadba78bebb877dcd197df4c41 Maintainer: HonestQiao Status: ready -->
44
<!-- CREDITS: mowangjuanzi -->
55
<sect1 xml:id="install.fpm.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>配置</title>
@@ -390,8 +390,7 @@
390390
<listitem>
391391
<para>
392392
设置启动时创建的子进程数目。仅在 <literal>pm</literal> 设置为
393-
<literal>dynamic</literal> 时使用。默认值：min_spare_servers + (max_spare_servers -
394-
min_spare_servers) / 2。
393+
<literal>dynamic</literal> 时使用。默认值：(min_spare_servers + max_spare_servers) / 2。
395394
</para>
396395
</listitem>
397396
</varlistentry>
@@ -741,49 +740,68 @@
741740
</row>
742741
</thead>
743742
<tbody>
743+
<row>
744+
<entry>
745+
<literal>%%</literal>
746+
</entry>
747+
<entry><literal>%</literal> 字符</entry>
748+
</row>
744749
<row>
745750
<entry>
746751
<literal>%C</literal>
747752
</entry>
748-
<entry>%CPU</entry>
753+
<entry>
754+
请求使用的 %CPU。可以接受以下格式：<literal>%{user}C</literal> 仅表示用户
755+
CPU，<literal>%{system}C</literal> 仅表示系统 CPU，<literal>%{total}C</literal>
756+
表示用户 + 系统 CPU（默认）
757+
</entry>
749758
</row>
750759
<row>
751760
<entry>
752761
<literal>%d</literal>
753762
</entry>
754763
<entry>
755-
持续时间。接受以下精度格式：<literal>%{seconds}d</literal>（默认）<literal>%{milliseconds}d</literal>、<literal>%{microseconds}d</literal>。
764+
处理请求所花费的时间。可以接受以下格式以提高精度：<literal>%{seconds}d</literal>（默认）<literal>%{milliseconds}d</literal>、<literal>%{microseconds}d</literal>
756765
</entry>
757766
</row>
758767
<row>
759768
<entry>
760-
<literal>%e</literal>
769+
<literal>%{<replaceable>name</replaceable>}e</literal>
770+
</entry>
771+
<entry>
772+
环境变量（与 <varname>$_ENV</varname> 或 <varname>$_SERVER</varname>
773+
相同）。必须在花括号内指定变量名称，以指定环境 env 的名称。例如，服务器详细信息（如 <literal>%{REQUEST_METHOD}e</literal>
774+
或 <literal>%{SERVER_PROTOCOL}e</literal>）、HTTP header（如 <literal>%{HTTP_HOST}e</literal> 或
775+
<literal>%{HTTP_USER_AGENT}e</literal>）
761776
</entry>
762-
<entry>fastcgi 环境变量</entry>
763777
</row>
764778
<row>
765779
<entry>
766780
<literal>%f</literal>
767781
</entry>
768-
<entry>脚本文件</entry>
782+
<entry>脚本文件名</entry>
769783
</row>
770784
<row>
771785
<entry>
772786
<literal>%l</literal>
773787
</entry>
774-
<entry>内容长度</entry>
788+
<entry>
789+
请求的 <literal>Content-Length</literal>（仅适用于 HTTP POST 请求）
790+
</entry>
775791
</row>
776792
<row>
777793
<entry>
778794
<literal>%m</literal>
779795
</entry>
780-
<entry>请求方法</entry>
796+
<entry>请求 HTTP 方法</entry>
781797
</row>
782798
<row>
783799
<entry>
784800
<literal>%M</literal>
785801
</entry>
786-
<entry>内存</entry>
802+
<entry>
803+
PHP 分配的内存峰值。可以接受以下格式：<literal>%{bytes}M</literal>（默认）、<literal>%{kilobytes}M</literal>、<literal>%{kilo}M</literal>、<literal>%{megabytes}M</literal>、<literal>%{mega}M</literal>
804+
</entry>
787805
</row>
788806
<row>
789807
<entry>
@@ -793,15 +811,24 @@
793811
</row>
794812
<row>
795813
<entry>
796-
<literal>%o</literal>
814+
<literal>%{<replaceable>name</replaceable>}o</literal>
815+
</entry>
816+
<entry>
817+
输出 header。必须在花括号内指定 header 名称。例如
818+
<literal>%{Content-Type}o</literal>、<literal>%{X-Powered-By}o</literal>、<literal>%{Transfer-Encoding}o</literal>
797819
</entry>
798-
<entry>header 输出</entry>
799820
</row>
800821
<row>
801822
<entry>
802823
<literal>%p</literal>
803824
</entry>
804-
<entry>PID</entry>
825+
<entry>为请求提供服务的子进程的 PID</entry>
826+
</row>
827+
<row>
828+
<entry>
829+
<literal>%P</literal>
830+
</entry>
831+
<entry>为请求提供服务的子进程的父进程 PID</entry>
805832
</row>
806833
<row>
807834
<entry>
@@ -813,13 +840,17 @@
813840
<entry>
814841
<literal>%Q</literal>
815842
</entry>
816-
<entry>%q 和 %r 之间的连接字符</entry>
843+
<entry>
844+
如果查询字符串存在，则为 <literal>'?'</literal> 字符，或 <literal>%q</literal> 和 <literal>%r</literal> 之间的连接字符
845+
</entry>
817846
</row>
818847
<row>
819848
<entry>
820849
<literal>%r</literal>
821850
</entry>
822-
<entry>请求 URI</entry>
851+
<entry>
852+
不带查询字符串的请求 URI，参阅 <literal>%q</literal> 和 <literal>%Q</literal>
853+
</entry>
823854
</row>
824855
<row>
825856
<entry>
@@ -831,25 +862,35 @@
831862
<entry>
832863
<literal>%s</literal>
833864
</entry>
834-
<entry>状态码</entry>
865+
<entry>状态（响应码）</entry>
835866
</row>
836867
<row>
837868
<entry>
838-
<literal>%T</literal>
869+
<literal>%t</literal>
870+
</entry>
871+
<entry>
872+
收到请求的服务器时间。可以接受 <literal>strftime(3)</literal> 格式
873+
<literal>%d/%b/%Y:%H:%M:%S %z</literal>（默认）。<literal>strftime(3)</literal> 格式必须封装在
874+
<literal>%{&lt;strftime_format&gt;}t</literal> 标签中，例如，对于 ISO8601 格式的时间字符串，使用
875+
<literal>%{%Y-%m-%dT%H:%M:%S%z}t</literal>
839876
</entry>
840-
<entry>时间</entry>
841877
</row>
842878
<row>
843879
<entry>
844-
<literal>%t</literal>
880+
<literal>%T</literal>
881+
</entry>
882+
<entry>
883+
写入日志的时间（请求完成时）。可以接受 <literal>strftime(3)</literal> 格式
884+
<literal>%d/%b/%Y:%H:%M:%S %z</literal>（默认）。<literal>strftime(3)</literal> 格式必须封装在
885+
<literal>%{&lt;strftime_format&gt;}t</literal> 标签中，例如，对于 ISO8601 格式的时间字符串，使用
886+
<literal>%{%Y-%m-%dT%H:%M:%S%z}t</literal>
845887
</entry>
846-
<entry>时间</entry>
847888
</row>
848889
<row>
849890
<entry>
850891
<literal>%u</literal>
851892
</entry>
852-
<entry>远程用户</entry>
893+
<entry>基本访问认证用户（如果在 <literal>Authorization</literal> header 中指定）</entry>
853894
</row>
854895
</tbody>
855896
</tgroup>
@@ -858,13 +899,12 @@
858899
</listitem>
859900
</varlistentry>
860901
</variablelist>
861-
862-
<para>
863-
还可以在为一个运行池传递附加的环境变量，或者更新 PHP
864-
的配置值。可以在进程池配置文件中如下面的配置参数来做到：
865-
<example>
866-
<title>给运行池传递环境变量和设置 PHP 的配置值</title>
867-
<programlisting role="ini">
902+
<para>
903+
还可以在为一个运行池传递附加的环境变量，或者更新 PHP
904+
的配置值。可以在进程池配置文件中如下面的配置参数来做到：
905+
<example>
906+
<title>给运行池传递环境变量和设置 PHP 的配置值</title>
907+
<programlisting role="ini">
868908
<![CDATA[
869909
env[HOSTNAME] = $HOSTNAME
870910
env[PATH] = /usr/local/bin:/usr/bin:/bin
@@ -877,7 +917,7 @@ php_flag[display_errors] = off
877917
php_admin_value[error_log] = /var/log/fpm-php.www.log
878918
php_admin_flag[log_errors] = on
879919
php_admin_value[memory_limit] = 32M
880-
]]>
920+
]]>
881921
</programlisting>
882922
</example>
883923
PHP配置值通过 <literal>php_value</literal> 或者

‎language-snippets.ent

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 8b502f81f951a1af64396b69823f7a35b7637541 Maintainer: Gregory Status: ready -->
3+
<!-- EN-Revision: 9a5b92a30888d6423db112f07a9b344cf6fc4891 Maintainer: Gregory Status: ready -->
44
<!-- CREDITS: dallas, mowangjuanzi, Luffy -->
55
<!-- 请保持此文件与英文文件中相应的每个 ENTITY 行号一一对应以便于对照，修改与更新！ -->
66

@@ -2071,6 +2071,10 @@ xmlns="http://docbook.org/ns/docbook">PECL</acronym> 扩展的
20712071
<!ENTITY pecl.moved-ver '此扩展已被移至 &link.pecl; 资源库；不再与 PHP 捆绑，从 PHP '>
20722072

20732073

2074+
<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
2075+
<simpara>此扩展已<emphasis>无人维护</emphasis>。</simpara>
2076+
</warning>'>
2077+
20742078
<!-- PGSQL entities -->
20752079

20762080
<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook"><classname>PgSql\Connection</classname> 实例。</para>'>

‎language/constants.xml

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
<?xml version="1.0" encoding="utf-8" ?>
22
<!-- $Revision$ -->
3-
<!-- $Author$ -->
4-
<!-- EN-Revision: be039c085ee703d5b1f39837e55081d6e2d55030 Maintainer: Avenger Status: ready -->
5-
<!-- CREDITS: Altair, Luffy -->
3+
<!-- EN-Revision: f9dabdea3f92ea77cf5077020a3e945951fdc9db Maintainer: Avenger Status: ready -->
4+
<!-- CREDITS: Altair, Luffy, mowangjuanzi -->
65
<chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook">
76
<title>常量</title>
87

@@ -279,6 +278,12 @@ echo ANIMALS[1]; // 将输出 "cat"
279278
类的方法名。
280279
</entry>
281280
</row>
281+
<row xml:id="constant.property">
282+
<entry><constant>__PROPERTY__</constant></entry>
283+
<entry>
284+
仅在<link linkend="language.oop5.property-hooks">属性挂钩</link>内有效。等同于属性的名称。
285+
</entry>
286+
</row>
282287
<row xml:id="constant.namespace">
283288
<entry><constant>__NAMESPACE__</constant></entry>
284289
<entry>

‎language/fibers.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4985eb0aa7bb240fa3bf7c17f76e1609faef327e Maintainer: Rytia Status: ready -->
3+
<!-- EN-Revision: 376d3f9c2ef7fcd64d8b8503d552013acefb8b5b Maintainer: Rytia Status: ready -->
44
<!-- CREDITS: mowangjuanzi -->
55
<chapter xml:id="language.fibers" xmlns="http://docbook.org/ns/docbook">
66
<title>纤程</title>
@@ -40,7 +40,7 @@
4040
</para>
4141
<note>
4242
<simpara>
43-
由于当前限制，不能在对象的析构函数中打开或关闭纤程。
43+
在 PHP 8.4.0 之前，不允许在对象<link linkend="language.oop5.decon.destructor">析构方法</link>执行期间切换纤程。
4444
</simpara>
4545
</note>
4646

‎language/functions.xml

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 74976cdb263ef841c5fc2c3f91ca7e284adce552 Maintainer: avenger Status: ready -->
3+
<!-- EN-Revision: 489d46bc2598784bd3711454ccab8940107cde67 Maintainer: avenger Status: ready -->
44
<!-- CREDITS: Gregory, dallas, Luffy, mowangjuanzi -->
55
<chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
66
<title>函数</title>
@@ -415,19 +415,24 @@ Making a bowl of raspberry natural yogurt.
415415
<para>
416416
自 PHP 8.0.0 起，<emphasis>弃用</emphasis>在可选参数之后声明强制参数。这通常可以通过删除默认值来解决，因为它永远不会被使用。唯一的例外是
417417
<code>Type $param = null</code> 类型的参数，其中默认 &null; 使得该类型可以隐式为
418-
null。这种做法依然允许，但是推荐使用显式<link linkend="language.types.declarations.nullable">可为 null 类型</link>代替。
418+
null。自 PHP 8.4.0 起，此用法已弃用，而应改用显式<link linkend="language.types.declarations.nullable">可为 null 类型</link>。
419419
<example>
420420
<title>强制参数后声明可选参数</title>
421421
<programlisting role="php">
422422
<![CDATA[
423-
<?php
424-
function foo($a = [], $b) {} // 默认不使用；自 PHP 8.0.0 起弃用
425-
function foo($a, $b) {} // 功能相同，无弃用通知
426-
427-
function bar(A $a = null, $b) {} // 仍然允许；但 $a 强制但可以为 null
428-
function bar(?A $a, $b) {} // 推荐
429-
?>
430-
]]>
423+
<?php
424+
425+
function foo($a = [], $b) {} // 默认不使用；自 PHP 8.0.0 起弃用
426+
function foo($a, $b) {} // 功能相同，无弃用通知
427+
428+
function bar(A $a = null, $b) {} // 自 PHP 8.1.0 起，$a 是隐式必需的
429+
// （因为其位于必需的参数之前），
430+
// 但隐式可为 null（自 PHP 8.4.0 起已弃用），
431+
// 因为默认参数值为 null
432+
function bar(?A $a, $b) {} // 推荐
433+
434+
?>
435+
]]>
431436
</programlisting>
432437
</example>
433438
</para>

‎language/generators.xml

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 31d42a7a6e9ecf4227f6b1dc6936eccd40846fa7 Maintainer: 虾米 Status: ready -->
3+
<!-- EN-Revision: 08e58ace7e5b538c8ed75d784a54885d5f785d30 Maintainer: 虾米 Status: ready -->
44
<!-- CREDITS: Luffy, mowangjuanzi -->
55
<chapter xml:id="language.generators" xmlns="http://docbook.org/ns/docbook">
66
<title>生成器</title>
@@ -16,10 +16,9 @@
1616
</para>
1717

1818
<para>
19-
生成器允许你在 &foreach;
20-
代码块中写代码来迭代一组数据而不需要在内存中创建一个数组, 那会使你的内存达到上限，或者会占据可观的处理时间。相反，你可以写一个生成器函数，就像一个普通的自定义<link
21-
linkend="functions.user-defined">函数</link>一样, 和普通函数只<link
22-
linkend="functions.returning-values">返回</link>一次不同的是, 生成器可以根据需要 &yield; 多次，以便生成需要迭代的值。
19+
生成器提供了方便的方式来向 &foreach; 循环提供数据，而无需提前在内存中构建数组，这可能会导致程序超出内存限制或需要相当长的处理时间来生成。相反，可以使用生成器函数，与普通的
20+
<link linkend="functions.user-defined">function</link> 相同，不同之处在于生成器不是 <link linkend="functions.returning-values">return</link>
21+
一次，而是可以根据需要多次 &yield; 以提供要迭代的值。与迭代器一样，无法进行随机数据访问。
2322
</para>
2423

2524
<para>

‎language/oop5.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: c0fa5077c8862405942d8aac7360c5169558b59b Maintainer: verdana Status: ready -->
4-
<!-- CREDITS: dallas, HonestQiao, Luffy -->
3+
<!-- EN-Revision: f9dabdea3f92ea77cf5077020a3e945951fdc9db Maintainer: verdana Status: ready -->
4+
<!-- CREDITS: dallas, HonestQiao, Luffy, mowangjuanzi -->
55
<chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook">
66
<title>类与对象</title>
77

@@ -26,6 +26,7 @@
2626

2727
&language.oop5.basic;
2828
&language.oop5.properties;
29+
&language.oop5.property-hooks;
2930
&language.oop5.constants;
3031
&language.oop5.autoload;
3132
&language.oop5.decon;

‎language/types.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 5fccbe5195820cd9ec0045674312ec567ef5f6ed Maintainer: dallas Status: ready -->
3+
<!-- EN-Revision: 117340b0d72bc8884290450ae8b89643528e0f58 Maintainer: dallas Status: ready -->
44
<!-- CREDITS: HonestQiao, Gregory, Haohappy, mowangjuanzi, Luffy -->
55
<chapter xml:id="language.types" xmlns="http://docbook.org/ns/docbook">
66
<title>类型</title>
@@ -25,7 +25,8 @@
2525

2626
<para>
2727
PHP 是动态类型语言，这意味着默认不需要指定变量的类型，因为会在运行时确定。然而，可以通过使用<link
28-
linkend="language.types.declarations">类型声明</link>对语言的一些方面进行类型静态化。
28+
linkend="language.types.declarations">类型声明</link>对语言的一些方面进行类型静态化。可以在<link
29+
linkend="language.types.type-system">类型系统</link>页面找到 PHP 类型系统支持的不同类型。
2930
</para>
3031

3132
<para>

0 commit comments

Comments
 (0)