在CI/CD环境中运行PHPUnit测试时，开发者有时会遇到一个令人困惑的致命错误：“PHP Fatal error: Cannot acquire reference to $GLOBALS”。这个错误通常伴随着指向PHPUnit内部文件（如`src/Util/Configuration.php`）的堆栈跟踪。虽然测试矩阵可能明确指定了较旧的PHP版本（例如PHP 7.2或7.4），但错误依然出现，这往往指向了PHP版本兼容性问题，特别是与PHP 8对`$GLOBALS`超全局变量的更严格处理方式（PHP 8.1 `$GLOBALS` Restrictions）相关。
理解 $GLOBALS 引用错误及其根源
Cannot acquire reference to $GLOBALS 错误的核心在于PHPUnit尝试以某种方式访问或修改 $GLOBALS 超全局变量，而当前的PHP运行时环境（特别是PHP 8及更高版本）对此类操作施加了新的限制。PHP 8引入了更严格的内部机制，以防止对核心数据结构的意外或不当引用，从而提升了语言的稳定性和安全性。
当使用较旧版本的PHPUnit（例如PHPUnit 7.5.20）在PHP 8环境下运行时，由于其内部实现可能没有完全遵循PHP 8的新规定，就会触发此错误。即使你的CI/CD配置明确指定了PHP 7.x版本，CI/CD平台（如GitHub Actions）的默认容器环境或其内部PHP版本管理机制，在某些情况下可能仍然会提供一个更新的PHP版本（例如PHP 8.x），导致版本不匹配。
CI/CD 环境中的版本陷阱
在GitHub Actions等CI/CD平台中，我们通常使用预设的 actions 来设置开发环境。例如，shivammathur/setup-php@v2 是一个流行的用于设置PHP环境的 action。如果仅仅依赖于工作流中的PHP版本配置，而没有明确地在设置PHP的步骤中指定版本，CI/CD环境可能会默认使用其最新的PHP构建版本，这可能就是PHP 8.x。
立即学习“PHP免费学习笔记（深入）”；
示例：一个可能导致问题的GitHub Actions配置片段
jobs:
php-tests:
runs-on: ubuntu-latest
strategy:
matrix:
php: ['7.2', '7.4'] # 这里声明了PHP版本
name: P${{ matrix.php }}
steps:
- uses: actions/checkout@v2
- name: Validate composer.json and composer.lock
run: composer validate --strict
- name: Cache Composer dependencies
uses: actions/cache@v2
with:
path: vendor
key: ${{ runner.os }}-php-${{ matrix.php }}-${{ hashFiles('**/composer.lock') }}
restore-keys: |
${{ runner.os }}-php-${{ matrix.php }}-
- name: Install Composer dependencies
run: composer install --no-ansi --no-interaction --no-progress --prefer-dist
# ⚠️ 注意：这里可能缺少明确的 PHP 版本设置
- name: Run PHPUnit tests
run: vendor/bin/phpunit在上述例子中，虽然 matrix.php 定义了 PHP 7.2 和 7.4，但如果没有一个步骤明确地将这些版本应用到运行时环境，则实际执行测试的PHP版本可能不是预期的。
解决方案：明确指定PHP版本
解决此问题的最直接和有效的方法是在CI/CD工作流中，明确地设置PHP版本。这确保了PHPUnit运行在一个与它兼容的PHP版本上。
以下是在GitHub Actions中使用 shivammathur/setup-php@v2 action 来解决此问题的示例：
jobs:
php-tests:
runs-on: ubuntu-latest
strategy:
matrix:
php: ['7.4'] # 或者根据需要添加其他兼容版本
name: P${{ matrix.php }}
steps:
- uses: actions/checkout@v2
# ✅ 关键步骤：明确设置PHP版本
- name: Setup PHP with tools
uses: shivammathur/setup-php@v2
with:
php-version: ${{ matrix.php }} # 使用矩阵中的PHP版本
tools: phpunit # 同时安装phpunit工具
- name: Validate composer.json and composer.lock
run: composer validate --strict
- name: Cache Composer dependencies
uses: actions/cache@v2
with:
path: vendor
key: ${{ runner.os }}-php-${{ matrix.php }}-${{ hashFiles('**/composer.lock') }}
restore-keys: |
${{ runner.os }}-php-${{ matrix.php }}-
- name: Install Composer dependencies
run: composer install --no-ansi --no-interaction --no-progress --prefer-dist
- name: Run PHPUnit tests
run: vendor/bin/phpunit通过在 shivammathur/setup-php@v2 步骤中添加 php-version: ${{ matrix.php }}，我们强制GitHub Actions使用指定的PHP版本来构建环境，从而避免了因PHP版本不匹配导致的 $GLOBALS 引用错误。
PHPUnit 版本兼容性注意事项
除了明确设置PHP版本外，理解PHPUnit自身的版本兼容性也至关重要。
- PHPUnit 7.x 系列通常兼容 PHP 7.x 版本。
- PHPUnit 8.x 系列通常兼容 PHP 7.2 - PHP 7.4。
- PHPUnit 9.x 系列开始支持 PHP 7.3 - PHP 8.0。
- PHPUnit 10.x 系列开始支持 PHP 8.1 及更高版本。
如果你的项目需要运行在PHP 8或更高版本上，那么你必须升级到相应兼容的PHPUnit版本。你可以在 PHPUnit 官方网站 查看最新的兼容性列表。
总结与最佳实践
“Cannot acquire reference to $GLOBALS”错误在PHPUnit测试中，尤其是结合PHP 8和CI/CD环境时，是一个典型的版本兼容性问题。解决之道在于：
- 明确指定PHP版本： 在CI/CD工作流中，始终使用工具（如 shivammathur/setup-php@v2）明确指定要使用的PHP版本，而不是依赖于环境的默认设置。
- 检查PHPUnit兼容性： 确保你使用的PHPUnit版本与你的项目目标PHP版本兼容。如果升级PHP版本，也请相应地升级PHPUnit。
- 定期更新依赖： 保持PHP、PHPUnit以及其他项目依赖的更新，以获取最新的功能、性能改进和错误修复。
- 本地与CI/CD环境一致： 尽量保持本地开发环境与CI/CD测试环境的PHP版本和依赖版本一致，以减少因环境差异导致的问题。
遵循这些实践，可以有效地避免PHPUnit因版本不兼容而导致的 $GLOBALS 引用错误，确保自动化测试的顺利执行。
