>  기사  >  백엔드 개발  >  Laravel, BDD, 그리고 여러분부터 시작하겠습니다.

Laravel, BDD, 그리고 여러분부터 시작하겠습니다.

WBOY
WBOY원래의
2023-09-01 18:09:121418검색

让我们从 Laravel、BDD 和你开始

행동 중심 개발(BDD) 방법을 사용하여 Laravel 애플리케이션을 개발하는 방법에 대한 시리즈에 오신 것을 환영합니다. 풀 스택 BDD는 복잡하고 위협적으로 보일 수 있습니다. 이를 달성하는 방법은 개발자 수만큼 많습니다.

이 시리즈에서는 Behat과 PhpSpec을 사용하여 Laravel 애플리케이션을 처음부터 디자인하는 과정을 안내해 드리겠습니다.

일반적으로 BDD에 관한 자료는 많지만 Laravel 관련 자료는 찾기 어렵습니다. 따라서 이 시리즈에서는 다른 곳에서 읽을 수 있는 일반적인 내용보다는 Laravel과 관련된 측면에 더 중점을 둘 것입니다.

행동 설명

행동을 설명할 때(스토리 및 사양 작성이라고도 함) 우리는 외부-내부 접근 방식을 사용합니다. 이는 새로운 기능을 구축할 때마다 전체 사용자 스토리를 작성하는 것부터 시작한다는 의미입니다. 이는 일반적으로 고객이나 이해관계자의 관점에서 발생합니다.

이 일을 하면 어떤 일이 일어날 것으로 예상되나요? 块引用>

기존 코드를 리팩토링하지 않는 한, 실패한 빨간색 단계에 도달하지 않는 한 어떤 코드도 작성할 수 없습니다.

때때로 우리가 작업 중인 스토리나 기능(두 단어를 같은 의미로 사용함)의 작은 부분을 반복적으로 다루어야 할 필요가 있습니다. 이는 일반적으로 PhpSpec을 사용하여 사양을 작성하는 것을 의미합니다. 때로는 전체 스토리가 (수용 수준에서) 전달되기 전에 통합 또는 단위 수준에서 여러 번의 반복이 필요합니다. 이 모든 것이 복잡해 보이지만 그렇지 않습니다. 나는 행동을 통해 배우는 것을 굳게 믿으므로, 실제 코드를 작성하기 시작하면 모든 것이 더 이해가 될 것이라고 생각합니다.

우리는 네 가지 수준에서 스토리와 사양을 작성합니다:

1. 수락

대부분의 경우 기능 모음이 수용 레이어 역할을 합니다. 기능 모음의 기능을 설명하는 방식은 승인 사례를 작성하는 방식(자동 브라우저 프레임워크 사용)과 매우 유사하므로 중복되는 부분이 많습니다.

고객의 관점에서 행동을 설명하는 스토리라면 수용 스토리가 될 수 있습니다. Symfony DomCrawler를 사용하여 애플리케이션의 출력을 테스트하겠습니다. 이 시리즈의 후반부에서는 JavaScript를 실행할 수 있는 실제 브라우저로 테스트해야 한다는 사실을 알게 될 수도 있습니다. 브라우저를 통한 테스트는 몇 가지 새로운 문제를 추가합니다. 제품군이 실행되는 동안 시간별 테스트 환경이 로드되는지 확인해야 하기 때문입니다.

2. 기능성

우리의 기능 모음에서는 매우 편리한 Laravel 애플리케이션에 액세스할 수 있습니다. 첫째, 환경을 쉽게 구분할 수 있습니다. 둘째, 브라우저를 거치지 않으면 테스트 스위트가 더 빨라집니다. 새로운 기능을 구현하고 싶을 때마다 Behat을 사용하여 기능 제품군에 스토리를 작성합니다.

3. 통합

저희 통합 제품군은 Laravel에 대한 액세스가 반드시 필요하지 않은 애플리케이션 핵심 부분의 동작을 테스트합니다. 통합 제품군은 Behat 스토리와 PhpSpec 사양이 혼합된 경우가 많습니다.

4. 유닛

우리의 단위 테스트는 PhpSpec으로 작성되며 애플리케이션 핵심의 독립적인 작은 단위를 테스트합니다. 엔터티, 값 개체 등에는 모두 사양이 있습니다.

케이스

이 시리즈에서는 다음 글부터 시간을 추적하는 시스템을 구축해 보겠습니다. 먼저 Behat 특성을 작성하여 외부 동작을 설명하겠습니다. 우리 애플리케이션의 내부 동작은 PhpSpec을 사용하여 설명됩니다.

이 두 도구를 함께 사용하면 우리가 구축 중인 애플리케이션의 품질에 만족감을 느끼는 데 도움이 될 것입니다. 우리는 주로 세 가지 수준으로 기능과 사양을 작성합니다:

  1. 기능성
  2. 통합
  3. 유닛

우리 기능 제품군에서는 헤드리스 모드에서 애플리케이션의 HTTP 응답을 캡처합니다. 즉, 브라우저를 거치지 않습니다. 이를 통해 Laravel과 더 쉽게 상호 작용할 수 있으며 우리의 기능 모음이 수용 레이어 역할도 할 수 있습니다.

나중에 UI가 더 복잡해지고 JavaScript도 테스트해야 하는 경우 전용 수용 제품군을 추가할 수 있습니다. 이 시리즈는 아직 진행 중인 작업이므로 댓글 섹션에 자유롭게 제안 사항을 남겨주세요.

우리의 설정

이 튜토리얼에서는 Laravel(4.2)을 새로 설치하고 실행하고 있다고 가정합니다. 제가 이 코드를 작성하는 동안 사용한 Laravel Homestead도 함께 사용하시면 가장 좋습니다.

실제 작업을 시작하기 전에 Behat과 PhpSpec이 실행되고 있는지 확인하세요. 우선, 저는 새로운 Laravel 프로젝트를 시작할 때마다 약간의 정리 작업을 하고 필요하지 않은 것들을 제거하는 것을 좋아합니다:

으아아아

이러한 파일을 삭제하는 경우 그에 따라 composer.json 파일을 업데이트해야 합니다.

으아아아

물론이죠:

으아아아

이제 필요한 BDD 도구를 소개할 준비가 되었습니다. require-dev 部分添加到您的 composer.json:

require-dev 섹션을 추가하세요.
"require": {
    "laravel/framework": "4.2.*"
},
"require-dev": {
    "behat/behat": "~3.0",
    "phpspec/phpspec": "~2.0",
    "phpunit/phpunit": "~4.1"
},

“我们为什么要引入 PHPUnit?”你可能在想?在本系列中,我们不会编写优秀的 PHPUnit 测试用例,但断言与 Behat 一起是一个方便的工具。我们将在本文后面编写第一个功能时看到这一点。

请记住在修改 composer.json 后更新依赖项:

$ composer update --dev

我们即将完成安装和设置。 PhpSpec 开箱即用:

$ vendor/bin/phpspec run

0 specs
0 examples 
0ms

但是 Behat 需要使用 --init 选项快速运行才能设置所有内容:

$ vendor/bin/behat --init

+d features - place your *.feature files here
+d features/bootstrap - place your context classes here
+f features/bootstrap/FeatureContext.php - place your definitions, transformations and hooks here

$ vendor/bin/behat

No scenarios
No steps
0m0.14s (12.18Mb)

第一个命令创建了一个闪亮的新 FeatureContext 类,我们可以在其中编写功能所需的步骤定义:

<?php

use Behat\Behat\Context\SnippetAcceptingContext;
use Behat\Gherkin\Node\PyStringNode;
use Behat\Gherkin\Node\TableNode;

/**
 * Behat context class.
 */
class FeatureContext implements SnippetAcceptingContext
{
    /**
     * Initializes context.
     *
     * Every scenario gets its own context object.
     * You can also pass arbitrary arguments to the context constructor through behat.yml.
     */
    public function __construct()
    {
    }
}

编写我们的第一个功能

我们的第一个功能非常简单:我们只需确保新的 Laravel 安装以“您已到达”来迎接我们。在主页上。我还添加了一个相当愚蠢的 Given 步骤,假设我登录了 ,这仅用于显示在我们的功能中与 Laravel 交互是多么容易。

从技术上讲,我将这种类型的功能归类为功能测试,因为它与框架交互,但它也可以作为验收测试,因为我们不会看到通过浏览器测试运行类似测试有任何不同的结果工具。现在我们将坚持使用我们的功能测试套件。

继续创建一个 welcome.feature 文件并将其放入 features/functions:

# features/functional/welcome.feature

Feature: Welcoming developer
    As a Laravel developer
    In order to proberly begin a new project
    I need to be greeted upon arrival

    Scenario: Greeting developer on homepage
        Given I am logged in
        When I visit "/"
        Then I should see "You have arrived."

通过将功能特性放在 featured 目录中,我们以后可以更轻松地管理我们的套件。我们不希望不需要 Laravel 的集成类型功能必须等待缓慢的功能套件。

我喜欢让事情保持美观和干净,所以我相信我们应该为我们的功能套件提供一个专用的功能上下文,以便我们可以访问 Laravel。您可以继续复制现有的 FeatureContext 文件并将类名称更改为 LaravelFeatureContext。为此,我们还需要一个 behat.yml 配置文件。

在项目的根目录中创建一个并添加以下内容:

default:
    suites:
        functional:
            paths: [ %paths.base%/features/functional ]
            contexts: [ LaravelFeatureContext ]

我认为这里的 YAML 是非常不言自明的。我们的功能套件将在 functioning 目录中查找功能,并通过 LaravelFeatureContext 运行它们。

如果我们此时尝试运行 Behat,它会告诉我们实现必要的步骤定义。我们可以使用以下命令让 Behat 将空脚手架方法添加到 LaravelFeatureContext 中:

$ vendor/bin/behat --dry-run --append-snippets
$ vendor/bin/behat

Feature: Welcoming developer
    As a Laravel developer
    In order to proberly begin a new project
    I need to be greeted upon arival

  Scenario: Greeting developer on homepage # features/functional/welcome.feature:6
    Given I am logged in                   # LaravelFeatureContext::iAmLoggedIn()
      TODO: write pending definition
    When I visit "/"                       # LaravelFeatureContext::iVisit()
    Then I should see "You have arrived."  # LaravelFeatureContext::iShouldSee()

1 scenario (1 pending)
3 steps (1 pending, 2 skipped)
0m0.28s (12.53Mb)

现在,正如您从输出中看到的那样,我们已准备好开始实施第一个步骤:鉴于我已登录

Laravel 附带的 PHPUnit 测试用例允许我们执行诸如 $this->be($user) 之类的操作,它会登录给定用户。最终,我们希望能够像使用 PHPUnit 一样与 Laravel 交互,所以让我们继续编写“我们希望拥有”的步骤定义代码:

/**
 * @Given I am logged in
 */
public function iAmLoggedIn()
{
    $user = new User;

    $this->be($user);
}

这当然行不通,因为 Behat 不知道 Laravel 的具体内容,但我很快就会向您展示让 Behat 和 Laravel 很好地协同工作是多么容易。

如果您查看 Laravel 源代码并找到 Illuminate\Foundation\Testing\TestCase 类(默认测试用例扩展自该类),您会发现从 Laravel 4.2 开始,一切都已更改转移到一个特质。 ApplicationTrait 现在负责启动 Application 实例、设置 HTTP 客户端并为我们提供一些辅助方法,例如 be()

这非常酷,主要是因为这意味着我们可以将其拉入我们的 Behat 上下文中,几乎不需要任何设置。我们还可以访问 AssertionsTrait,但这仍然与 PHPUnit 相关。

当我们引入特征时,我们需要做两件事。我们需要一个 setUp() 方法,如 Illuminate\Foundation\Testing\TestCase 类中的方法,并且需要一个 createApplication() 方法,如默认 Laravel 测试用例中的方法。其实我们直接复制这两个方法就可以了。

只有一件事需要注意:在 PHPUnit 中,方法 setUp() 会在每次测试之前自动调用。为了在 Behat 中实现相同的效果,我们可以使用 @BeforeScenario 注释。

将以下内容添加到您的 LaravelFeatureContext

use Illuminate\Foundation\Testing\ApplicationTrait;

/**
 * Behat context class.
 */
class LaravelFeatureContext implements SnippetAcceptingContext
{
    /**
     * Responsible for providing a Laravel app instance.
     */
    use ApplicationTrait;

    /**
     * Initializes context.
     *
     * Every scenario gets its own context object.
     * You can also pass arbitrary arguments to the context constructor through behat.yml.
     */
    public function __construct()
    {
    }

    /**
     * @BeforeScenario
     */
    public function setUp()
    {
        if ( ! $this->app)
        {
            $this->refreshApplication();
        }
    }

    /**
     * Creates the application.
     *
     * @return \Symfony\Component\HttpKernel\HttpKernelInterface
     */
    public function createApplication()
    {
        $unitTesting = true;

        $testEnvironment = 'testing';

        return require __DIR__.'/../../bootstrap/start.php';
    }

非常简单,看看我们运行 Behat 时得到的结果:

$ vendor/bin/behat

Feature: Welcoming developer
    As a Laravel developer
    In order to proberly begin a new project
    I need to be greeted upon arival

  Scenario: Greeting developer on homepage # features/functional/welcome.feature:6
    Given I am logged in                   # LaravelFeatureContext::iAmLoggedIn()
    When I visit "/"                       # LaravelFeatureContext::iVisit()
      TODO: write pending definition
    Then I should see "You have arrived."  # LaravelFeatureContext::iShouldSee()

1 scenario (1 pending)
3 steps (1 passed, 1 pending, 1 skipped)
0m0.73s (17.92Mb)

绿色的第一步,这意味着我们的设置正在运行!

接下来,我们可以实现 当我访问 步骤。这个非常简单,我们可以简单地使用 ApplicationTrait 提供的 call() 方法。一行代码即可实现:

/**
 * @When I visit :uri
 */
public function iVisit($uri)
{
    $this->call('GET', $uri);
}

最后一步,然后我应该看到,需要更多一点,我们需要引入两个依赖项。我们需要 PHPUnit 来进行断言,并且需要 Symfony DomCrawler 来搜索“您已到达”。文本。

我们可以这样实现:

use PHPUnit_Framework_Assert as PHPUnit;
use Symfony\Component\DomCrawler\Crawler;

...

/**
 * @Then I should see :text
 */
public function iShouldSee($text)
{
    $crawler = new Crawler($this->client->getResponse()->getContent());

    PHPUnit::assertCount(1, $crawler->filterXpath("//text()[. = '{$text}']"));
}

这与您使用 PHPUnit 时编写的代码几乎相同。 filterXpath() 部分有点令人困惑,我们现在不用担心它,因为它有点超出了本文的范围。请相信我,它有效。

最后一次跑步是个好消息:

$ vendor/bin/behat
Feature: Welcoming developer
    As a Laravel developer
    In order to proberly begin a new project
    I need to be greeted upon arival

  Scenario: Greeting developer on homepage # features/functional/welcome.feature:6
    Given I am logged in                   # LaravelFeatureContext::iAmLoggedIn()
    When I visit "/"                       # LaravelFeatureContext::iVisit()
    Then I should see "You have arrived."  # LaravelFeatureContext::iShouldSee()

1 scenario (1 passed)
3 steps (3 passed)
0m0.82s (19.46Mb)

该功能正在按预期工作,并且开发人员在抵达时受到欢迎。

结论

完整的 LaravelFeatureContext 现在应该与此类似:

call('GET', $uri);
    }

    /**
     * @Then I should see :text
     */
    public function iShouldSee($text)
    {
        $crawler = new Crawler($this->client->getResponse()->getContent());

        PHPUnit::assertCount(1, $crawler->filterXpath("//text()[. = '{$text}']"));
    }
}

随着我们继续使用 BDD 开发新的 Laravel 应用程序,我们现在已经有了一个非常好的基础。我希望我已经向您证明了让 Laravel 和 Behat 很好地协同工作是多么容易。

我们在第一篇文章中讨论了许多不同的主题。不用担心,随着本系列的继续,我们将更深入地研究一切。如果您有任何问题或建议,请留言。

위 내용은 Laravel, BDD, 그리고 여러분부터 시작하겠습니다.의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.