Composer“无头安装”指在CI/CD等无交互环境禁用提示、屏蔽进度、绕过校验，硬性要求执行composer install --no-interaction --no-dev --optimize-autoloader，并设置COMPOSER_NO_INTERACTION=1等环境变量确保流程可复现与验证。
Composer 本身不支持“无头安装”这个说法——它没有图形界面，所有安装操作本就是命令行驱动的；所谓“无头”，实际是指在 CI/CD、Docker 构建或远程服务器等无交互环境中，避免任何人工输入、跳过提示、屏蔽进度条、绕过平台校验，并确保流程可复现。
composer install 必须加 --no-interaction --no-dev --optimize-autoloader
这三个参数不是可选优化项，而是生产构建的硬性前提：
-
--no-interaction：禁用所有交互式提示（如是否创建.env、是否清空缓存），否则 CI 流程会卡死在 stdin 等待输入 -
--no-dev：跳过require-dev中的包（如 phpunit、phpstan），但注意：它不会自动清理已安装的 dev 工具二进制文件（如vendor/bin/phpunit），需后续手动删 -
--optimize-autoloader：生成vendor/composer/autoload_classmap.php，提升类加载性能；但若项目含动态类名拼接（如new $class），需确认该类是否被 classmap 涵盖，否则会抛出Class not found
CI 环境下必须显式设置 COMPOSER_NO_INTERACTION=1
仅靠 --no-interaction 参数有时不够：某些插件或自定义脚本仍可能读取 $_SERVER['COMPOSER_NO_INTERACTION'] 或 getenv('COMPOSER_NO_INTERACTION') 判断上下文。在 GitHub Actions、GitLab CI 等环境里，应提前注入环境变量：
env: COMPOSER_NO_INTERACTION: 1 COMPOSER_NO_PROGRESS: 1 COMPOSER_PREFER_STABLE: 1
其中 COMPOSER_NO_PROGRESS 可屏蔽下载时的进度条，避免日志污染和 ANSI 控制字符干扰解析；COMPOSER_PREFER_STABLE 防止因 require 中用了 dev-master 导致版本漂移。
Docker 多阶段构建中 vendor 目录不能直接复制
常见错误是第一阶段 composer install 后，第二阶段用 COPY --from=builder /app/vendor /app/vendor —— 这会导致两个问题：
- PHP 扩展缺失：运行时镜像（如
php:8.2-apache-slim）可能没装ext-zip或ext-pdo，而vendor/里的某些包（如symfony/filesystem）在 autoload 阶段就依赖这些扩展，直接加载失败 - 路径错位：若项目设置了
"config": {"vendor-dir": "lib/vendor"}，但 COPY 仍按默认路径操作，autoload 将找不到类
正确做法是在第二阶段容器内重新执行 composer install --no-dev --optimize-autoloader --no-interaction，并确保该镜像已预装 Composer 和必要 PHP 扩展；或使用 --ignore-platform-reqs 强制通过（仅限确认目标环境确实满足运行条件时）。
自动加载优化后必须验证 classmap 覆盖范围
composer dump-autoload --optimize 生成的 autoload_classmap.php 是静态映射，不支持运行时新增类。容易被忽略的是：
- 它只对 PSR-0/PSR-4 规则注册的命名空间生效，对
"files"类型的自动加载项（如src/helpers.php）无加速效果 - 若项目用
class_alias()或反射动态注册类，这些类不会进入 classmap，启用优化后可能触发Warning: Class XXX not found - CI 中建议加一步验证：
php -r "require 'vendor/autoload.php'; echo 'OK';"，比单纯看 exit code 更早暴露 autoload 失败
真正安全的“无头构建”，不在于参数堆得多，而在于每一步都可验证、可中断、可回溯——尤其当 vendor/ 不再是黑盒，而是你明确知道哪些类被加载、哪些扩展被调用、哪些文件被忽略时，才算落地。
