Yii2+Codeception功能测试中模拟REMOTE_ADDR的方法

嘿，我之前在做Yii2+Codeception的功能测试时也踩过这个坑——直接手动设置$_SERVER['REMOTE_ADDR']确实经常不生效，因为Codeception在处理功能测试请求时会自己管理服务器上下文，手动设置的变量很容易被覆盖。下面给你几个靠谱的解决办法，按优先级排序：

1. 在测试套件配置里全局设置（推荐） #

这是一劳永逸的方法，所有功能测试都会自动带上指定的IP。打开你的功能测试配置文件（通常是tests/functional.suite.yml），找到PhpBrowser或WebDriver模块的配置，添加server参数：

modules:
    enabled:
        - PhpBrowser:
            url: 'http://localhost:8080' # 替换成你的测试应用URL
            server:
                REMOTE_ADDR: '127.0.0.1' # 这里设置你需要模拟的IP
        - Yii2:
            part: [orm, fixtures]
            configFile: 'config/test.php'

这样Codeception在发起每个测试请求时，都会自动把这个REMOTE_ADDR注入到$_SERVER数组里，完全不用在测试代码里额外处理。

2. 在单个测试用例里动态设置 #

如果只是某几个测试需要不同的IP，可以在Cept或Cest文件里用Codeception提供的API来设置：

<?php
$I = new FunctionalTester($scenario);

// 在请求发起前设置服务器参数
$I->setServerParameter('REMOTE_ADDR', '192.168.1.100');

// 然后执行你的测试步骤
$I->amOnPage('/some-page');
$I->see('IP相关的内容');

这个方法的好处是灵活，不同测试可以用不同的IP，而且是通过Codeception的官方API设置，不会被上下文重置覆盖。

3. 在测试Bootstrap文件里全局初始化 #

如果上面两种方法都不适用，还可以在测试的bootstrap文件里提前设置$_SERVER变量。打开tests/_bootstrap.php，在Yii初始化之前添加：

<?php
defined('YII_ENV') or define('YII_ENV', 'test');
defined('YII_DEBUG') or define('YII_DEBUG', true);

// 提前设置REMOTE_ADDR
$_SERVER['REMOTE_ADDR'] = '127.0.0.1';

require_once __DIR__ . '/../vendor/autoload.php';
require_once __DIR__ . '/../vendor/yiisoft/yii2/Yii.php';
require_once __DIR__ . '/../config/test.php';

这个方法要注意顺序，必须在Yii加载之前设置，否则Yii可能已经读取了$_SERVER的值并缓存起来了。

为什么手动设置$_SERVER无效？ #

简单来说，Codeception的功能测试模块（比如PhpBrowser）在每次发起请求时，会重新构建一个干净的服务器环境，你在测试代码里手动设置的$_SERVER['REMOTE_ADDR']会被这个新环境覆盖，所以才会看起来“无效”。

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