frankenphp打包失败是因为.dockerignore排除vendor导致构建上下文缺失该目录，使copy指令无法复制依赖，引发class not found或autoload.php缺失等运行时错误；需通过日志检查、临时注释规则及显式放行!vendor/来修复。
为什么 .dockerignore 排除 vendor 会让 FrankenPHP 打包失败
FrankenPHP 的构建逻辑依赖运行时存在完整的 PHP 依赖树，尤其是 vendor 目录里的 autoload、扩展绑定和配置文件。如果 .dockerignore 把它排除了，Docker 构建上下文里压根没有这个目录 —— 那么 COPY ./ /app/ 或类似指令复制进去的就是个空 vendor，或者直接缺失。结果就是：启动时报 Class not found、require(): failed to open stream，甚至 FrankenPHP 进程直接退出，日志里只有一行 exit status 1。
确认 vendor 是否真被排除了的三步检查法
别猜，直接验证上下文里有没有 vendor：
- 在项目根目录执行
docker build --no-cache --progress=plain . | grep -i "vendor"，看构建日志是否出现Skipping excluded path: vendor或类似提示 - 临时注释掉
.dockerignore中所有含vendor的行（包括通配符如**/vendor），再构建一次，观察是否通过 - 用
docker buildx bake --print（若用 bake）或手动运行tar -cf - . | tar -t | grep '^vendor'模拟上下文打包，确认vendor/是否出现在列表中
FrankenPHP 场景下 .dockerignore 的安全写法
你不需要删掉整个 .dockerignore，只需避免误伤 vendor。注意这些细节：
-
vendor/和/vendor不等价：/vendor只匹配项目根下的vendor，而vendor/会匹配所有子路径下的同名目录（比如tests/fixtures/vendor）—— 但 FrankenPHP 只需要根目录那个 - 不要写
**/vendor，它会递归排除所有嵌套vendor，包括你主项目的 - 推荐显式放行：在
.dockerignore开头加一行!vendor/，再在后面排除其他冗余项（如node_modules、.git），因为!规则优先级高于前面的排除规则 - 如果你用 Composer 安装到非标准位置（比如
lib/vendor），那对应放行行得写成!lib/vendor/
构建后快速验证 vendor 是否就位
镜像构建完别急着 run，先 inspect 一下内容：
- 启动容器并挂载交互终端：
docker run -it --rm your-frankenphp-image sh - 进容器后执行：
ls -la /app/vendor（假设应用复制到了/app）—— 应该能看到autoload.php和大量包目录 - 进一步验证自动加载是否可用：
php -r "require 'vendor/autoload.php'; echo class_exists('FrankenPHP\FrankenPHP') ? 'OK' : 'FAIL';" - 如果报错
failed to open stream: No such file or directory，说明vendor/autoload.php根本没复制进去，问题一定出在上下文或COPY指令顺序上
最常被忽略的一点：FrankenPHP 的 Dockerfile 里如果用了多阶段构建，vendor 必须在 builder 阶段生成，并显式 COPY --from=builder /app/vendor /app/vendor 到最终镜像 —— 单纯靠本地 vendor 复制，在 CI 环境或 clean 构建机上根本不存在。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
