ThinkPHP项目发布打包核心目标是精简可运行、隐藏敏感配置、避免写入失败、便于迁移；Web用精简包，CLI用PHAR或EXE，文档导出用ZIP。
ThinkPHP 项目发布时的打包，核心目标是：精简可运行、隐藏敏感配置、避免运行时写入失败、便于部署迁移。不是简单压缩整个开发目录，而是按用途区分——Web 服务部署用精简包，CLI 工具交付用 PHAR 或 EXE，内部文档类批量导出用 ZIP 打包。
Web 项目上线：精简打包（推荐用于 Nginx/Apache 环境）
发布到生产服务器时，应剔除开发无关文件，保留最小运行集：
- 只保留 public 目录（含 index.php、静态资源）、app、config、route、vendor（已通过 composer install 安装好）
- 删除
runtime目录（它会在首次访问时自动生成；若需预置，确保目录可写且权限为 0755） - 移除
.env文件（改用服务器环境变量或 config 下的正式配置文件，如database.php中填入线上数据库参数） - 确认
config/app.php中'debug' => false，关闭调试模式 - 用
tar -czf tp-prod-202610.tar.gz public/ app/ config/ route/ vendor/打包，不包含think命令行脚本和测试目录
CLI 工具交付：PHAR 打包（适合数据处理、报表生成等命令行任务）
把 ThinkPHP 的命令行功能打包成单文件，客户双击或命令行运行即可，无需 PHP 环境配置：
- 确保入口文件明确（如
public/cli.php，调用think并指定命令） - 使用原生 PHAR 扩展打包：
$phar = new Phar('tool.phar');<br> $phar->buildFromDirectory(__DIR__, '/\.(php|ini)$/');<br> $phar->setStub($phar->createDefaultStub('public/cli.php'));<br> $phar->compressFiles(Phar::GZ);<br> $phar->stopBuffering(); - 注意：PHAR 内不能写入
runtime，需在外部定义（如define('RUNTIME_PATH', __DIR__ . '/data/runtime/');），并确保该目录存在且可写 - 生成后用
php tool.phar list测试是否正常加载命令
客户端交付：编译为 EXE（适合 Windows 环境下的内部工具）
当客户无技术能力部署 PHP 环境时，可用 TypePHP 或 PHPCUSTOM 封装为 Windows 可执行文件：
立即学习“PHP免费学习笔记（深入）”；
- TypePHP 支持 ThinkPHP 8，会嵌入 PHP 运行时 + 所有扩展 + 项目代码，输出单个
.exe - PHPCUSTOM 更轻量，要求 ThinkPHP ≥6.0（因内建 PHP 8），打包时选择项目根目录（非 public），它自动以 public 为 Web 根
- 两种方式均默认加密源码，但数据库密码、API 密钥等仍建议抽离到外部配置或环境变量中，不要硬编码进代码
- 生成后务必在干净 Windows 系统上测试启动、页面访问、数据库连接是否正常
批量文档导出：ZIP 打包下载（适用于生成多个 Word/PDF 后统一提供）
用户触发“下载全部报告”时，后端动态生成再压缩，不提前存盘：
- 先用
PhpOffice/PhpWord循环生成多个.docx，保存至临时目录（如runtime/word_export/） - 用
ZipArchive创建压缩包，逐个addFile()加入，注意用basename()避免路径层级 - 设置响应头：
Content-Type: application/zip、Content-disposition: attachment; filename="reports.zip" - 最后
readfile()输出并立即rmdir()清理临时目录，防止磁盘占满
