包简介

Component to help in self testing Behat extension development

README 文档

README

Behat Test Runner is essentially a Behat context class which provides steps for testing a Behat extension. You can put together a feature file and behat.yml configuration, than the test runner will start a second Behat process to evaluate the created feature file. This a fork of the original test suite which is used in the Magento2 Behat Extension. Differently to the original version, this fork is not supporting outdated PHP versions with the exception of PHP 7.4 and many projects still running on it.

Installation

Install by adding to your composer.json:

composer require --dev seec/behat-test-runner

Configuration

Include the context file in behat.yml like this:

default:
  suites:
    default:
      contexts:
        - SEEC\BehatTestRunner\Context\TestRunnerContext

You can configure the working directory like this (optional):

default:
  suites:
    default:
      contexts:
        - SEEC\BehatTestRunner\Context\TestRunnerContext:
            workingDirectory: path/to/your/working/dir # if not provided then a temporary working dir is autogenerated

Usage

Simply use the necessary steps from the context file to put together your feature.

An example:

Feature: Visiting a page on the website
  In order to demonstrate how to use test runner
  As a developer
  I should open a page and verify the content of it

  Background:
    Given I have the file "index.html" in document root:
            """
            <!DOCTYPE html>
            <html>
              <head>
                  <meta charset="UTF-8">
                  <title>Test page</title>
              </head>
              <body>
                  <h1>Lorem ipsum dolor amet.</h1>
              </body>
            </html>
            """
    And I have a web server running on host "localhost" and port "8080"
    And I have the feature:
            """
            Feature: Test runner demo feature
              Scenario:
                Given I open the index page
                Then I should see the content "Lorem ipsum" on the page in a h1 HTML tag
            """
    And I have the context:
            """
            <?php

            declare(strict_types=1);

            use Behat\Behat\Context\Context;
            use Webmozart\Assert\Assert;

            include '/var/www/html/vendor/autoload.php';

            final class FeatureContext implements Context
            {
                private array $clipboard = [];

                /**
                 * @return mixed
                 */
                private function get(string $key)
                {
                    Assert::keyExists($this->clipboard, $key, sprintf('Key "%s" does not exist in clipboard', $key));

                    return $this->clipboard[$key];
                }

                /**
                 * @var mixed $value
                 */
                private function set(string $key, $value)
                {
                    $this->clipboard[$key] = $value;
                }

                /**
                 * @Given I open the index page
                 */
                function firstStep()
                {
                    $curl = curl_init();
                    curl_setopt($curl, CURLOPT_URL, "http://localhost:8080/");
                    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
                    $response = curl_exec($curl);
                    Assert::notNull($response, 'Response is null: ' . curl_error($curl));
                    $this->set('response', $response);
                    curl_close($curl);
                }

                /**
                 * @Then I should see the content :content on the page in a :tagName HTML tag
                 */
                function secondStep(string $content, string $tagName)
                {
                    $lastResponse = $this->get('response');
                    Assert::notNull($lastResponse, 'Response is null');

                    $pattern = '/<' . $tagName . '.*?>(.*?)<\/' . $tagName . '>/si';
                    preg_match($pattern, $lastResponse, $matches);
                    Assert::notSame(0, count($matches), 'No matches found');
                    Assert::notFalse(strpos($matches[1], $content), 'Content not found in tag');
                }
            }
            """

  Scenario: Visiting the index.html page
    When I run Behat
    Then I should not see a failing test

seec/behat-test-runner 适用场景与选型建议

seec/behat-test-runner 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 138 次下载、GitHub Stars 达 0，最近一次更新时间为 2023 年 06 月 24 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「BDD」「Behat」「TDD」「extension」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 seec/behat-test-runner 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 seec/behat-test-runner 我们能提供哪些服务？

定制开发 / 二次开发

基于 seec/behat-test-runner 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发