composer archive 不能用于项目发布，因其仅打包库源码且不含 vendor/、未优化自动加载、版本与 git tag 不同步；应改用 git archive 或 zip 配合 composer install --no-dev --optimize-autoloader。

Composer 本身不提供“项目归档”能力，composer archive 命令只打包「包（package）」本身（即源码+元数据），不是你项目的可部署产物。真要生成生产可用的归档包，必须绕过这个命令，走 composer install --no-dev --optimize-autoloader + git archive 或系统 zip 的组合路径。

为什么 composer archive 不能用于项目发布

它设计目标是为 Packagist 上的 library 打分发包，行为受限于 composer.json 中的 archive.exclude 和 type 字段，且默认不包含 vendor/ —— 这意味着你解压后无法直接运行；它还会按 name 和 version 自动生成文件名（如 myorg/myapp-1.2.0.zip），但这个 version 往往和 Git tag 不同步，CI 中极易出错。

• 执行 composer archive 时若 composer.json 缺少 name，会报错：Package name is required
• 即使成功，产出包里没有 vendor/autoload.php，require 'vendor/autoload.php' 必然失败
• 它不会触发 autoloader 优化，也不会清理 dev 依赖，vendor/ 实际未生成

git archive 是最干净的源码归档方式

前提是项目用 Git 管理，且已配置 .gitattributes 控制导出内容。它只打包当前 commit 的 tracked 文件，天然排除 .git/、node_modules/、未提交的 .env 等风险项。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 先在项目根目录写 .gitattributes：

vendor/** export-ignore
tests/** export-ignore
.php-cs-fixer.php export-ignore
.env export-ignore
.gitignore export-ignore

• 打最新 commit：git archive --format=zip --output=myapp-$(git describe --tags --abbrev=0).zip HEAD
• 打指定 tag：git archive --format=tar.gz --output=release.tar.gz v1.2.3
• 注意：vendor/ 不在 Git 中，所以归档后必须在目标环境跑 composer install --no-dev --optimize-autoloader

打包前必须做 autoload 优化，且不能补救

composer dump-autoload --optimize --no-dev 只生成 vendor/composer/autoload_classmap.php，但不会重建 vendor/composer/autoload_*.php —— 这些文件只有 composer install 时才生成。所以优化动作必须嵌入安装流程，不能分开。

• 正确顺序：删掉本地 vendor/ → composer install --no-dev --optimize-autoloader --prefer-dist → 归档
• 错误做法：先 composer install，再 dump-autoload --optimize，此时 autoload_files.php 等仍为未优化状态
• 验证点：归档前检查 vendor/autoload.php 是否存在，且其中是否含 classmap 加载逻辑

别漏掉 composer.lock 和环境配置校验

composer.lock 必须随归档一起发布，否则目标环境 install 时版本漂移；但 .env 之类本地配置绝不能进包 —— 它们该由部署流程注入，而非打包携带。

• git archive 依赖 .gitattributes 排除 .env，手动 zip 要显式加 -x ".env"
• composer.lock 在 .gitattributes 中不要设 export-ignore，它是部署一致性基石
• 最容易被忽略的是：归档后没在空目录下解压并执行 composer install --no-dev 验证能否成功加载 vendor/autoload.php