mirror of
https://github.com/php/doc-zh.git
synced 2026-03-23 22:52:08 +01:00
fpm : fix XML by converting para to simpara tags via script
This commit is contained in:
Gina Peter Banyard
@@ -1,18 +1,17 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: fab4ea95f4fe1471be947602d0e9be32fb802265 Maintainer: SzopenXiao Status: ready -->
|
||||
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: SzopenXiao Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
|
||||
<book xml:id="book.fpm" xmlns="http://docbook.org/ns/docbook">
|
||||
<book xmlns="http://docbook.org/ns/docbook" xml:id="book.fpm">
|
||||
<?phpdoc extension-membership="core" ?>
|
||||
<title>FastCGI 进程管理器</title>
|
||||
|
||||
<preface xml:id="intro.fpm">
|
||||
&reftitle.intro;
|
||||
&fpm.intro;
|
||||
<para>
|
||||
<simpara>
|
||||
PHP 内置绑定了此 SAPI。
|
||||
</para>
|
||||
</simpara>
|
||||
</preface>
|
||||
|
||||
&reference.fpm.setup;
|
||||
@@ -20,7 +19,6 @@
|
||||
&reference.fpm.reference;
|
||||
|
||||
</book>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: cbac1ecf71d754707d69bdc344c4031c157eaa54 Maintainer: daijie Status: ready -->
|
||||
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: daijie Status: ready -->
|
||||
<!-- CREDITS: mowangjuanzi -->
|
||||
<refentry xml:id="function.fastcgi-finish-request" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.fastcgi-finish-request">
|
||||
<refnamediv>
|
||||
<refname>fastcgi_finish_request</refname>
|
||||
<refpurpose>冲刷(flush)所有响应的数据给客户端</refpurpose>
|
||||
@@ -12,11 +12,11 @@
|
||||
&reftitle.description;
|
||||
<methodsynopsis>
|
||||
<type>bool</type><methodname>fastcgi_finish_request</methodname>
|
||||
<void />
|
||||
<void/>
|
||||
</methodsynopsis>
|
||||
<para>
|
||||
<simpara>
|
||||
此函数冲刷(flush)所有响应的数据给客户端并结束请求。这允许在不打开与客户端之间的连接的情况下执行耗时任务。
|
||||
</para>
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
@@ -26,12 +26,11 @@
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<para>
|
||||
<simpara>
|
||||
&return.success;
|
||||
</para>
|
||||
</simpara>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 5764345c8662c22b570bf453650a9dd584bd3abb Maintainer: mowangjuanzi Status: ready -->
|
||||
<refentry xml:id="function.fpm-get-status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: mowangjuanzi Status: ready -->
|
||||
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.fpm-get-status">
|
||||
<refnamediv>
|
||||
<refname>fpm_get_status</refname>
|
||||
<refpurpose>返回当前 FPM 池状态</refpurpose>
|
||||
@@ -13,13 +13,13 @@
|
||||
<type class="union"><type>array</type><type>false</type></type><methodname>fpm_get_status</methodname>
|
||||
<void/>
|
||||
</methodsynopsis>
|
||||
<para>
|
||||
<simpara>
|
||||
此函数将返回关联数组，包含当前完整 FPM 池状态。它始终返回完整状态，包含每个进程的状态信息。参阅
|
||||
<link linkend="fpm.status">FPM 状态页面教程</link>获取有关详细信息。
|
||||
</para>
|
||||
<para>
|
||||
</simpara>
|
||||
<simpara>
|
||||
注意如果 FPM 用于服务脚本时才会定义此函数。
|
||||
</para>
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
@@ -29,12 +29,12 @@
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<para>
|
||||
<simpara>
|
||||
包含完整 FPM 池状态的关联数组，&return.falseforfailure;。
|
||||
</para>
|
||||
</simpara>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
<!-- Keep this comment at the end of the file
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:t
|
||||
|
||||
@@ -1,18 +1,16 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: b2e83b46c6aa7f8278e80d3c0e8a049b7583f6cc Maintainer: SzopenXiao Status: ready -->
|
||||
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: SzopenXiao Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
|
||||
<chapter xml:id="fpm.setup">
|
||||
&reftitle.setup;
|
||||
|
||||
<para>
|
||||
<simpara>
|
||||
安装与配置 FPM 的信息可以在 PHP 手册的
|
||||
<link linkend="install.fpm">installation and configuration section</link>中被找到。
|
||||
</para>
|
||||
</simpara>
|
||||
|
||||
</chapter>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
|
||||
@@ -1,32 +1,32 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: a4429100780d1d0d6ce204c11ad223f6526990ab Maintainer: mowangjuanzi Status: ready -->
|
||||
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: mowangjuanzi Status: ready -->
|
||||
<!-- CREDITS: Luffy -->
|
||||
<sect1 xml:id="fpm.status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<sect1 xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="fpm.status">
|
||||
<title>状态页面</title>
|
||||
|
||||
<para>
|
||||
|
||||
<simpara>
|
||||
此页面提供 FPM 状态页面的设置和内容的相关信息。请参见 <function>fpm_get_status</function>。
|
||||
</para>
|
||||
</simpara>
|
||||
|
||||
<sect2 xml:id="fpm.status.configuration">
|
||||
<title>配置</title>
|
||||
|
||||
<para>
|
||||
|
||||
<simpara>
|
||||
可以在 FPM poll 配置中设置 <link linkend="pm.status-path">pm.status_path</link>
|
||||
配置参数来启用 FPM 状态页面。
|
||||
</para>
|
||||
</simpara>
|
||||
|
||||
<caution>
|
||||
<para>
|
||||
<simpara>
|
||||
为了安全，FPM 状态页面应仅限于内部请求或已知客户端 IP，因为该页面会显示请求 URL 和可用资源的有关信息。
|
||||
</para>
|
||||
</simpara>
|
||||
</caution>
|
||||
|
||||
<para>
|
||||
|
||||
<simpara>
|
||||
取决于 Web 服务器配置，可能需要配置 Web 服务器允许绕过任何 PHP 脚本，直接请求该路径。Apache 在 UDS 上监听 FPM
|
||||
并且 <literal>pm.status_path</literal> 设置为 <literal>/fpm-status</literal> 的配置示例看起来就像是这样：
|
||||
</para>
|
||||
</simpara>
|
||||
|
||||
<informalexample>
|
||||
<programlisting role="apache-conf">
|
||||
@@ -40,18 +40,18 @@
|
||||
</programlisting>
|
||||
</informalexample>
|
||||
|
||||
<para>
|
||||
<simpara>
|
||||
重载/重启 FPM 和 Web 服务器后，可以从浏览器访问状态页面（如果配置了 IP 限制，请求只能来自允许的 IP）。
|
||||
</para>
|
||||
</simpara>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="fpm.status.parameters">
|
||||
<title>查询参数</title>
|
||||
|
||||
<para>
|
||||
<simpara>
|
||||
可以指定以下某一查询参数来更改状态页面输出的格式：
|
||||
</para>
|
||||
|
||||
</simpara>
|
||||
|
||||
<simplelist>
|
||||
<member><literal>html</literal></member>
|
||||
<member><literal>json</literal></member>
|
||||
@@ -59,14 +59,14 @@
|
||||
<member><literal>xml</literal></member>
|
||||
</simplelist>
|
||||
|
||||
<para>
|
||||
<simpara>
|
||||
也可以使用 <literal>full</literal> 查询参数返回附加信息。
|
||||
</para>
|
||||
|
||||
<para>
|
||||
</simpara>
|
||||
|
||||
<simpara>
|
||||
状态页面 URL 示例：
|
||||
</para>
|
||||
|
||||
</simpara>
|
||||
|
||||
<simplelist>
|
||||
<member>
|
||||
<literal>https://localhost/fpm-status</literal>
|
||||
@@ -86,15 +86,15 @@
|
||||
</member>
|
||||
</simplelist>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 xml:id="fpm.status.contents">
|
||||
<title>显示信息</title>
|
||||
|
||||
<para>
|
||||
<simpara>
|
||||
日期/时间值在 JSON/XML 输出中使用 unix 时间戳格式，否则将生成以下示例日期
|
||||
<literal>"03/Jun/2021:07:21:46 +0100"</literal>。
|
||||
</para>
|
||||
|
||||
</simpara>
|
||||
|
||||
<table>
|
||||
<title>基础信息——始终在状态页面显示</title>
|
||||
<tgroup cols="2">
|
||||
@@ -251,15 +251,15 @@
|
||||
</table>
|
||||
|
||||
<note>
|
||||
<para>
|
||||
<simpara>
|
||||
当 FPM 重启时，重置所有池指定的值。
|
||||
</para>
|
||||
</simpara>
|
||||
</note>
|
||||
|
||||
<note>
|
||||
<para>
|
||||
<simpara>
|
||||
openMetrics 格式输出使用不同的参数类型以便更好的适应 OpenMetrics 格式。参数和值的说明包含在 OpenMetrics 格式输出中。
|
||||
</para>
|
||||
</simpara>
|
||||
</note>
|
||||
</sect2>
|
||||
|
||||
@@ -283,8 +283,7 @@
|
||||
</informaltable>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:t
|
||||
|
||||
Reference in New Issue
Block a user