
在symfony应用程序中,控制器通常依赖于各种服务来执行业务逻辑、与数据库交互或调用外部api。当为这些控制器编写测试时,特别是当依赖的服务涉及外部资源(如第三方api、数据库、邮件发送等)时,直接运行这些服务可能会导致测试不稳定、速度慢或产生不必要的副作用。此时,服务模拟(mocking)成为一种关键的测试策略,它允许我们用受控的、预设行为的替身来替换真实的服务,从而隔离被测试的控制器逻辑。
考虑以下一个典型的Symfony控制器示例,它依赖于多个服务,包括一个可能调用外部API的MyService:
// src/Controller/WebhookController.php
final class WebhookController extends AbstractController
{
private CustomLoggerService $customLogger;
private EntityManagerInterface $entityManager;
private MyService $myService;
private UserMailer $userMailer;
private AdminMailer $adminMailer;
public function __construct(
CustomLoggerService $customLogger,
EntityManagerInterface $entityManager,
MyService $myService,
UserMailer $userMailer,
AdminMailer $adminMailer
) {
$this->customLogger = $customLogger;
$this->myService = $myService;
$this->userMailer = $userMailer;
$this->adminMailer = $adminMailer;
$this->entityManager = $entityManager;
}
/**
* @Route("/webhook/new", name="webhook_new")
*/
public function new(Request $request): Response
{
$uri = $request->getUri();
$this->customLogger->info("new event uri " . $uri);
$query = $request->query->all();
if (isset($query['RessourceId'])) {
$id = $query['RessourceId'];
// MyService 可能会调用外部API
$event = $this->myService->getInfos($id);
$infoId = $event->infoId;
$this->customLogger->info("new info id " . $infoId);
$userRepo = $this->entityManager->getRepository(User::class);
$user = $userRepo->findOneByEventUserId((int)$event->owners[0]);
$this->userMailer->sendAdminEvent($event, $user);
$this->customLogger->info("new mail sent");
} else {
$this->adminMailer->sendSimpleMessageToAdmin("no ressource id", "no ressource id");
}
return new JsonResponse();
}
}在测试上述控制器时,我们希望模拟MyService的行为,因为其getInfos方法可能触发外部API调用。
在WebTestCase环境中,我们通常通过创建一个客户端($client = $this-youjiankuohaophpcnstartClient();)来模拟HTTP请求。然而,当需要模拟控制器内部的服务时,常见的尝试可能会遇到以下问题:
直接实例化控制器:
// 假设在测试类中 $controller = new WebhookController(xxxx); // 需要手动传入所有依赖 $controller->new(xxx);
这种方法会迫使你手动管理控制器及其所有依赖项的实例化,这在依赖链很长时变得非常繁琐且难以维护。你将不得不模拟所有依赖,而不是仅仅模拟你关心的那一个。
通过客户端请求但无法注入模拟服务:
// 假设在测试类中
$myService = $this->createMock(MyService::class);
$myService->expects($this->once())->method("getInfos")->willReturn(...);
$client->request('GET', '/webhook/new/?RessourceId=1111'); // 此时 MyService 仍是真实服务当你通过$client->request()发起HTTP请求时,Symfony的依赖注入容器会自动解析并注入控制器所需的真实服务实例,而不是你创建的模拟对象。因此,这种方法无法将模拟服务注入到正在运行的控制器中。
为了克服这些局限性,Symfony提供了一种优雅的方式来在测试环境中替换容器中的服务。核心思想是:
下面是具体步骤:
默认情况下,Symfony的服务是私有的,这意味着你无法直接从容器中获取它们(除了通过自动装配)。为了在测试中能够替换它们,你需要显式地将它们设置为公开。这可以通过修改config/services_test.yaml文件来实现:
# config/services_test.yaml
services:
# ... 其他配置
App\Service\MyService: # 替换为你要模拟的服务的完整类名
public: true将MyService(或任何你需要模拟的服务)的public属性设置为true,仅在test环境下生效。这允许你在测试代码中通过self::$container->get()或self::$container->set()来访问和修改这个服务。
在你的测试方法中,首先创建你需要的模拟对象,并定义其行为。然后,使用self::$container->set()方法将这个模拟对象注入到测试容器中,替换掉原始的服务实例。
// tests/Controller/WebhookControllerTest.php
use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
use App\Service\MyService;
use Symfony\Component\BrowserKit\KernelBrowser;
class WebhookControllerTest extends WebTestCase
{
public function testNewWebhookWithResourceId(): void
{
// 确保每次测试都在干净的内核状态下运行
self::ensureKernelShutdown();
/** @var KernelBrowser $client */
$client = static::createClient(); // 使用 static::createClient() 创建客户端
// 1. 创建 MyService 的模拟对象
$myServiceMock = $this->createMock(MyService::class);
// 2. 定义模拟对象的行为
// 模拟 getInfos 方法返回一个包含 infoId 和 owners 的匿名对象
// 确保返回的数据结构与控制器中对 $event 对象的访问方式匹配
$myServiceMock->expects($this->once())
->method("getInfos")
->with(1111) // 期望接收到参数 1111
->willReturn((object)['infoId' => 'mocked_info_id', 'owners' => [456]]);
// 3. 将模拟对象注入到测试容器中,替换掉真实的 MyService
// 必须在发起请求之前完成
self::$container->set(MyService::class, $myServiceMock);
// 4. 发起 HTTP 请求
$client->request('GET', '/webhook/new/?RessourceId=1111');
// 5. 进行断言,验证控制器行为
$this->assertResponseIsSuccessful();
$this->assertJsonStringEqualsJsonString('{}', $client->getResponse()->getContent());
// 可以在此处添加更多断言,例如检查日志、邮件是否被模拟服务调用等
}
public function testNewWebhookWithoutResourceId(): void
{
self::ensureKernelShutdown();
$client = static::createClient();
// 对于不涉及 MyService 的情况,可能不需要模拟,或者模拟其他服务
// 比如 AdminMailer,但此处我们只关注 MyService 的模拟
$client->request('GET', '/webhook/new');
$this->assertResponseIsSuccessful();
$this->assertJsonStringEqualsJsonString('{}', $client->getResponse()->getContent());
}
}一旦模拟服务被注入到容器中,你就可以像往常一样使用$client->request()方法来模拟HTTP请求。此时,当控制器被执行时,它将从容器中获取到你预先设置好的模拟MyService实例,而不是原始的实现。
在Symfony中测试控制器并模拟其依赖服务,尤其是那些涉及外部交互的服务,是确保应用程序健壮性的关键。通过在config/services_test.yaml中将服务设置为公开,并在WebTestCase的测试方法中使用self::$container->set()替换容器中的服务实例,我们可以有效地将模拟服务注入到控制器中。这种方法提供了一种清晰、可维护且高效的方式来对控制器进行集成测试,同时避免了外部依赖带来的复杂性和不确定性。
以上就是在Symfony控制器中测试模拟服务的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号