如何在Composer脚本中获取当前项目的根目录？ (@php bin/console)

composer_ROOT_DIR 环境变量是获取项目根目录的唯一可靠方式，由 Composer 2.2+ 自动注入，值为 composer.json 所在绝对路径，适用于所有 scripts 场景，但仅在脚本执行期间有效。

Composer脚本里不能直接用 __DIR__ 或 getcwd()

因为 Composer 脚本（如 "scripts" 中定义的命令）是在 Composer 自身上下文中执行的，__DIR__ 指向的是 Composer 的 vendor 目录或 bin 文件位置，getcwd() 则可能返回任意工作目录（比如你从子目录运行 composer install）。所以靠 php 内置函数“猜”项目根目录不可靠。

COMPOSER_ROOT_DIR 环境变量是唯一可靠来源

Composer 从 2.2 开始（且在绝大多数现代项目中）会自动注入 COMPOSER_ROOT_DIR 环境变量，其值就是 composer.json 所在的绝对路径——也就是你想要的“当前项目根目录”。

• 该变量由 Composer 主进程设置，与脚本执行位置、PHP 工作目录完全解耦
• 无需额外依赖或查找逻辑，开箱即用
• 在 scripts 中调用的 PHP 脚本、shell 命令、甚至 @php 行内命令均可直接读取

{     "scripts": {         "dump-root": "@php -r "echo $_SERVER['COMPOSER_ROOT_DIR'] . PHP_EOL;""     } }

在 @php bin/console 类命令中怎么传根目录？

如果你的 bin/console 是 symfony 风格的控制台应用，它本身不自动感知 Composer 根目录。但你可以通过环境变量或参数显式传递：

• 推荐方式：用 env 前缀把 COMPOSER_ROOT_DIR 注入进去，例如：
  "symfony:build": "env app_PROJECT_ROOT=${COMPOSER_ROOT_DIR} @php bin/console assets:install --symlink"
• 注意：windows CMD 不支持 ${var} 语法，应改用 %COMPOSER_ROOT_DIR%；而 git bash / Zsh / linux 默认可用
• 如果 bin/console 是纯 PHP 脚本，可在入口处用 $_SERVER['COMPOSER_ROOT_DIR'] 安全读取，无需 fallback 逻辑

不要尝试用 composer config --absolute 或遍历查找

虽然 composer config --absolute 理论上能输出根路径，但它：

立即学习“PHP免费学习笔记（深入）”；

• 启动 Composer 子进程开销大，拖慢脚本执行
• 在某些 CI 环境或 lock 文件损坏时可能失败或返回空
• 无法在 @php -r 这类无 shell 上下文的场景中直接调用
• 不如环境变量稳定、轻量、标准化

真正容易被忽略的是：这个变量只在 Composer **执行脚本阶段**存在，一旦脚本退出（比如你 fork 出另一个 PHP 进程又没透传环境），它就消失了。所以别在异步任务、守护进程或子进程中默认依赖它——需要时得手动 putenv() 或 export。