macOS上FrankenPHPv1.2.1怎么部署静态资源-php教程-PHP中文网

在 macos 上用 frankenphp v1.2.1 部署静态资源需通过 caddyfile 的 embed public/ 指令将 public/ 下文件嵌入二进制，否则运行时仍读磁盘导致 404；须确保版本正确、路径为相对无尾斜杠、清理冗余文件、设为生产环境后执行 frankenphp build。

macos上frankenphpv1.2.1怎么部署静态资源

在 macOS 上用 FrankenPHP v1.2.1 部署静态资源，核心是让 Caddy 在单二进制中直接服务 public/ 下的 CSS、JS、图片等文件，而不是依赖外部目录；若不做显式嵌入配置，生成的二进制运行时仍会去读取磁盘上的 public/，导致迁移后 404 或暴露路径风险。

确认当前 FrankenPHP CLI 版本并验证环境

打开终端，执行 frankenphp version，确认输出包含 v1.2.1；若未安装或版本不符，先运行 brew install dunglas/tap/frankenphp 更新——旧版不支持 embed 指令的完整解析逻辑，会导致嵌入失败但无报错。

进入你的 PHP 项目根目录（即含 composer.json 和 public/ 的目录），确保 public/ 下存在至少一个可验证文件，例如 public/test.js，内容为 console.log("ok");。

编写支持嵌入的 Caddyfile

在项目根目录新建纯文本文件，命名为 Caddyfile（注意大小写，无扩展名）。

写入以下内容，严格按格式缩进和换行：

localhost {
  root * public/
  php_server
  file_server {
    embed public/
  }
}

⚠️ 这里 【embed public/ 必须写成相对路径，且不能加尾部斜杠】；若写成 embed ./public/ 或 embed /Users/name/project/public，构建时会静默跳过嵌入，后续请求全部 fallback 到 PHP 而非返回静态文件。

保存后，在终端执行 ls -l Caddyfile 确认文件权限为 -rw-r--r--，避免因只读导致构建时读取失败。

清理项目并生成嵌入式二进制

第一步：删掉非运行必需文件，防止打包体积膨胀或泄露敏感信息：

rm -rf .git tests/ vendor/bin/ storage/logs/ storage/framework/cache/

macOS Notes

通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载

第二步：生成生产级自动加载器，跳过开发类：

composer dump-autoload --optimize --no-dev

第三步：确保环境为生产态——检查 .env 中 APP_ENV=prod 且 APP_DEBUG=false；Laravel 用户额外执行 php artisan config:clear && php artisan view:clear，否则缓存配置可能覆盖 Caddyfile 中的 embed 行为。

第四步：执行构建命令：

frankenphp build --output myapp --server-name localhost --no-compress

✅ 成功后会在当前目录生成 myapp 文件（约 45–65MB），它已包含 PHP 运行时、Caddy、全部 PHP 代码及 public/ 下所有静态文件。

验证静态资源是否真正嵌入

给二进制添加可执行权限：chmod +x myapp。

运行：./myapp，服务启动后访问 http://localhost:8000/test.js。

用 curl 检查响应头：curl -I http://localhost:8000/test.js，确认返回中包含 Content-Type: application/javascript 且状态码为 200；若返回 404 或 Content-Type: text/plain，说明 embed 未生效，需回退检查 Caddyfile 路径写法或是否存在符号链接干扰。

临时停掉服务，重命名 public/ 文件夹为 public_bak/，再次运行 ./myapp 并访问 /test.js——如果仍能正常返回内容，证明静态资源已真正编译进二进制，部署时无需携带 public/ 目录。