mirror of
https://github.com/php/frankenphp.git
synced 2026-03-24 17:12:10 +01:00
158 lines
6.7 KiB
Markdown
158 lines
6.7 KiB
Markdown
# 性能
|
||
|
||
默认情况下，FrankenPHP 尝试在性能和易用性之间提供良好的折衷。
|
||
但是，通过使用适当的配置，可以大幅提高性能。
|
||
|
||
## 线程和 Worker 数量
|
||
|
||
默认情况下，FrankenPHP 启动的线程和 worker（在 worker 模式下）数量是可用 CPU 数量的 2 倍。
|
||
|
||
适当的值很大程度上取决于你的应用程序是如何编写的、它做什么以及你的硬件。
|
||
我们强烈建议更改这些值。为了获得最佳的系统稳定性，建议 `num_threads` x `memory_limit` < `available_memory`。
|
||
|
||
要找到正确的值，最好运行模拟真实流量的负载测试。
|
||
[k6](https://k6.io) 和 [Gatling](https://gatling.io) 是很好的工具。
|
||
|
||
要配置线程数，请使用 `php_server` 和 `php` 指令的 `num_threads` 选项。
|
||
要更改 worker 数量，请使用 `frankenphp` 指令的 `worker` 部分的 `num` 选项。
|
||
|
||
### `max_threads`
|
||
|
||
虽然准确了解你的流量情况总是更好，但现实应用往往更加
|
||
不可预测。`max_threads` [配置](config.md#caddyfile-config) 允许 FrankenPHP 在运行时自动生成额外线程，直到指定的限制。
|
||
`max_threads` 可以帮助你确定需要多少线程来处理你的流量，并可以使服务器对延迟峰值更具弹性。
|
||
如果设置为 `auto`，限制将基于你的 `php.ini` 中的 `memory_limit` 进行估算。如果无法这样做，
|
||
`auto` 将默认为 2x `num_threads`。请记住，`auto` 可能会严重低估所需的线程数。
|
||
`max_threads` 类似于 PHP FPM 的 [pm.max_children](https://www.php.net/manual/en/install.fpm.configuration.php#pm.max-children)。主要区别是 FrankenPHP 使用线程而不是
|
||
进程，并根据需要自动在不同的 worker 脚本和"经典模式"之间委派它们。
|
||
|
||
## Worker 模式
|
||
|
||
启用 [worker 模式](worker.md) 大大提高了性能，
|
||
但你的应用必须适配以兼容此模式：
|
||
你需要创建一个 worker 脚本并确保应用不会泄漏内存。
|
||
|
||
## 不要使用 musl
|
||
|
||
官方 Docker 镜像的 Alpine Linux 变体和我们提供的默认二进制文件使用 [musl libc](https://musl.libc.org)。
|
||
|
||
众所周知，当使用这个替代 C 库而不是传统的 GNU 库时，PHP [更慢](https://gitlab.alpinelinux.org/alpine/aports/-/issues/14381)，
|
||
特别是在以 ZTS 模式（线程安全）编译时，这是 FrankenPHP 所必需的。在大量线程环境中，差异可能很显著。
|
||
|
||
另外，[一些错误只在使用 musl 时发生](https://github.com/php/php-src/issues?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen+label%3ABug+musl)。
|
||
|
||
在生产环境中，我们建议使用链接到 glibc 的 FrankenPHP。
|
||
|
||
这可以通过使用 Debian Docker 镜像（默认）、从我们的 [Releases](https://github.com/php/frankenphp/releases) 下载 -gnu 后缀二进制文件，或通过[从源代码编译 FrankenPHP](compile.md) 来实现。
|
||
|
||
或者，我们提供使用 [mimalloc 分配器](https://github.com/microsoft/mimalloc) 编译的静态 musl 二进制文件，这缓解了线程场景中的问题。
|
||
|
||
## Go 运行时配置
|
||
|
||
FrankenPHP 是用 Go 编写的。
|
||
|
||
一般来说，Go 运行时不需要任何特殊配置，但在某些情况下，
|
||
特定的配置可以提高性能。
|
||
|
||
你可能想要将 `GODEBUG` 环境变量设置为 `cgocheck=0`（FrankenPHP Docker 镜像中的默认值）。
|
||
|
||
如果你在容器（Docker、Kubernetes、LXC...）中运行 FrankenPHP 并限制容器的可用内存，
|
||
请将 `GOMEMLIMIT` 环境变量设置为可用内存量。
|
||
|
||
有关更多详细信息，[专门针对此主题的 Go 文档页面](https://pkg.go.dev/runtime#hdr-Environment_Variables) 是充分利用运行时的必读内容。
|
||
|
||
## `file_server`
|
||
|
||
默认情况下，`php_server` 指令自动设置文件服务器来
|
||
提供存储在根目录中的静态文件（资产）。
|
||
|
||
此功能很方便，但有成本。
|
||
要禁用它，请使用以下配置：
|
||
|
||
```caddyfile
|
||
php_server {
|
||
file_server off
|
||
}
|
||
```
|
||
|
||
## `try_files`
|
||
|
||
除了静态文件和 PHP 文件外，`php_server` 还会尝试提供你应用程序的索引
|
||
和目录索引文件（`/path/` -> `/path/index.php`）。如果你不需要目录索引，
|
||
你可以通过明确定义 `try_files` 来禁用它们，如下所示：
|
||
|
||
```caddyfile
|
||
php_server {
|
||
try_files {path} index.php
|
||
root /root/to/your/app # 在这里明确添加根目录允许更好的缓存
|
||
}
|
||
```
|
||
|
||
这可以显著减少不必要的文件操作数量。
|
||
|
||
另一种具有 0 个不必要文件系统操作的方法是改用 `php` 指令并按路径将
|
||
文件与 PHP 分开。如果你的整个应用程序由一个入口文件提供服务，这种方法效果很好。
|
||
一个在 `/assets` 文件夹后面提供静态文件的示例[配置](config.md#caddyfile-config)可能如下所示：
|
||
|
||
```caddyfile
|
||
route {
|
||
@assets {
|
||
path /assets/*
|
||
}
|
||
|
||
# /assets 后面的所有内容都由文件服务器处理
|
||
file_server @assets {
|
||
root /root/to/your/app
|
||
}
|
||
|
||
# 不在 /assets 中的所有内容都由你的索引或 worker PHP 文件处理
|
||
rewrite index.php
|
||
php {
|
||
root /root/to/your/app # 在这里明确添加根目录允许更好的缓存
|
||
}
|
||
}
|
||
```
|
||
|
||
## 占位符
|
||
|
||
你可以在 `root` 和 `env` 指令中使用[占位符](https://caddyserver.com/docs/conventions#placeholders)。
|
||
但是，这会阻止缓存这些值，并带来显著的性能成本。
|
||
|
||
如果可能，请避免在这些指令中使用占位符。
|
||
|
||
## `resolve_root_symlink`
|
||
|
||
默认情况下，如果文档根目录是符号链接，FrankenPHP 会自动解析它（这对于 PHP 正常工作是必要的）。
|
||
如果文档根目录不是符号链接，你可以禁用此功能。
|
||
|
||
```caddyfile
|
||
php_server {
|
||
resolve_root_symlink false
|
||
}
|
||
```
|
||
|
||
如果 `root` 指令包含[占位符](https://caddyserver.com/docs/conventions#placeholders)，这将提高性能。
|
||
在其他情况下，收益将可以忽略不计。
|
||
|
||
## 日志
|
||
|
||
日志显然非常有用，但根据定义，
|
||
它需要 I/O 操作和内存分配，这会大大降低性能。
|
||
确保你[正确设置日志级别](https://caddyserver.com/docs/caddyfile/options#log)，
|
||
并且只记录必要的内容。
|
||
|
||
## PHP 性能
|
||
|
||
FrankenPHP 使用官方 PHP 解释器。
|
||
所有常见的 PHP 相关性能优化都适用于 FrankenPHP。
|
||
|
||
特别是：
|
||
|
||
- 检查 [OPcache](https://www.php.net/manual/zh/book.opcache.php) 是否已安装、启用并正确配置
|
||
- 启用 [Composer 自动加载器优化](https://getcomposer.org/doc/articles/autoloader-optimization.md)
|
||
- 确保 `realpath` 缓存对于你的应用程序需求足够大
|
||
- 使用[预加载](https://www.php.net/manual/zh/opcache.preloading.php)
|
||
|
||
有关更多详细信息，请阅读[专门的 Symfony 文档条目](https://symfony.com/doc/current/performance.html)
|
||
（即使你不使用 Symfony，大多数提示也很有用）。
|