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。
