Composer脚本默认不继承Shell环境变量,需通过export导出变量或内联方式传递,如export MY_ENV=production或MY_ENV=staging composer run my-script,确保子进程可访问。

Composer 默认在执行脚本时会使用一个清理过的环境,这可能导致当前 Shell 中设置的环境变量无法被脚本访问。要让 Composer 脚本继承当前 Shell 的环境变量,关键是确保这些变量在执行 composer run 时仍然可用。
理解 Composer 脚本的执行环境
Composer 在运行脚本时通常通过 proc_open 启动子进程,默认不会自动传递所有父进程的环境变量,尤其是那些仅在当前 Shell 会话中定义的临时变量。
如果变量没有导出(即未使用 export),子进程是无法读取的。因此,必须确保变量已正确导出到环境。
方法一:导出环境变量后再运行 Composer
在调用 composer run 前,使用 export 将变量加入环境变量表。
export MY_ENV=productioncomposer run my-script
这样,PHP 脚本中就可以通过 getenv('MY_ENV') 或 $_ENV['MY_ENV'] 正常获取值。
方法二:内联方式直接传入变量
可以在执行命令时直接将变量写在前面,这种写法会临时为该命令设置环境变量。
MY_ENV=staging composer run my-script
这种方式简洁,适合一次性操作,变量作用域仅限于当前命令。
方法三:在脚本中显式启用环境变量支持
如果你通过 Composer 执行 PHP 脚本,确保脚本中启用了环境变量读取。例如,在 Laravel 或 Symfony 等框架中,.env 文件的加载可能依赖启动方式。
对于自定义脚本,检查是否调用了:
-
$_ENV是否启用(可通过php_admin_value variables_order配置) - 使用
getenv()函数更可靠,它不依赖variables_order
避免常见误区
不要只在 Shell 中赋值而不导出:
-
❌
MY_ENV=dev→ 子进程不可见 -
✅
export MY_ENV=dev→ 子进程可见
同时注意,Shell 别名或函数不会被继承,Composer 只能访问环境变量和可执行命令。
基本上就这些。只要确保变量已导出或内联传入,Composer 脚本就能正常读取当前 Shell 的环境变量。










