Composer archive排除文件命令_Composer自定义导出过滤规则-composer-PHP中文网

composer archive 命令在 composer 2.2+ 中未向用户开放，执行必报错“command not defined”；其配置仅在 packagist 发布或实验性 pack 时生效，本地归档应使用系统 zip/tar 显式排除。

composer archive排除文件命令_composer自定义导出过滤规则

composer archive 命令根本不能直接用——它不是用户可用命令，执行必报 Command "archive" is not defined。 所有声称“配好 archive.exclude 就能跑通 composer archive”的方案，要么基于过时文档，要么依赖第三方二进制（如 vendor/bin/composer-archive），且行为不可控、不兼容新版 Composer。

为什么 `composer archive` 总是失败

Composer 2.2+ 所有稳定版均未将 ArchiveCommand 暴露给终端用户。它仅被 Packagist 或实验性 composer pack（2.5+）内部调用，不会出现在 composer list 输出中，也没有官方文档支持。你查不到它的参数说明，是因为它压根不是设计给你敲的。

常见错误现象：

执行 composer archive --format=zip 报错：Command "archive" is not defined
看到别人成功了？大概率他们项目里装了第三方工具（如 hirak/prestissimo 衍生脚本或私有封装），不是 Composer 自带能力
即使强行调用内部类（如 php -d disable_functions= -d memory_limit=-1 vendor/composer/ClassLoader.php ...），也会因路径解析、权限或版本升级而随时崩掉

`archive` 配置只在特定场景生效

你在 composer.json 里写的 "archive": {"exclude": [...]}，只对以下两种情况起作用：

你作为包作者，把代码发布到 Packagist，它自动调用归档逻辑生成 dist zip 包
你自己手动运行 composer archive（但前提是你用的是 2.2+ 且该命令恰好没被移除——极不稳定）

它完全不影响：composer install 后 vendor/ 目录里的内容、本地项目根目录下的 tests/ 是否被打包、git archive 或 GitHub ZIP 下载行为。很多人改了这个字段却发现压缩包里还是有 phpunit.xml，就是因为没意识到：GitHub 点 Download ZIP 走的是 .gitattributes，不是 Composer 配置。

Discussion Composer

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

下载

真正可控的排除方式：分两步，用系统命令显式过滤

生产部署要的是可验证、可复现、不含垃圾文件的包，不是“看起来像一键”的黑盒。可靠做法只有两个动作：

先精简依赖：composer install --no-dev --optimize-autoloader —— 这步确保 vendor/ 干净，不带测试包和 dev autoloader
再用系统 zip/tar 显式排除：zip -r app.zip . -x "vendor/*" -x ".git/*" -x "tests/*" -x "phpunit.xml*"

关键细节：

Windows 用户请用 Git Bash 或 WSL；CMD 自带 zip 不支持 -x，不可靠
composer.lock 体积大、部署时不需重解析，应 -x "composer.lock"；但若目标环境要离线 install，就得手动保留

想自动化？写进 composer.json 的 scripts，比如：

"scripts": {
  "package": [
    "@composer install --no-dev --optimize-autoloader",
    "zip -r myapp-$(date -I).zip . -x \"vendor/*\" -x \".git/*\" -x \"tests/*\" -x \"phpunit.xml*\""
  ]
}

然后运行 composer run package（2.5+）或 composer run-script package（旧版）

别信 `.gitattributes` 能替代一切

.gitattributes 确实被 git archive 和 GitHub/GitLab ZIP 下载原生支持，写 /tests/ export-ignore 是有效的。但它不被 Composer 的 archive 命令读取（除非你用的是极老版本）。更重要的是：它只影响 Git 归档路径，对 composer install 后的运行时加载、classmap 生成、PSR-4 解析完全无感。很多人配了 .gitattributes 却发现 vendor/autoload.php 还是加载了测试类——那是因为 autoload 行为由 autoload 和 autoload-dev 块控制，跟归档无关。

真正容易被忽略的一点：你看到的 vendor/ 里那些“多余文件”，99% 是包作者没配好自己的 archive.exclude 或 .gitattributes；你本地改自己项目的配置，对它们毫无影响。