Laravel Eloquent 模型单元测试

Question

我正在尝试编写一个测试用例，用于测试 Laravel 4.2 中两个 Eloquent 模型之间关系的关联和分离

这是我的测试用例：

class BookingStatusSchemaTest extends TestCase
{

  private $statusText = "Confirmed";
  private $bookingStub;
  private $statusStub;

  public function testMigrateService()
  {

    $this->createTestData();

    $booking = $this->bookingStub;
    $status = $this->statusStub;

    /**
     * Check that the booking has no status. OK
     */
    $this->assertNull($booking->status);

    /**
     * Check that status has no booking. OK
     */
    $this->assertEquals(count($status->bookings), 0);

    /**
     * Add a status to the booking. OK
     */
    $booking->status()->associate($this->statusStub);

    /**
     * Check that status has a booking. NOT OK - This gives error
     */
    $this->assertEquals(count($status->bookings), 1);

    /**
     * Check that the booking has a status. OK
     */
    $this->assertNotNull($booking->status);

    /**
     * Do NOT delete the status, just set the reference
     * to it to null.
     */
    $booking->status = null;

    /**
     * And check again. OK
     */
    $this->assertNull($booking->status);
  }

  private function createTestData()
  {

    $bookingStatus = BookingStatus::create([ 
        'status' => $this->statusText 
    ]);

    $booking = Booking::create([ ]);

    $this->bookingStub = $booking;
    $this->statusStub = $bookingStatus;

  }

}

当我执行它时，我得到：

There was 1 failure:

1) BookingStatusSchemaTest::testMigrateService
Failed asserting that 1 matches expected 0.

预订模式：

class Booking extends Eloquent {

  /**
  * A booking have a status
  */
  public function status()
  {
    return $this->belongsTo('BookingStatus');
  }

}

BookingStatus 模型：

class BookingStatus extends Eloquent
{
  protected $table = 'booking_statuses';
  protected $guarded = [ 'id' ];
  protected $fillable = ['status'];

  /**
   * A booking status belongs to a booking
   */
  public function bookings()
  {
    return $this->hasMany('Booking');
  }

}

这是预订状态的迁移架构：

  Schema::create('booking_statuses', function(Blueprint $table)
  {
    $table->increments('id');
    $table->string('status');
    $table->timestamps();
  });

这里是预订：

Schema::create('bookings', function(Blueprint $table)
{
  $table->increments('id');
  $table->unsignedInteger('booking_status_id')->nullable();
  $table->timestamps();
});

我必须添加/更改什么才能验证我的测试用例中的关系？

Answer 1

要测试您是否设置了正确的 Eloquent 关系，您必须针对关系类 ($model->relation()) 运行断言。 你可以断言

• 通过断言$model->relation() 是HasMany、BelongsTo、HasManyThrough...等的实例，这是正确的关系类型
• 使用$model->relation()->getRelated()与正确的模型有关
• 通过$model->relation()->getForeignKey() 使用正确的外键
• 通过使用Schema::getColumListing($table)，外键作为列存在于表中（这里，$table 是$model->relation()->getRelated()->getTable()，如果它是HasMany 关系或$model->relation()->getParent()->getTable()，如果它是BelongsTo 关系）李>

例如。假设您有一个Parent 和一个Child 模型，其中Parent 通过children() 方法使用parent_id 作为外键有许多Child。 Parent 映射parents 表，Child 映射children 表。

$parent = new Parent;
# App\Parent
$parent->children()
# Illuminate\Database\Eloquent\Relations\HasMany
$parent->children()->getRelated()
# App\Child
$parent->children()->getForeignKey()
# 'parent_id'
$parent->children()->getRelated()->getTable()
# 'children'
Schema::getColumnListing($parent->children()->getRelated()->getTable())
# ['id', 'parent_id', 'col1', 'col2', ...]

编辑 此外，这不会触及数据库，因为我们从不保存任何内容。但是，需要迁移数据库，否则模型将不会与任何表关联。

Answer 2

已经有一段时间了，我完全忘记了这个问题。 由于OP仍然对此感兴趣，我将尝试回答这个问题 以某种方式。

所以我假设实际任务是：如何测试两个 Eloquent 模型之间的正确关系？

我认为是 Adam Wathan 首先建议放弃“单元测试”、“功能测试”和“我不知道这是什么意思的测试”等术语，而只是将测试分成两个关注点/概念：Features and Units，Features 简单描述应用程序的功能，例如“登录用户可以预订机票”，Units 描述其较低级别的 Units 及其公开的功能，例如“A booking has a status” .

我非常喜欢这种方法，考虑到这一点，我想重构您的测试：

class BookingStatusSchemaTest extends TestCase
{
    /** @test */
    public function a_booking_has_a_status()
    {
        // Create the world: there is a booking with an associated status
        $bookingStatus = BookingStatus::create(['status' => 'confirmed']);
        $booking = Booking::create(['booking_status_id' => $bookingStatus->id]);

        // Act: get the status of a booking
        $actualStatus = $booking->status;

        // Assert: Is the status I got the one I expected to get?
        $this->assertEquals($actualStatus->id, $bookingStatus->id);
    }


    /** @test */    
    public function the_status_of_a_booking_can_be_revoked()
    {
        // Create the world: there is a booking with an associated status
        $bookingStatus = BookingStatus::create(['status' => 'confirmed']);
        $booking = Booking::create(['booking_status_id' => $bookingStatus->id]);

        // Act: Revoke the status of a booking, e.g. set it to null
        $booking->revokeStatus();

        // Assert: The Status should be null now
        $this->assertNull($booking->status);
    }
}

此代码未经测试！

请注意函数名称读起来就像是对预订及其功能的描述。您并不真正关心实施，您不必知道 Booking 在何处或如何获得其 BookingStatus - 您只需确保如果存在带有 BookingStatus 的 Booking，您可以获得该 BookingStatus。或者撤销它。或者也许改变它。或者做任何事。您的测试显示了您希望如何与该单元进行交互。所以编写测试，然后尝试使其通过。

你的测试中的主要缺陷可能是你有点“害怕”一些魔法发生。相反，请将您的模型视为普通的旧 PHP 对象——因为它们就是这样！而且你不会在 POPO 上运行这样的测试：

/**
 * Do NOT delete the status, just set the reference
 * to it to null.
 */
$booking->status = null;

/**
 * And check again. OK
 */
$this->assertNull($booking->status);

这是一个非常广泛的话题，每个关于它的声明都不可避免地被认为是。有一些指导方针可以帮助你相处，比如“只测试你自己的代码”，但是很难把所有的和平放在一起。幸运的是，前面提到的 Adam Wathan 有一个非常出色的视频课程，名为“Test Driven Laravel”，他在其中测试了整个真实世界的 Laravel 应用程序。这可能有点贵，但值得每一分钱，并且比 StackOverflow 上的一些随机家伙更能帮助您了解测试方式:)