Entity 심화

namespace App\Entities;

use CodeIgniter\Entity\Entity;

class UserEntity extends Entity
{
    // 외부 키 ↔ 내부 속성 매핑 (alias)
    protected $datamap = [
        'email_address' => 'email',
    ];

    // Time 객체로 자동 변환
    protected $dates = ['created_at', 'updated_at', 'deleted_at'];

    // 자동 캐스팅 규칙
    protected $casts = [
        'id'         => 'integer',
        'is_active'  => 'boolean',
        'metadata'   => 'json-array',  // JSON 자동 직렬화/역직렬화
        'tags'       => 'csv',         // CSV → array 자동 변환
        'score'      => 'float',
    ];

    // Virtual property (DB 컬럼 없이 getter로만 존재)
    public function getFullName(): string
    {
        return trim($this->attributes['first_name'] . ' ' . $this->attributes['last_name']);
    }

    // Setter (입력 정규화)
    public function setEmail(string $email): static
    {
        $this->attributes['email'] = strtolower(trim($email));
        return $this;
    }
}

namespace App\Models;

use App\Entities\UserEntity;
use CodeIgniter\Model;

class UserModel extends Model
{
    protected $table      = 'users';
    protected $returnType = UserEntity::class;  // ← 핵심
    // find/findAll 결과가 UserEntity로 반환됨
}

$user = new UserEntity([
    'first_name' => 'john',
    'last_name'  => 'doe',
    'email'      => 'JOHN.DOE@Example.COM',
]);

// Setter 자동 호출
echo $user->email;       // → 'john.doe@example.com'
echo $user->first_name;  // → 'John'

// Virtual property (getter)
echo $user->full_name;   // → 'John Doe' (getFullName 호출)

// Datamap alias
echo $user->email_address; // → 'john.doe@example.com'

// toArray / toRawArray
$user->toArray();    // 캐스팅 적용된 배열
$user->toRawArray(); // 원본 속성 (DB 저장용)