Behat扩展如何优雅地管理与加载外部驱动？Bex/Behat-Extension-Driver-Locator帮你实现灵活配置

composer require --dev bex/behat-extension-driver-locator

// src/MyAwesomeBehatExtension/Extension.php

namespace MyAwesomeBehatExtension;

use BexBehatExtensionDriverLocatorDriverNodeBuilder;
use SymfonyComponentConfigDefinitionBuilderArrayNodeDefinition;
use BehatTestworkServiceContainerExtension as ExtensionInterface;
use BehatTestworkServiceContainerExtensionManager;
use SymfonyComponentDependencyInjectionContainerBuilder;

class Extension implements ExtensionInterface
{
    // ... 其他方法 ...

    public function configure(ArrayNodeDefinition $builder)
    {
        // 定义驱动的命名空间和必须实现的接口
        $driverNamespace = 'MyAwesomeBehatExtension\Driver';
        $driverParent = 'MyAwesomeBehatExtension\Driver\MyAwesomeDriverInterface'; // 你的驱动接口

        // 获取 DriverNodeBuilder 实例
        $driverNodeBuilder = DriverNodeBuilder::getInstance($driverNamespace, $driverParent);

        // 构建驱动的配置节点
        // active_my_awesome_drivers: 用于指定当前激活的驱动
        // my_awesome_drivers: 用于存放每个驱动的详细配置
        $driverNodeBuilder->buildDriverNodes(
            $builder,
            'active_my_awesome_drivers', // 用户激活驱动的节点名
            'my_awesome_drivers',        // 驱动详细配置的节点名
            ['default_driver_key']       // 默认激活的驱动键名
        );
    }

    // ... 其他方法 ...
}

# behat.yml
default:
  extensions:
    MyAwesomeBehatExtension: ~ # 默认激活 default_driver_key
    # 或者明确指定激活的驱动和配置
    # MyAwesomeBehatExtension:
    #   active_my_awesome_drivers:
    #     - image_magick_driver # 激活 ImageMagick 驱动
    #     - percy_driver        # 激活 Percy 驱动
    #   my_awesome_drivers:
    #     image_magick_driver:
    #       path: '/usr/local/bin/convert'
    #       diff_threshold: 0.1
    #     percy_driver:
    #       project_token: 'YOUR_PERCY_TOKEN'
    #       branch: 'develop'

// src/MyAwesomeBehatExtension/Extension.php

namespace MyAwesomeBehatExtension;

use BexBehatExtensionDriverLocatorDriverLocator;
use SymfonyComponentDependencyInjectionContainerBuilder;
use BehatTestworkServiceContainerExtension as ExtensionInterface;
use BehatTestworkServiceContainerExtensionManager;

class Extension implements ExtensionInterface
{
    // ... 其他方法 ...

    public function load(ContainerBuilder $container, array $config)
    {
        // 定义驱动的命名空间和必须实现的接口（与 configure 方法中保持一致）
        $driverNamespace = 'MyAwesomeBehatExtension\Driver';
        $driverParent = 'MyAwesomeBehatExtension\Driver\MyAwesomeDriverInterface';

        // 获取 DriverLocator 实例
        $driverLocator = DriverLocator::getInstance($driverNamespace, $driverParent);

        // 获取用户在 behat.yml 中配置的激活驱动列表和详细配置
        $activeDrivers = $config['active_my_awesome_drivers'];
        $driverConfigs = $config['my_awesome_drivers'];

        // 查找并加载激活的驱动
        // $drivers 将是一个包含已实例化驱动对象的数组
        $drivers = $driverLocator->findDrivers($container, $activeDrivers, $driverConfigs);

        // 现在你可以将这些驱动注册到 Behat 的服务容器中，或者直接使用它们
        // 例如，如果你只有一个主驱动，可以这样：
        // $container->set('my_awesome_extension.active_driver', $drivers[0]);

        // 或者，如果你需要所有的驱动，可以遍历它们
        // foreach ($drivers as $driverKey => $driverInstance) {
        //     $container->set('my_awesome_extension.driver.' . $driverKey, $driverInstance);
        // }
    }

    // ... 其他方法 ...
}