Skip to content

Commit 11d8888

Browse files
mowangjuanzimowangjuanzi
committed
Update language-snippets.ent
1 parent 2a5f1d1 commit 11d8888

File tree

2 files changed

+206
-6
lines changed

2 files changed

+206
-6
lines changed

‎language-defs.ent‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 38ee86c3c030bc74362a7e5c185192ef8ad5a442 Maintainer: yincheng Status: ready -->
3+
<!-- EN-Revision: 5097918a78b2d1de0839a48bd30912d498ac5850 Maintainer: yincheng Status: ready -->
4+
<!-- CREDITS: mowangjuanzi -->
45
<!-- Part titles used mostly in manual.xml itself -->
56
<!ENTITY PHPManual "PHP 手册">
67
<!ENTITY Seealso "参见">
@@ -86,6 +87,7 @@ supplemental files to mark section titles -->
8687
<!ENTITY reftitle.changelog '<title xmlns="http://docbook.org/ns/docbook">&Changelog;</title>'>
8788
<!ENTITY reftitle.classes '<title xmlns="http://docbook.org/ns/docbook">预定义类</title>'>
8889
<!ENTITY reftitle.classsynopsis '<title xmlns="http://docbook.org/ns/docbook">类摘要</title>'>
90+
<!ENTITY reftitle.enumsynopsis '<title xmlns="http://docbook.org/ns/docbook">注解摘要</title>'>
8991
<!ENTITY reftitle.constants '<title xmlns="http://docbook.org/ns/docbook">预定义常量</title>'>
9092
<!ENTITY reftitle.constructor '<title xmlns="http://docbook.org/ns/docbook">构造函数</title>'>
9193
<!ENTITY reftitle.description '<title xmlns="http://docbook.org/ns/docbook">说明</title>'>

‎language-snippets.ent‎

Lines changed: 203 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: 5051184c4fb3fcfe5f3f01f4789d0149e3e1f945 Maintainer: Gregory Status: ready -->
3+
<!-- EN-Revision: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: Gregory Status: ready -->
44
<!-- CREDITS: dallas, mowangjuanzi, Luffy -->
55
<!-- 请保持此文件与英文文件中相应的每个 ENTITY 行号一一对应以便于对照，修改与更新！ -->
66

@@ -362,14 +362,17 @@ xmlns="http://docbook.org/ns/docbook"><simpara>本特性已自 PHP 8.3.0
362362
xmlns="http://docbook.org/ns/docbook"><simpara>此函数自 PHP 8.3.0
363363
起<emphasis>弃用</emphasis>。强烈建议不要应用此函数。</simpara></warning>'>
364364

365+
365366
<!ENTITY warn.deprecated.feature-8-4-0 '<warning
366367
xmlns="http://docbook.org/ns/docbook"><simpara>本特性已自 PHP 8.4.0
367368
起<emphasis>废弃</emphasis>。强烈建议不要使用本特性。</simpara></warning>'>
368369

370+
369371
<!ENTITY warn.deprecated.function-8-4-0 '<warning
370372
xmlns="http://docbook.org/ns/docbook"><simpara>此函数自 PHP 8.4.0
371373
起<emphasis>弃用</emphasis>。强烈建议不要应用此函数。</simpara></warning>'>
372374

375+
373376
<!ENTITY removed.php.future '本过时特性<emphasis
374377
xmlns="http://docbook.org/ns/docbook">将</emphasis>肯定会在未来被<emphasis xmlns="http://docbook.org/ns/docbook">移除</emphasis>。'>
375378

@@ -1413,7 +1416,7 @@ linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">到期时
14131416
<!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
14141417
Returns an array indexed by <parameter>keys</parameter>. Each element
14151418
is &true; if the corresponding key was deleted, or one of the
1416-
<constant>Memcached::RES_*</constant> constants if the corresponding deletion
1419+
<constant>Memcached::RES_<replaceable>*</replaceable></constant> constants if the corresponding deletion
14171420
failed.
14181421
</para>
14191422
<para xmlns="http://docbook.org/ns/docbook">
@@ -1961,6 +1964,7 @@ It is strongly recommended to avoid timezone abbreviations.
19611964
<!ENTITY ps.note.visible '<para xmlns="http://docbook.org/ns/docbook">此说明在文档被打印或显示时不可见，只在文档用 Acrobat Distiller 或 Ghostview 转换成 PDF 时显示。</para>'>
19621965

19631966

1967+
19641968
<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><para>此函数受
19651969
<link linkend="ini.open-basedir">open_basedir</link> 影响。</para></note>'>
19661970

@@ -2011,6 +2015,7 @@ It is strongly recommended to avoid timezone abbreviations.
20112015
</simpara>'>
20122016

20132017

2018+
20142019
<!-- PDO entities -->
20152020
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">下列常量由此驱动定义，且仅在扩展编译入 PHP
20162021
或在运行时动态载入时可用。另外，使用此驱动时，仅会使用这些驱动特定的常量。使用其他驱动的驱动特定的常量可能会导致不可预见的情况。如果代码可运行于多个驱动，<function>PDO::getAttribute</function>
@@ -2139,7 +2144,6 @@ while <constant>PGSQL_BOTH</constant> will return both numerical and associative
21392144

21402145
<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">SQL 安全模式</link>'>
21412146

2142-
21432147
<!-- BCMath Notes -->
21442148
<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
21452149
<parameter>scale</parameter></term><listitem><para>此可选参数用于设置结果中小数点后的小数位数。也可通过使用
@@ -2266,6 +2270,7 @@ PHP FastCGI 的主要实现，包含大部分对高负载网站有用的功能
22662270

22672271
<!ENTITY database.fetch-null '<note xmlns="http://docbook.org/ns/docbook"><simpara>此函数将 NULL 字段设置为 PHP &null; 值。</simpara></note>'>
22682272

2273+
22692274
<!-- MySQL Notes -->
22702275
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
22712276
<!ENTITY mysql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
@@ -2330,6 +2335,9 @@ link_identifier</parameter></term><listitem><para> MySQL 连接. 如果该连接
23302335
执行完毕后自动销毁，所以手动关闭连接，并释放资源是可选的。但是还是推荐你在代码中显性的执行该操作，这对提高代码性能有帮助。参考文档
23312336
<link linkend="language.types.resource.self-destruct">资源释放</link></para>'>
23322337

2338+
2339+
2340+
23332341
<!-- Xattr entities -->
23342342
<!ENTITY xattr.namespace '<para xmlns="http://docbook.org/ns/docbook">扩展的属性有两种 不同的命名空间：user
23352343
和 root。user 命名空间对所有用户均有效，而 root
@@ -2365,6 +2373,7 @@ xattr 默认在 user 命名空间上操作，但可使用
23652373
的产品中使用线程化 MPM。应使用预分支 MPM，Apache 2.0 和 2.2
23662374
默认的 MPM。其原因见 FAQ 中的相关条目<link linkend="faq.installation.apache2">使用线程化 MPM 的
23672375
Apache2</link>。</para></warning>'>
2376+
23682377
<!ENTITY warn.install.third-party-support '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
23692378
<para>
23702379
第三方提供的版本被视为非官方版本，不直接受 PHP 项目支持。
@@ -2373,6 +2382,8 @@ Apache2</link>。</para></warning>'>
23732382
</para>
23742383
</warning>'>
23752384

2385+
2386+
23762387
<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara>记住当在
23772388
Windows 环境下的 Apache 配置文件中添加路径值时，所有的反斜线，如
23782389
<filename>c:\directory\file.ext</filename>，应转换为正斜线：
@@ -3614,6 +3625,146 @@ local: {
36143625
</itemizedlist>
36153626
'>
36163627

3628+
<!ENTITY strings.stripped.unicode '
3629+
<itemizedlist xmlns="http://docbook.org/ns/docbook">
3630+
<listitem>
3631+
<simpara>
3632+
<literal>" "</literal> (<acronym>Unicode</acronym> U+0020)，普通空格。
3633+
</simpara>
3634+
</listitem>
3635+
<listitem>
3636+
<simpara>
3637+
<literal>"\t"</literal> (<acronym>Unicode</acronym> U+0009)，制表符。
3638+
</simpara>
3639+
</listitem>
3640+
<listitem>
3641+
<simpara>
3642+
<literal>"\n"</literal>（<acronym>Unicode</acronym> U+000A)，新行（换行）。
3643+
</simpara>
3644+
</listitem>
3645+
<listitem>
3646+
<simpara>
3647+
<literal>"\r"</literal>（<acronym>Unicode</acronym> U+000D），回车。
3648+
</simpara>
3649+
</listitem>
3650+
<listitem>
3651+
<simpara>
3652+
<literal>"\0"</literal>（<acronym>Unicode</acronym> U+0000），NUL 字节。
3653+
</simpara>
3654+
</listitem>
3655+
<listitem>
3656+
<simpara>
3657+
<literal>"\v"</literal>（<acronym>Unicode</acronym> U+000B），垂直制表符。
3658+
</simpara>
3659+
</listitem>
3660+
<listitem>
3661+
<simpara>
3662+
<literal>"\f"</literal>（<acronym>Unicode</acronym> U+000C），换页符。
3663+
</simpara>
3664+
</listitem>
3665+
<listitem>
3666+
<simpara>
3667+
<literal>"\u00A0"</literal>（<acronym>Unicode</acronym> U+00A0），NO-BREAK SPACE。
3668+
</simpara>
3669+
</listitem>
3670+
<listitem>
3671+
<simpara>
3672+
<literal>"\u1680"</literal>（<acronym>Unicode</acronym> U+1680），OGHAM SPACE MARK。
3673+
</simpara>
3674+
</listitem>
3675+
<listitem>
3676+
<simpara>
3677+
<literal>"\u2000"</literal>（<acronym>Unicode</acronym> U+2000），EN QUAD。
3678+
</simpara>
3679+
</listitem>
3680+
<listitem>
3681+
<simpara>
3682+
<literal>"\u2001"</literal>（<acronym>Unicode</acronym> U+2001），EM QUAD。
3683+
</simpara>
3684+
</listitem>
3685+
<listitem>
3686+
<simpara>
3687+
<literal>"\u2002"</literal>（<acronym>Unicode</acronym> U+2002），EN SPACE。
3688+
</simpara>
3689+
</listitem>
3690+
<listitem>
3691+
<simpara>
3692+
<literal>"\u2003"</literal>（<acronym>Unicode</acronym> U+2003），EM SPACE。
3693+
</simpara>
3694+
</listitem>
3695+
<listitem>
3696+
<simpara>
3697+
<literal>"\u2004"</literal>（<acronym>Unicode</acronym> U+2004），THREE-PER-EM SPACE。
3698+
</simpara>
3699+
</listitem>
3700+
<listitem>
3701+
<simpara>
3702+
<literal>"\u2005"</literal>（<acronym>Unicode</acronym> U+2005），FOUR-PER-EM SPACE。
3703+
</simpara>
3704+
</listitem>
3705+
<listitem>
3706+
<simpara>
3707+
<literal>"\u2006"</literal>（<acronym>Unicode</acronym> U+2006），SIX-PER-EM SPACE。
3708+
</simpara>
3709+
</listitem>
3710+
<listitem>
3711+
<simpara>
3712+
<literal>"\u2007"</literal>（<acronym>Unicode</acronym> U+2007），FIGURE SPACE。
3713+
</simpara>
3714+
</listitem>
3715+
<listitem>
3716+
<simpara>
3717+
<literal>"\u2008"</literal>（<acronym>Unicode</acronym> U+2008），PUNCTUATION SPACE。
3718+
</simpara>
3719+
</listitem>
3720+
<listitem>
3721+
<simpara>
3722+
<literal>"\u2009"</literal>（<acronym>Unicode</acronym> U+2009），THIN SPACE。
3723+
</simpara>
3724+
</listitem>
3725+
<listitem>
3726+
<simpara>
3727+
<literal>"\u200A"</literal>（<acronym>Unicode</acronym> U+200A），HAIR SPACE。
3728+
</simpara>
3729+
</listitem>
3730+
<listitem>
3731+
<simpara>
3732+
<literal>"\u2028"</literal>（<acronym>Unicode</acronym> U+2028），LINE SEPARATOR。
3733+
</simpara>
3734+
</listitem>
3735+
<listitem>
3736+
<simpara>
3737+
<literal>"\u2029"</literal>（<acronym>Unicode</acronym> U+2029），PARAGRAPH SEPARATOR。
3738+
</simpara>
3739+
</listitem>
3740+
<listitem>
3741+
<simpara>
3742+
<literal>"\u202F"</literal>（<acronym>Unicode</acronym> U+202F），NARROW NO-BREAK SPACE。
3743+
</simpara>
3744+
</listitem>
3745+
<listitem>
3746+
<simpara>
3747+
<literal>"\u205F"</literal>（<acronym>Unicode</acronym> U+205F），MEDIUM MATHEMATICAL SPACE。
3748+
</simpara>
3749+
</listitem>
3750+
<listitem>
3751+
<simpara>
3752+
<literal>"\u3000"</literal>（<acronym>Unicode</acronym> U+3000），IDEOGRAPHIC SPACE。
3753+
</simpara>
3754+
</listitem>
3755+
<listitem>
3756+
<simpara>
3757+
<literal>"\u0085"</literal>（<acronym>Unicode</acronym> U+0085），NEXT LINE (NEL)。
3758+
</simpara>
3759+
</listitem>
3760+
<listitem>
3761+
<simpara>
3762+
<literal>"\u180E"</literal>（<acronym>Unicode</acronym> U+180E），MONGOLIAN VOWEL SEPARATOR。
3763+
</simpara>
3764+
</listitem>
3765+
</itemizedlist>
3766+
'>
3767+
36173768
<!ENTITY strings.parameter.characters.optional '
36183769
<simpara xmlns="http://docbook.org/ns/docbook">
36193770
可选，也可以使用 <parameter>characters</parameter> 参数指定要剥离的字符。
@@ -3622,6 +3773,15 @@ local: {
36223773
</simpara>
36233774
'>
36243775

3776+
3777+
<!ENTITY strings.parameter.unicode.optional '
3778+
<simpara xmlns="http://docbook.org/ns/docbook">
3779+
可选，也可以使用 <parameter>characters</parameter>
3780+
参数指定要删除的字符。只需列出所有需要删除的字符即可。
3781+
</simpara>
3782+
'>
3783+
3784+
36253785
<!ENTITY strings.parameter.encoding '
36263786
<para xmlns="http://docbook.org/ns/docbook">
36273787
An optional argument defining the encoding used when converting characters.
@@ -4328,15 +4488,37 @@ xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
43284488
</varlistentry>'>
43294489

43304490
<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
4331-
如果传递 &null; 或空字符串，处理程序将重置为其默认状态。
4491+
如果传递 &null;，处理程序将重置为其默认状态。
4492+
<warning>
4493+
<simpara>
4494+
空字符串也可以重置处理程序，然而自 PHP 8.4.0 起已弃用。
4495+
</simpara>
4496+
</warning>
43324497
</para>
43334498
<para xmlns="http://docbook.org/ns/docbook">
43344499
如果 <parameter>handler</parameter> 是 <type>callable</type>，设置的 callable 将作为处理程序。
43354500
</para>
43364501
<para xmlns="http://docbook.org/ns/docbook">
43374502
如果 <parameter>handler</parameter> 是 <type>string</type>，它可以是 <function>xml_set_object</function>
43384503
设置的对象的方法名称。
4339-
</para>'>
4504+
<warning>
4505+
<simpara>
4506+
自 PHP 8.4.0 起弃用。
4507+
</simpara>
4508+
</warning>
4509+
</para>
4510+
<warning xmlns="http://docbook.org/ns/docbook">
4511+
<simpara>
4512+
自 PHP 8.4.0 起，在设置处理程序时会检测 callable 是否有效，而不是在调用时检测。这意味着在将字符串方法名设置为
4513+
callback 之前必须调用 <function>xml_set_object</function>。然而，由于此行为自 PHP 8.4.0
4514+
起也已弃用，因此建议为该方法使用适当的<type>callable</type>。
4515+
</simpara>
4516+
</warning>
4517+
'>
4518+
4519+
4520+
4521+
43404522

43414523

43424524

@@ -4349,6 +4531,22 @@ xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
43494531
</listitem>
43504532
</varlistentry>'>
43514533

4534+
<!ENTITY xml.changelog.handler-param '<row xmlns="http://docbook.org/ns/docbook">
4535+
<entry>8.4.0</entry>
4536+
<entry>
4537+
现已弃用传递非 <type>callable</type> 的 <type>string</type> 到 <parameter>handler</parameter>，为方法使用适当的
4538+
callable 或者使用 &null; 来重置处理程序。
4539+
</entry>
4540+
</row>
4541+
<row xmlns="http://docbook.org/ns/docbook">
4542+
<entry>8.4.0</entry>
4543+
<entry>
4544+
现在设置处理程序时会检测 <parameter>handler</parameter> 作为 <type>callable</type>
4545+
的有效性，而不是在调用时检测。
4546+
</entry>
4547+
</row>'>
4548+
4549+
43524550
<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
43534551
<entry>8.0.0</entry>
43544552
<entry>

0 commit comments

Comments
 (0)