PHP/GitHub Actions工作流：如何将secrets注入到$_ENV供PHPUnit使用

问题原因及对应解决方法 #

1. PHP CLI配置未开启$_ENV超全局填充 #

PHP CLI模式下默认的variables_order配置通常为GPCS，缺少E标记，导致不会将系统环境变量填充到$_ENV超全局数组中。
解决方法二选一：

• 执行PHPUnit命令时临时增加配置参数：

  run: php -d variables_order=EGPCS vendor/bin/phpunit
  

• 在工作流中提前修改PHP配置文件：

  - name: Configure PHP env support
    run: echo "variables_order = EGPCS" >> $PHP_INI_DIR/conf.d/custom.ini
  

2. PHPUnit配置未指定导入系统环境变量 #

如果你的项目根目录下有phpunit.xml或phpunit.xml.dist配置文件，需要显式声明要读取的系统环境变量，否则PHPUnit不会自动将系统环境变量传入运行时。
在配置文件的<php>节点下添加对应变量声明即可，不需要写默认值，会自动读取系统已存在的环境变量：

<phpunit>
  <!-- 其余原有配置 -->
  <php>
    <env name="TWITTER_ACCESS_TOKEN" />
    <env name="TWITTER_ACCESS_TOKEN_SECRET" />
    <env name="TWITTER_ACCOUNT_ID" />
    <env name="TWITTER_BEARER_TOKEN" />
    <env name="TWITTER_CONSUMER_KEY" />
    <env name="TWITTER_CONSUMER_SECRET" />
  </php>
</phpunit>

3. 可选排查步骤 #

先在工作流的测试步骤前打印环境变量，确认GitHub Secrets已经正确注入到工作流环境中：

- name: Execute tests
  env:
    TWITTER_ACCESS_TOKEN: ${{ secrets.TWITTER_ACCESS_TOKEN }}
    # 其余原有环境变量配置
  run: |
    echo $TWITTER_ACCESS_TOKEN
    vendor/bin/phpunit

GitHub会自动隐藏敏感值的输出，只要输出不是空值（显示为***）就说明工作流层面的环境变量配置没有问题，问题出在PHP/PHPUnit配置层面。 #

额外注意 #

如果你的项目使用了vlucas/phpdotenv这类环境变量加载库，需要确认加载时没有开启覆写已有环境变量的配置，避免已经注入的GitHub环境变量被本地.env文件的空值覆盖。

内容的提问来源于stack exchange，提问作者Noweh