答案是--working-dir必须传绝对路径且含composer.json,相对路径因执行上下文不确定易失败;变量需加引号防拆分,避免用~;建议用$(realpath app)转换并校验composer.json存在性。

Composer --working-dir 在 shell 脚本里不生效?先确认路径是否绝对
直接在脚本里写 composer install --working-dir=app 很可能失败——--working-dir 接收的是**项目根目录路径**,不是相对子目录名。它要求路径必须存在且包含 composer.json,否则报错 Could not find composer.json。
常见错误是传入相对路径(如 ./app),而脚本执行位置不确定(比如从父目录或 cron 启动),导致路径解析失败。
- 始终用
$(realpath app)或$(cd app && pwd)转成绝对路径再传给--working-dir - 加一步校验:
[ -f "$APP_DIR/composer.json" ] || { echo "Missing composer.json in $APP_DIR"; exit 1; } - 避免用
cd app && composer install替代——这会改变当前工作目录,影响后续命令,且无法和composer的其他全局选项(如--no-interaction)稳定协同
shell 变量含空格或特殊字符时,--working-dir 会崩
--working-dir 参数值如果来自变量,且该变量含空格、括号或波浪线(~),不加引号就会被 shell 拆分或展开错误。例如 DIR="/path/to/my project" 直接写 --working-dir=$DIR,实际传给 composer 的是两个参数:--working-dir=/path/to/my 和 project,立刻报错 Unrecognized option: project。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 必须用双引号包裹:
--working-dir="$DIR" - 不要依赖
~:写$HOME/project而非~/project,因为--working-dir=~/project中的~不会被 shell 展开 - 若路径来自用户输入或外部配置,先用
printf '%q' "$DIR"测试转义安全性(非必需,但调试时有用)
composer 命令本身找不到?别只查 PATH,先看权限和环境
脚本里调用 composer 报 command not found,不一定是 PATH 问题。特别是用 sudo 或系统服务运行时,PATH 被重置,且 composer 可能装在用户 home 下(如 ~/.local/bin/composer),对 root 不可见。
- 用绝对路径调用更可靠:
/usr/local/bin/composer或$(which composer)(但后者在无交互 shell 中可能失效) - 检查 composer 是否有执行权限:
ls -l $(which composer),某些安装方式(如 curl + chmod)漏掉x位 - 在脚本开头显式加载环境:
source ~/.bashrc 2>/dev/null || true(仅当 composer 确实依赖 shell 初始化时才加;多数情况不推荐,优先用绝对路径)
CI/CD 或容器中 --working-dir 仍失败?检查 vendor 目录归属和缓存
在 Docker 或 CI runner(如 GitHub Actions)中,即使路径正确、权限 OK,composer install --working-dir=... 还可能卡在 Loading composer repositories 或报 Failed to extract ...。根本原因常是:vendor 目录已存在但属主不匹配(如上一次是 root 写的,这次是 www-data),或 composer 缓存损坏。
- 加
--no-cache排除缓存干扰:composer install --working-dir="$APP_DIR" --no-cache - 清理残留:
rm -rf "$APP_DIR/vendor" "$APP_DIR/composer.lock"(谨慎使用,仅限可重建场景) - 确保目标目录可写:
chown -R $(whoami):$(whoami) "$APP_DIR"(容器中注意 UID/GID 对齐)
--working-dir 就成了“看起来对、跑起来错”的典型。每次加新环境,都得重新验证这三点。

















