Composer install 失败前须确认三件事：Composer 二进制在 PATH 中、PHP 版本满足项目要求、composer.lock 已同步且比 vendor 新；推荐用 geerlingguy.composer 角色安装，再用 community.general.composer 调用，并注意 vendor 权限对齐 web 服务用户。
composer install 失败前先查这三件事
Ansible 执行 composer install 报错，90% 不是命令写错了，而是环境没铺平。必须确认：Composer 二进制已存在且在 $PATH 中；PHP 可执行且版本满足项目要求（比如 Laravel 11 需 PHP 8.2+）；composer.lock 文件已同步到目标机、时间戳比 vendor/ 新。
常见错误现象包括：command not found: composer（根本没装）、PHP Parse error（PHP 版本太低）、Package xyz has a PHP requirement incompatible（lock 文件和当前 PHP 不匹配）。
- 用
ansible web -m command -a "which composer"快速验证是否可调用 -
ansible web -m command -a "php -v"看实际运行的 PHP 版本（注意 CLI 和 FPM 可能不同） -
ansible web -m stat -a "path=/var/www/myapp/composer.lock"检查 lock 文件是否存在且非空
用 geerlingguy.composer 角色安装最省心
别手写 get_url + shell 脚本去下 installer.php —— 容易漏 mode: '0755' 或 PATH 配置，导致 composer 命令全局不可用。直接复用社区验证过的 geerlingguy.composer 角色更可靠。
它默认把二进制放 /usr/local/bin/composer，支持锁定版本（如 composer_version: '2.7.7'），还能通过 composer_install_dir 自定义路径。关键是：它不依赖系统包管理器，也不需要提前装 PHP —— 只要目标机有 PHP CLI 就能跑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在 playbook 里引用时，确保 role 已通过
ansible-galaxy install geerlingguy.composer下载到本地 - 若需降级到 Composer 1.x（比如老项目不兼容 v2），设
composer_version_branch: ''并指定具体版本号 - 角色不处理权限问题：如果目标用户不是 root，得加
become: true，否则写不到/usr/local/bin/
community.general.composer 模块只调用，不安装
community.general.composer 模块本质就是个封装好的 composer 命令调用器。它不会帮你装 Composer，也不会校验 PHP 环境 —— 如果远程机器上没有 composer 命令，任务直接报 composer command not found，连参数解析都不会做。
它的价值在于幂等性控制：比如 action: install 会自动跳过已装好的包；no_dev: true 能避免 dev 依赖污染生产环境；optimize_autoloader: true 生成更高效的 autoload map。但前提是——你得先用别的方法把 Composer 给它备好。
- 别把它和安装逻辑混在一个 task 里：先跑
geerlingguy.composer，再跑community.general.composer - 若用非标准 PHP 路径（比如
/opt/php82/bin/php），得显式传executable: /opt/php82/bin/php - 注意
working_dir必须是项目根目录，且该目录下要有composer.json或composer.lock
批量部署时 vendor 目录权限容易被忽略
Ansible 默认以普通用户身份运行命令，而 composer install 生成的 vendor/ 目录里很多文件属主是该用户。但 PHP-FPM 进程往往以 www-data 或 nginx 用户跑，结果一访问就报 Class not found —— 实际是 autoloader 读不到文件。
这不是 Composer 的问题，是部署后权限没对齐。解决方式不是全改成 777，而是让 web server 用户能读取，同时保持写权限仅限部署用户。
- 加一个 task：用
file模块递归设置owner和group，比如owner: deploy+group: www-data - 对
vendor/和storage/（Laravel）这类目录，额外加mode: 'g+rwx'，确保组内可读写 - 别依赖
composer install --no-interaction自动修复权限 —— 它只管依赖，不管文件系统权限
