frankenphp默认在当前工作目录查找caddyfile，必须cd到含该文件的目录再执行./frankenphp；不支持--config参数，正确为-config；php.ini则硬编码不可运行时替换。
frankenphp 独立二进制不支持将 Caddyfile 内置（编译进）二进制中——它只在运行时加载，不是资源文件也不是 embed 包。想让它“看起来像内置”，只能靠启动前的路径约定或参数控制。
Caddyfile 必须放在哪里才能被自动加载？
frankenphp 启动时默认查找当前工作目录下的 Caddyfile，没有其他 fallback 路径。这意味着：
- 启动命令必须在含
Caddyfile的目录下执行，例如：cd /myapp && ./frankenphp
- 不能靠
./frankenphp --config ./conf/Caddyfile这类写法绕过（该参数不存在）；正确参数是-config，不是--config - 如果你打包成单文件分发，得确保用户解压后进入该目录再运行，或者用 wrapper 脚本自动
cd
常见错误现象：
直接执行 ./frankenphp 报错 no Caddyfile found，但 ls 明明看到文件——大概率是没在正确目录下启动，或文件名大小写不对（Caddyfile 不是 caddyfile）
怎么让 Caddyfile “随应用一起分发”而不依赖用户手动放？
有三种可靠方式，按推荐度排序：
- 把
Caddyfile和frankenphp放在同一目录，压缩为myapp.zip或myapp.tar.gz，文档里明确写：“解压后进入目录，运行./frankenphp” - 启动脚本中用
-config参数显式指定路径，例如：./frankenphp -config ./Caddyfile
注意：路径必须是相对或绝对有效路径，不能是嵌入资源路径 - 在 Docker 场景中，用
COPY Caddyfile /app/Caddyfile+WORKDIR /app，这是最稳的“伪内置”做法
不要尝试：
- 把
Caddyfile写进 Go 的embed.FS然后 runtime 写出——frankenphp不读内存 FS - 修改源码重新编译二进制来硬编码内容——官方静态二进制不开放此构建逻辑
php.ini 能不能一起“内置”？
不能。php.ini 是编译时硬编码进二进制的，路径类似 /usr/local/lib/php.ini，运行时无法用 -c 或环境变量替换。如果你需要自定义配置（比如 memory_limit、opcache.enable），只能：
- 编译自己的 FrankenPHP（需 Go + PHP 源码环境，复杂度高）
- 接受默认值，或通过 PHP 代码内
ini_set()动态覆盖部分可修改项 - 改用 Docker 镜像 +
php.ini挂载（仅限容器场景）
这点和 Caddyfile 的运行时加载机制完全不同，容易混淆。
真正需要关注的其实是路径对齐问题：Caddyfile 里的 root、try_files、php_server 路径必须和实际项目结构一致，否则 404 或 500 不报具体原因——它不会告诉你“找不到 index.php”，只会静默失败。建议首次部署时加一句 echo "Caddyfile loaded" 到日志开头，确认配置确实生效了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
