# 实体常量

实体初始化会校验一些必须定义的常量 const,这是实体对应的数据库表的一些映射,这简化了 ORM 底层后续处理逻辑。

Uses

<?php

use Leevel\Database\Ddd\Entity;
use Leevel\Database\Ddd\GetterSetter;
use Tests\Database\DatabaseTestCase as TestCase;
use Tests\Database\Ddd\Entity\DemoEntity;

# 基本常量

基础常量

常量 TABLE,ID,AUTOSTRUCT 是每一个实体必须要定义的,否则会抛出异常。

  • TABLE 数据库表名,例如 test
  • ID 主键字段,例如 null,id['id1', 'id2']
  • AUTO 自增字段,例如 nullid
  • STRUCT 数据库字段 ['id' => [self::READONLY => true], 'name' => []]

测试模型

namespace Tests\Database\Ddd\Entity;

use Leevel\Database\Ddd\Entity;
use Leevel\Database\Ddd\GetterSetter;

class DemoEntity extends Entity
{
    use GetterSetter;

    const TABLE = 'test';

    const ID = 'id';

    const AUTO = 'id';

    const STRUCT = [
        'id' => [
            self::READONLY => true,
        ],
        'name' => [],
    ];
}
``


``` php
public function testBaseUse(): void
{
    $entity = new DemoEntity();

    $this->assertInstanceof(Entity::class, $entity);

    $this->assertSame(DemoEntity::STRUCT, $entity->fields());
    $this->assertSame(DemoEntity::TABLE, $entity->table());
    $this->assertSame(DemoEntity::ID, $entity->primaryKey());
    $this->assertSame(DemoEntity::AUTO, $entity->autoIncrement());
}

# 基本常量未定义将会抛出异常

测试模型

namespace Tests\Database\Ddd;

class Test1Entity extends Entity
{
    use GetterSetter;
}
public function testConstDefined(): void
{
    $this->expectException(\InvalidArgumentException::class);
    $this->expectExceptionMessage('The entity const TABLE was not defined.');

    $entity = new Test1Entity();
}