FastCGI 进程管理器

## 简介
FPM（FastCGI 进程管理器）是 PHP FastCGI 的主要实现，包含大部分对高负载网站有用的功能。

PHP 内置绑定了此 SAPI。

## 安装/配置

安装与配置 FPM 的信息可以在 PHP 手册的 [installation and configuration section](https://www.php.net/manual/zh/install.fpm.php "installation and configuration section") 中被找到。

## 可观察性

#### 状态页面
此页面提供 FPM 状态页面的设置和内容的相关信息。请参见 [fpm_get_status()](http://www.bixiaguangnian.com/manual/phpfunction/2390.html "fpm_get_status()")。

#### 配置
可以在 FPM poll 配置中设置 [pm.status_path](https://www.php.net/manual/zh/install.fpm.configuration.php#pm.status-path "pm.status_path") 配置参数来启用 FPM 状态页面。

> 警告
为了安全，FPM 状态页面应仅限于内部请求或已知客户端 IP，因为该页面会显示请求 URL 和可用资源的有关信息。

取决于 Web 服务器配置，可能需要配置 Web 服务器允许绕过任何 PHP 脚本，直接请求该路径。Apache 在 UDS 上监听 FPM 并且 pm.status_path 设置为 /fpm-status 的配置示例看起来就像是这样：

```
<LocationMatch "/fpm-status">
 Order Allow,Deny
 Allow from 127.0.0.1
 ProxyPass "unix:/var/run/php-fpm.sock|fcgi://localhost/fpm-status"
</LocationMatch>
```

重载/重启 FPM 和 Web 服务器后，可以从浏览器访问状态页面（如果配置了 IP 限制，请求只能来自允许的 IP）。

#### 查询参数
可以指定以下某一查询参数来更改状态页面输出的格式：

- html
- json
- openmetrics
- xml

也可以使用 full 查询参数返回附加信息。

状态页面 URL 示例：

- https://localhost/fpm-status ——默认文本格式的简短输出
- https://localhost/fpm-status?full ——默认文本格式的完整输出
- https://localhost/fpm-status?json ——JSON 格式的简短输出
- https://localhost/fpm-status?html&full ——HTML 格式的完整输出

#### 显示信息
日期/时间值在 JSON/XML 输出中使用 unix 时间戳格式，否则将生成以下示例日期 "03/Jun/2021:07:21:46 +0100"。

基础信息——始终在状态页面显示

| 参数                   | 说明                                                 |
|----------------------|----------------------------------------------------|
| pool                 | FPM 进程池的名称。                                        |
| proccess manager     | 进程管理器类型——static、dynamic 或 ondemand。                |
| start time           | 进程池最后一次启动的日期/时间。                                   |
| start since          | 进程自启动以来的秒数。                                        |
| accepted conn        | 服务的请求总数                                            |
| listen queue         | 当前等待空闲进程的请求（backlog）总数。                            |
| max listen queue     | 监听队列在任一时间看到的最大请求数。                                 |
| listen queue len     | 监听队列的最大允许数量。                                       |
| idle processes       | 当前空闲（等待请求）的进程数。                                    |
| active processes     | 当前正在处理请求的进程数。                                      |
| total processes      | 当前进程总数。                                            |
| max active processes | 并发活动进程的最大数量。                                       |
| max children reached | 是否达到了最大进程数？如果是，则值显示为 1，否则为 0。|
| slow requests        | 达到配置 request_slowlog_timeout 的请求总数。|

每个进程的信息——仅在 full 输出模式中显示

| 参数                  | 说明    |
|---------------------|----------|
| pid                 | 进程的系统 PID。                                                                                                                             |
| state               | 进程状态——空闲、运行……                                                                                                                          |
| start time          | 进程开始的日期/时间。                                                                                                                            |
| start since         | 进程自启动以来的秒数。                                                                                                                            |
| requests            | 最大服务请求数。                                                                                                                               |
| request duration    | 最后一次服务请求所花费的总时间（以微秒为单位）。                                                                                                               |
| request method      | 最后服务请求的 HTTP 方法。                                                                                                                       |
| request uri         | 最后服务请求的 URI（在 Web 服务器处理后，如果使用前端控制器模式重定向，将始终是 /index.php）。|
| content length      | 最后一个请求的请求正文长度，以字节为单位。                                                                                                                  |
| user                | 最后一个请求的 HTTP 用户（PHP_AUTH_USER）。                                                                                                        |
| script              | 最后一个请求执行的执行脚本的完整路径。如果不适用（比如状态页面请求），将是 '-'。|
| last request cpu    | 最后一个请求的 %cpu。如果进程不空闲，将为 0，因为计算是在请求处理完成时计算的。该值可以超过 100%，因为指标将告诉最后一个请求使用了总 cpu 时间的百分比——考虑所有内核上的进程，而 100% 仅适用于一个内核。|
| last request memory | 最后一个请求消耗的最大内存量。如果进程不空闲，将为 0，因为进程是在请求处理完成时进行计算的。|

> 注意:
当 FPM 重启时，重置所有池指定的值。

> 注意:
openMetrics 格式输出使用不同的参数类型以便更好的适应 OpenMetrics 格式。参数和值的说明包含在 OpenMetrics 格式输出中。

#### 更新日志
| 版本    | 说明                 |
|-------|--------------------|
| 8.1.0 | 新增 openmetrics 格式。 |