frankenphp不支持php扩展动态加载，所有扩展须编译时静态链接；不读取php.ini，仅通过环境变量或caddyfile配置；worker模式下shutdown函数行为异常；https续期失败常无提示；不支持zts扩展。
FrankenPHP目前不支持 PHP 扩展的动态加载，所有需用的扩展必须在编译时静态链接进二进制，否则 extension= 配置会静默失败。
为什么 php.ini 里的扩展不生效
FrankenPHP 不读取传统 PHP 的 php.ini 文件，也不运行 php-fpm.conf。它只认自己内置的配置机制——通过环境变量或 Caddyfile 中的 php 指令块控制运行时行为。你写的 extension=redis.so 放在任何 .ini 文件里都不会被加载。
- 所有扩展（如
redis、memcached、grpc）必须在构建 FrankenPHP 二进制时就指定启用，例如使用--with-redis参数 - 官方预编译版只包含常用扩展（
curl、json、mbstring、opcache），pdo_mysql和pgsql默认开启，但sqlsrv、oci8等需自行编译 - 若运行时报错
Class 'Redis' not found或Call to undefined function pg_connect()，第一反应不是检查扩展路径，而是确认当前二进制是否带该扩展
$_SERVER['REQUEST_URI'] 和重写规则不一致的问题
FrankenPHP 内置的路由由 Caddy 驱动，而 Caddy 的重写发生在 PHP 执行前，所以 $_SERVER['REQUEST_URI'] 值是重写后的结果，不是原始请求路径。这对依赖原始 URI 做路由判断的框架（如旧版 Laravel 8 或自定义微框架）会造成匹配失败。
- 不要依赖
$_SERVER['REQUEST_URI']还原原始请求；改用$_SERVER['HTTP_X_ORIGINAL_URI']（Caddy 自动注入） - 在 Caddyfile 中显式传递原始路径：
header X-Original-URI {http.request.uri} - 若用 Laravel，确保
APP_URL与 Caddy 监听地址一致，且禁用TrustedProxy中对X-Forwarded-*的过度信任，避免 HTTPS 混淆
Worker 模式下 register_shutdown_function() 行为异常
FrankenPHP 的 Worker 模式让 PHP 进程常驻，但 register_shutdown_function() 的触发时机与 FPM 有本质差异：它不再随每次请求结束调用，而是在整个 Worker 进程退出时才执行——这通常只发生在服务重启或崩溃时。
- 别把清理临时文件、释放连接、记录日志等请求级逻辑塞进
register_shutdown_function() - 改用中间件、控制器析构、或
fastcgi_finish_request()后异步处理（需搭配pcntl_fork或外部队列） - 若必须保活某些资源（如 Redis 连接池），应主动管理生命周期，在请求入口复用已有连接，而非依赖 shutdown 回调关闭
HTTPS 自动续期失败却无明确错误提示
FrankenPHP 基于 Caddy 的自动化证书管理很安静——成功时不输出，失败时也往往只记在后台日志，不会中断启动或返回 HTTP 错误。
- 首次启动后务必检查
journalctl -u frankenphp -n 100或日志文件（默认/var/log/frankenphp.log），搜索acme、tls、renew - 若域名解析未指向当前服务器、或 80/443 端口被占用，Caddy 会静默跳过申请，继续以 HTTP 启动，导致你以为“HTTPS 开了”实际没开
- 生产环境建议显式配置
tls internal用于测试，或用tls your@email.com强制触发 ACME 流程，避免漏掉失败信号
最易被忽略的是扩展兼容性边界：FrankenPHP 当前（2026.10）仍不支持 ZTS（Zend Thread Safety）模式，所有扩展必须是非线程安全版本；哪怕你用的是 PHP 8.5.11 编译，只要扩展启用了 ZTS，就会在加载时直接 abort。这点在迁移旧项目时尤其致命。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
