自动化测试:六个值得参考的 Laravel 开源项目

2019年3月26日 164点热度 0人点赞 0条评论
图片

点击上方蓝色字体,关注我们


  最近我对自动化测试越来越感兴趣,密切关注着 PHPUnit,TDD,Laravel Dusk,Travis 以及其他测试相关的关键词,所以我决定看看周围其他人是如何做自动化测试的。我在 GitHub 上找到了相当多的 Laravel 开源项目,从里面挑选出了 6 个来查看他们的测试方案。让我们分别看一下。

图片

  免责声明: 我只是查看了完整的基于 Laravel 5.3+ 的 Laravel 项目(不包括依赖包)


1. Laravel.io portal


  URL: https://github.com/laravelio/...

  最近重新启动的 Laravel.io 已经将代码在 GitHub 上开源。Dries Vints 在这个项目中写的测试非常好。

  图片

  Laravel.io 使用功能测试 (Feature testing) 和组件测试 (Component testing)(和单元测试差不多)。有趣的是,在这两种测试中都进行了相同或相似的测试。

  例子 1  tests/Feature/ReplyTest.php

public function users_can_add_a_reply_to_a_thread()

{

factory(Thread::class)->create(['subject' => 'The first thread', 'slug' => 'the-first-thread']);

$this->login();

$this->visit('/forum/the-first-thread')

->type('The first reply', 'body')

->press('Reply')

->see('The first thread')

->see('The first reply')

->see('Reply successfully added!');

}

  例子 2  tests/Components/Jobs/CreateReplyTest.php

public function we_can_create_a_reply()

{

$job = new CreateReply('Foo', '', $this->createUser(), factory(Thread::class)->create());

$this->assertInstanceOf(Reply::class, $job->handle());

}

  这样做很好: 同时测试 Jobs 层和实际在浏览器中点击一些东西。

  我还注意到 Laravel.io 已经升级到了 Laravel 5.4, 但是测试套件仍然使用的是5.3的风格, 使用 BrowserKitTestCase implementation。 这没有什么问题,仅仅是一个提醒。

  这个项目也使用了 Travis 进行持续集成, 后来我发现大多数项目都使用了它。

2. Cachet —— 一个开源状态页面系统

  URL: https://github.com/cachethq/C...

  在 James Brooks 和 Graham Campbell 的带领下,这个项目有一个庞大的测试组件。他甚至通过观察表层很难理解。

  图片

  所以,我们从哪里开始... 事实上,我甚至不会深度燕郊这个项目的测试逻辑, 因为他太难理解了,这是一个例子 —— tests/Models/ComponentTest.php:

use AltThree\TestBench\ValidationTrait;

use CachetHQ\Cachet\Models\Component;

use CachetHQ\Tests\Cachet\AbstractTestCase;

class ComponentTest extends AbstractTestCase

{

use ValidationTrait;

public function testValidation()

{

$this->checkRules(new Component());

}

}

  好吧,这里用到了 ValidationTrait,然后是一些 AbstractTestCase。同时这段逻辑是所有的测试 ,一些抽象的 "魔术" 正在执行所有的工作。

  我不是说这是坏事 ,十分确定他在内在的东西里工作的很好。他只是不容易先学习和遵循。但如果有人想深入研究 —— 祝好运!

3. October CMS

  URL: https://github.com/octobercms...

  市场上第一款基于 Laravel 的 CMS,他拥有非常不错的测试组件。

  图片

  首先 , tests 文件夹有一个 真正信息详实的 readme.md 文件,专门用于测试过程。

  October CMS 的所有测试包括:

  • 单元测试

  • 功能测试

  • 插件测试

  每个 "区域" 都有对应的基类来扩展 —— 有 TestCase,UiTestCase 和 PluginTestCase。

  逻辑也非常复杂和抽象 ,这里有一个例子 tests/unit/backend/models/ExportModelTest.php:

class ExportModelTest extends TestCase

{

//

// 辅助

//

protected static function callProtectedMethod($object, $name, $params = [])

{

$className = get_class($object);

$class = new ReflectionClass($className);

$method = $class->getMethod($name);

$method->setAccessible(true);

return $method->invokeArgs($object, $params);

}

//

// 测试

//

public function testEncodeArrayValue()

{

$model = new ExampleExportModel;

$data = ['foo', 'bar'];

$result = self::callProtectedMethod($model, 'encodeArrayValue', [$data]);

$this->assertEquals('foo|bar', $result);

$data = ['dps | heals | tank', 'paladin', 'berserker', 'gunner'];

$result = self::callProtectedMethod($model, 'encodeArrayValue', [$data]);

$this->assertEquals('dps \| heals \| tank|paladin|berserker|gunner', $result);

$data = ['art direction', 'roman empire', 'sci-fi'];

$result = self::callProtectedMethod($model, 'encodeArrayValue', [$data, '-']);

$this->assertEquals('art direction-roman empire-sci\-fi', $result);

}

}

  如你所见,这里有一个静态辅助方法(顺便说一下,在其他类中重复使用),然后获取类/方法并调用他啊, 我确信作者能立即理解逻辑,但这对外人来说很困难。

  同样有趣的是,OctoberCMS 使用 Selenium 来获取一些功能:tests/readme.md 文件提到了设置文档。

4. Orgmanager —— GitHub 组织的邀请系统

  URL: https://github.com/orgmanager...

  这是 Miguel Piedrafita 的一个非常简单的项目,Orgmanager 的测试也是非常简单易懂的。还分为单元,功能和 API 测试。

  图片

  我在这里看到一个有趣的示例 —— 从测试中调用 Artisan 命令,例如 unit/JoinTest.php:

public function testJoinCommand()

{

$user = factory(User::class)->create();

$org = factory(Org::class)->create([

'userid' => $user->id,

]);

Github::shouldReceive('authenticate')

->once()

->with($org->user->token, null, 'http_token')

->andReturn();

Artisan::call('orgmanager:joinorg', [

'org'      => $org->id,

'username' => $user->github_username,

]);

$this->assertEquals($user->github_username.' was invited to '.$org->name."\n", Artisan::output());

}

  调用 artisan 命令并断言其输出非常有趣。我确定他有效,但这是非标准的方式。

5. PHPMap

  URL: https://github.com/PHPMap/phpmap

  由 Florian Wartner 创建及维护。

  图片

  PHPMap 有一个测试组件,使人联想到 Laracasts 或 测试驱动 Laravel 课程 讲述的标准。这是 Feature/FavoritesTest.php 的例子。

public function guests_can_not_favorite_anything()

{

$this->withExceptionHandling()

->post('forum/replies/1/favorites')

->assertRedirect('/login');

}

public function an_authenticated_user_can_favorite_any_reply()

{

$this->signIn();

$reply = create('App\Models\Forum\Reply');

$this->post('forum/replies/'.$reply->id.'/forum/favorites');

$this->assertCount(1, $reply->favorites);

}

  PHPMap 的测试分为单元,功能及 Laravel Dusk 等等!最后我发现了一个真正在生产环境使用 Dusk 的项目。这是他的门面, tests/Browser/MapTest.php:

public function testMap()

{

$this->browse(function ($browser) {

$browser->visit('/map')

->assertSee('PHPMap');

});

}

6. Timegrid —— 免费,开源,在线操作平台

  URL: https://github.com/timegridio...

  Timegrid 的最大贡献者是 Ariel Vallese,同时他在测试方面做了非常好的工作。

 图片

  这里只有很多的测试: 单元,验收和集成,每个文件都有更深的子文件夹目录,例如: acceptance/scenarios/consulting/ConsultingScenarioTest.php:

public function it_fits_for_consulting_scenario()

{

$this->arrangeScenario();

$this->the_business_publishes_a_consulting_service();

$this->the_business_publishes_vacancies();

$this->a_user_subscribes_to_business();

$this->the_user_queries_vacancies();

$this->it_provides_available_times_for_requested_service_date();

$this->the_user_takes_a_reservation();

$this->the_user_sees_the_reservation_ticket();

}

public function the_business_publishes_a_consulting_service()

{

$this->service = $this->makeService([

'name'     => 'OnSite 4hs Support',

'duration' => 60 * 4,

]);

$this->actingAs($this->owner);

$this->call('POST', route('manager.business.service.store', $this->business), $this->service->toArray());

$this->assertCount(1, $this->business->fresh()->services);

}

  一个一体化的方法,之后是一个个列举更多的测试:

  仓库中的官方统计数据看起来非常好: 89% 的测试覆盖率。

  最后,有趣的是,作者甚至测试了迁移文件,如 tests/unit/migration/MigrationTest.php:

public function it_refreshes_rollbacks_and_seeds_the_database()

{

$database = env('DB_CONNECTION');

$this->assertNotNull($database);

$exitCode = Artisan::call('migrate:refresh', ['--database' => $database]);

$this->assertEquals(0, $exitCode);

$exitCode = Artisan::call('migrate:rollback', ['--database' => $database]);

$this->assertEquals(0, $exitCode);

$exitCode = Artisan::call('migrate', ['--database' => $database]);

$this->assertEquals(0, $exitCode);

$exitCode = Artisan::call('db:seed', ['--database' => $database]);

$this->assertEquals(0, $exitCode);

}

  在测试中使用 Artisan 命令或许不是最佳的设计模式,但他只是测试任何 web 应用中最重要的功能之一。

总体结论

  在看过所有这些不同的项目之后(以及由于各种原因未提及的),以下是我对自己关于测试的主要要求:

  不在 单元 "或" 功能 中做选择,大多数项目两者兼具,或者更多类型的测试;

  大多数项目使用持续集成(通常是 Travis)和测试组件否则,为什么反感写测试呢?

  这里有非常多的不同方式构建测试,这完全取决于项目,这里没有“高招”;

  还有很多方法对内部测试功能分组 ,辅助方法,抽象类,种子数据等。没有具体规则,找准适用于你的内容。

  迁移到较新版本的 Laravel 可能很痛苦, 例如,5.3 版本的测试看上去和 5.4 版本不一样。所以你需要提前考虑更新。

  从不同角度考虑,当你的项目成长起来,你将不得不回看及修改/添加测试。在这些项目中,我”预感“有一些遗留代码,只是因为有些测试将不在被使用。

  以上是我的经验,有没有你要添加到开源项目列表中来学习测试的内容?

图片
推荐阅读

点击阅读☞Mocha+should+Karma自动化测试教程

点击阅读☞再谈自动化测试——我们在编写测试时,应该注意什么?

点击阅读☞自动化测试Selenium在小公司的成功实践

点击阅读☞从头写一个 Selenium + Cucumber 的自动化测试

点击阅读☞去哪儿网 HTTP 接口自动化测试实践

上文内容不用于商业目的,如涉及知识产权问题,请联系小编(021-64471599-8017)。

图片
“阅读原文”一起来充电吧!
在看点一下 大家都知道
图片
14730自动化测试:六个值得参考的 Laravel 开源项目

root

这个人很懒,什么都没留下

文章评论