frankenphp静态二进制默认基于nts php构建，不支持zts扩展；确认方法为php -i | grep "thread safety"显示disabled，且zts扩展无法加载或导致崩溃；可行方案是选用nts扩展或自行构建zts版二进制。
FrankenPHP静态二进制不支持ZTS扩展
FrankenPHP官方提供的预编译静态二进制（如 frankenphp_1.2.0_linux_amd64）**默认构建于非ZTS（Zend Thread Safety disabled）的PHP上**，因此无法加载任何标记为ZTS-only的扩展（如某些老版本pdo_sqlite、xcache或手动编译的ZTS专属.so）。这不是配置问题，而是ABI不兼容——ZTS扩展依赖线程局部存储（TLS）和额外的Zend executor结构体字段，而静态二进制链接的是NTS版libphp，调用时会直接崩溃或静默失败。
如何确认你的扩展是ZTS-only
运行 php -i | grep "Thread Safety"：若输出 disabled，说明当前PHP环境为NTS；此时若尝试 extension=xxx.so 加载一个编译时带 --enable-zts 的扩展，php -m 不会报错但该扩展不会出现在列表中，且 get_loaded_extensions() 也查不到。
- 检查扩展文件本身：
file /path/to/xxx.so—— 若含libpthread.so或显示with thread-local storage，大概率是ZTS构建 - 查看扩展编译日志或源码中的
PHP_ZTS宏是否被定义 - 用
readelf -d /path/to/xxx.so | grep NEEDED搜libpthread或libzts
替代方案：要么换扩展，要么自己构建
你没法让静态二进制“加载”ZTS扩展，但有两条实际可行路径：
- 找NTS版本扩展：多数主流扩展（
mysqli、curl、opcache、zip）都提供NTS构建；Docker镜像dunglas/frankenphp:static-builder-gnu自带install-php-extensions脚本，它默认安装NTS扩展 - 放弃静态二进制，改用动态构建：克隆
frankenphp仓库，修改.github/workflows/build.yml中的 PHP 构建参数，加入--enable-zts，再用make build-static生成带ZTS的定制二进制（注意：Go runtime与ZTS PHP共存需额外验证goroutine调度稳定性）
最容易被忽略的兼容性陷阱
即使你绕过构建环节、硬把ZTS扩展塞进 extension_dir，FrankenPHP启动时也不会报错，但首次调用该扩展的PHP函数时，极大概率触发 segmentation fault (core dumped) 或 PHP 进程卡死——因为ZTS扩展内部假设每个线程都有独立的 tsrm_ls，而FrankenPHP的Goroutine并非OS线程，不满足这个前提。这个问题在开发期难复现，上线后偶发崩溃才暴露，排查成本极高。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
