kknongchang_2506/app/Module/Farm/Dtos/HouseRankItemDto.php

<?php

namespace App\Module\Farm\Dtos;

/**
 * 房屋排行榜项目数据传输对象
 */
class HouseRankItemDto
{
    /**
     * 排名
     * @var int
     */
    public int $rank = 0;

    /**
     * 房屋等级
     * @var int
     */
    public int $level = 0;

    /**
     * 财富值（钻石余额）
     * @var int
     */
    public int $wealth = 0;

    /**
     * 用户ID
     * @var int
     */
    public int $userId = 0;

    /**
     * 用户昵称
     * @var string
     */
    public string $nickname = '';

    /**
     * 第几届/赛季
     * @var int
     */
    public int $reason = 1;

    /**
     * 构造函数
     *
     * @param int $rank 排名
     * @param int $level 房屋等级
     * @param int $wealth 财富值
     * @param int $userId 用户ID
     * @param string $nickname 用户昵称
     * @param int $reason 赛季
     */
    public function __construct(int $rank = 0, int $level = 0, int $wealth = 0, int $userId = 0, string $nickname = '', int $reason = 1)
    {
        $this->rank = $rank;
        $this->level = $level;
        $this->wealth = $wealth;
        $this->userId = $userId;
        $this->nickname = $nickname;
        $this->reason = $reason;
    }

    /**
     * 从数据库查询结果创建DTO
     *
     * @param array $data 数据库查询结果
     * @param int $rank 排名
     * @return static
     */
    public static function fromArray(array $data, int $rank): static
    {
        return new static(
            rank: $rank,
            level: $data['house_level'] ?? 0,
            wealth: $data['balance'] ?? 0,
            userId: $data['user_id'] ?? 0,
            nickname: $data['nickname'] ?? '',
            reason: 1
        );
    }
}