FrankenPHP单文件是将Caddy服务器、PHP运行时（8.4+）及应用代码静态链接生成的可执行文件，支持Linux/macOS但不支持Windows原生打包。
能，但必须满足几个硬性前提：应用是纯PHP、不依赖系统级扩展（如 pdo_sqlsrv）、运行环境支持静态链接（Linux/macOS 可行，Windows 不支持原生打包）。
FrankenPHP 的“单文件”到底是什么
它不是把 .php 源码编译成机器码，而是把以下三部分静态链接进一个二进制：
- Caddy Web 服务器（含 HTTP/2、HTTP/3、自动 HTTPS 支持）
- PHP 运行时（8.4+，含 opcache、PDO、curl 等常用扩展）
- 你的应用代码和资源（
public/、vendor/、.env等）
最终产物是像 my-app-linux-x86_64 这样的可执行文件，无需安装 PHP 或 Caddy，直接 ./my-app-linux-x86_64 就能启动服务。
哪些情况会失败或退化为“伪单文件”
常见失败点不是 FrankenPHP 本身的问题，而是应用没清理干净：
立即学习“PHP免费学习笔记（深入）”；
-
composer install --no-dev忘了加--ignore-platform-reqs，导致构建时因平台差异中断 - 项目里还留着
tests/、.git/、node_modules/，静态构建器会把它们一并打包，体积暴涨且可能触发路径错误 - 用了
__DIR__或realpath(__DIR__)动态拼路径的代码——在单文件里，__DIR__指向的是临时解压目录（如/tmp/.frankenphp-xxxx/app），不是原始项目路径 - 配置中硬编码了
/var/www/html这类绝对路径，而 FrankenPHP 默认工作目录是二进制所在位置
Linux 下最稳的构建流程（Docker 方式）
不用折腾本地 Go 环境，用官方 static-builder-gnu 镜像即可：
- 确保项目已准备就绪：
APP_ENV=prod、APP_DEBUG=0、rm -rf tests/ .git/ - 写好
static-build.Dockerfile，核心是这句：RUN EMBED=dist/app/ ./build-static.sh - 构建后用
docker cp提取二进制，别用docker run直接执行——那只是容器内运行，不是真正打包 - 生成的文件默认无后缀，建议手动加
.bin或-linux后缀，避免误点执行
真正容易被忽略的是：FrankenPHP 打包后的二进制**不包含 Windows 兼容层**，也不支持 php.ini 中的 extension=php_sqlsrv.dll 这类 Windows-only 扩展。如果你的应用强依赖 SQL Server 或某些闭源 DLL，这条路走不通，得退回 Docker 容器部署。
