已知问题

Fibers

在 Fibers 中调用 PHP 的函数和代码等语言结构，这些结构内部再调用 cgo 会导致崩溃。

这个问题 正在由 Go 项目处理。

一种解决方案是不要使用从 Fibers 内部委托给 Go 的构造（如 echo）和函数（如 header()）。

下面的代码可能会崩溃，因为它在 Fiber 中使用了 echo：

  1. $fiber = new Fiber(function() {
  2.     echo 'In the Fiber'.PHP_EOL;
  3.     echo 'Still inside'.PHP_EOL;
  4. });
  5. $fiber->start();

相反，请从 Fiber 返回值并在外部使用它：

  1. $fiber = new Fiber(function() {
  2.     Fiber::suspend('In the Fiber'.PHP_EOL));
  3.     Fiber::suspend('Still inside'.PHP_EOL));
  4. });
  5. echo $fiber->start();
  6. echo $fiber->resume();
  7. $fiber->resume();

不支持的 PHP 扩展

已知以下扩展与 FrankenPHP 不兼容：

名称原因替代方案
imap非线程安全javanile/php-imap2, webklex/php-imap

get_browser

get_browser() 函数在一段时间后似乎表现不佳。解决方法是缓存（例如使用 APCu）每个 User-Agent，因为它们是不变的。

独立的二进制和基于 Alpine 的 Docker 镜像

独立的二进制文件和基于 Alpine 的 docker 镜像 (dunglas/frankenphp:*-alpine) 使用的是 musl libc 而不是 glibc and friends，为的是保持较小的二进制大小。 这可能会导致一些兼容性问题。特别是，glob 标志 GLOB_BRACE 不可用。

在 Docker 中使用 https://127.0.0.1

默认情况下，FrankenPHP 会为 localhost 生成一个 TLS 证书。 这是本地开发最简单且推荐的选项。

如果确实想使用 127.0.0.1 作为主机，可以通过将服务器名称设置为 127.0.0.1 来配置它以为其生成证书。

如果你使用 Docker，因为 Docker 网络 问题，只做这些是不够的。 您将收到类似于以下内容的 TLS 错误 curl: (35) LibreSSL/3.3.6: error:1404B438:SSL routines:ST_CONNECT:tlsv1 alert internal error。

如果你使用的是 Linux，解决方案是使用 使用宿主机网络：

  1. docker run \
  2.     -e SERVER_NAME="127.0.0.1" \
  3.     -v $PWD:/app/public \
  4.     --network host \
  5.     dunglas/frankenphp

Mac 和 Windows 不支持 Docker 使用宿主机网络。在这些平台上，您必须猜测容器的 IP 地址并将其包含在服务器名称中。

运行 docker network inspect bridge 并查看 Containers，找到 IPv4Address 当前分配的最后一个 IP 地址，并增加 1。如果没有容器正在运行，则第一个分配的 IP 地址通常为 172.17.0.2。

然后将其包含在 SERVER_NAME 环境变量中：

  1. docker run \
  2.     -e SERVER_NAME="127.0.0.1, 172.17.0.3" \
  3.     -v $PWD:/app/public \
  4.     -p 80:80 -p 443:443 -p 443:443/udp \
  5.     dunglas/frankenphp

已知问题 - 图1Caution

请务必将 172.17.0.3 替换为将分配给容器的 IP。

您现在应该能够从主机访问 https://127.0.0.1。

如果不是这种情况，请在调试模式下启动 FrankenPHP 以尝试找出问题：

  1. docker run \
  2.     -e CADDY_GLOBAL_OPTIONS="debug" \
  3.     -e SERVER_NAME="127.0.0.1" \
  4.     -v $PWD:/app/public \
  5.     -p 80:80 -p 443:443 -p 443:443/udp \
  6.     dunglas/frankenphp