$composer_home和$composer_bin_dir是composer在执行scripts时自动注入的shell环境变量,仅在shell上下文中有效,php脚本中需通过命令行参数显式传递或用composer config动态获取。

scripts里怎么用$COMPOSER_HOME和$COMPOSER_BIN_DIR
Composer在执行scripts时,会自动注入一组环境变量,其中最常用的是$COMPOSER_HOME(全局配置和缓存目录)和$COMPOSER_BIN_DIR(可执行二进制文件安装路径)。这些变量不是PHP常量,而是shell环境变量,只在scripts命令的shell上下文中有效。
常见错误是试图在PHP脚本里直接读$_ENV['COMPOSER_HOME']——它通常为空,因为Composer启动PHP进程时不一定透传这些变量;正确做法是在composer.json的scripts字段中用shell语法引用:
"scripts": {
"dump-home": "echo \"Composer home: $COMPOSER_HOME\"",
"list-bin": "ls -l $COMPOSER_BIN_DIR"
}
- Windows用户注意:
%COMPOSER_HOME%才是等效写法,但建议统一用cross-env兼容 - 这些变量在
post-install-cmd、pre-autoload-dump等钩子中同样可用 -
$COMPOSER_BIN_DIR默认指向vendor/bin,但若用--bin-dir自定义过,这里会反映实际路径
为什么$COMPOSER_VENDOR_DIR经常为空?
$COMPOSER_VENDOR_DIR不是Composer运行时自动设置的环境变量,它是composer.json中config.vendor-dir的值,在scripts里**不会自动导出为环境变量**。很多用户看到文档里提到这个变量名,就误以为它天然存在。
要安全获取vendor目录路径,有两个可靠方式:
- 用
composer config vendor-dir命令动态查(推荐):"show-vendor": "echo \"Vendor dir: $(composer config vendor-dir)\""
- 在PHP脚本中调用
getcwd() . '/vendor'(前提是没改过vendor-dir且当前工作目录是项目根) - 避免硬编码
./vendor——如果项目用了"config": {"vendor-dir": "lib/vendor"},就会出错
在PHP脚本里怎么拿到Composer的路径变量?
如果script指向一个PHP文件(如"post-install-cmd": "MyScript::run"),那PHP进程本身收不到$COMPOSER_HOME这类shell变量。必须显式透传:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"scripts": {
"run-with-home": "php myscript.php --home=$COMPOSER_HOME --bin=$COMPOSER_BIN_DIR"
}
然后在myscript.php里用$argv或symfony/console解析参数。不推荐用putenv()临时设环境变量,因为不可靠且难调试。
- Composer自身源码里也从不依赖
$_ENV读这些路径,而是通过ComposerFactory实例获取 - 如果你的PHP脚本需要vendor路径,优先用
dirname((new \ReflectionClass(\Composer\Composer::class))->getFileName()) . '/../../'反推,比猜路径更稳
自定义变量怎么注入到scripts环境?
Composer不支持在composer.json里声明自定义环境变量,但可以用cross-env补位:
"require-dev": {
"cross-env/cross-env": "^7.0"
},
"scripts": {
"dev-build": "cross-env APP_ENV=dev php build.php"
}
这样APP_ENV就能在build.php里通过$_SERVER['APP_ENV']读到。注意:cross-env只是包装器,不能替代$COMPOSER_HOME这类原生变量。
- 别在
scripts里写export FOO=bar && php script.php——export对后续命令无效,shell作用域限制 - 所有路径类变量都建议加引号包裹,比如
"$COMPOSER_HOME",防路径含空格时崩掉
真正容易被忽略的是:这些变量只在Composer调用shell命令的那一刻生效,如果脚本里再fork子进程(比如exec、proc_open),得手动继承或重传,否则就丢了。










