必须删除.git、tests/、docs/、examples/、vendor/bin/、storage/logs/、storage/framework/cache/、node_modules/；.env需设APP_ENV=prod和APP_DEBUG=false，执行composer install --no-dev --optimize-autoloader，并清理Laravel缓存。

必须清理无关文件、锁定环境变量、生成生产级 autoload，否则二进制会启动失败或体积暴涨

哪些文件必须删掉

FrankenPHP 二进制运行时会把整个打包目录当根路径加载，所以任何开发期残留都会被读取甚至执行：

• .git 目录 —— 不仅冗余，git hook 或 submodule 可能触发意外行为
• tests/、docs/、examples/ —— 没有路由指向它们，但会被 composer dump-autoload 扫描进 autoload map，徒增体积
• vendor/bin/ —— 里面全是开发用 CLI 工具（如 phpunit、php-cs-fixer），运行时根本用不到
• storage/logs/ 和 storage/framework/cache/ —— 日志和缓存是运行时写入的，打包进去反而可能因权限/时间戳引发问题
• node_modules/ —— 前端构建产物应已输出到 public/，源码留着只会让 tar 包膨胀数倍

哪些配置必须设为 prod

不是只改 .env 就完事。FrankenPHP 启动 PHP 时不会跑 Laravel/Symfony 的 artisan 命令，所有预编译动作得你手动做完：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• .env 中必须含 APP_ENV=prod 和 APP_DEBUG=false；若用 composer dump-env prod，则删掉 .env，只留 .env.local.php
• 执行 composer install --no-dev --optimize-autoloader —— --no-dev 确保 autoload-dev 不生效，--optimize-autoloader 生成 classmap，避免运行时遍历 psr-4 目录
• Laravel 用户额外跑 php artisan config:clear 和 php artisan view:clear，否则 bootstrap/cache/config.php 和 storage/framework/views/ 里的旧缓存会覆盖新配置

public/ 下的入口和 router 文件怎么处理

FrankenPHP 默认托管 public/，但它不自动识别 index.php，必须显式声明路由逻辑：

立即学习“PHP免费学习笔记（深入）”；

• public/.frankenphp.router.php 必须存在，最简内容是：

  <?php
  return [
      'index' => 'index.php',
  ];

• 如果项目用了自定义域名或需要动态 APP_URL，别在 .env 里硬写，而是在 router 文件里补：

  $_SERVER['APP_URL'] = 'https://' . ($_SERVER['HTTP_HOST'] ?? 'localhost');

• 确保 public/index.php 能直接响应 HTTP 请求（比如访问 curl -I http://localhost:8080 返回 200），否则打包后连首页都打不开

最容易被忽略的是 storage/ 目录权限和 public/.frankenphp.router.php 的存在性——前者导致 500 错误无日志可查，后者缺失直接 404，且错误提示极其模糊。打包前务必在本地用 ./frankenphp server --document-root public/ 验证一次。