kknongchang_2506/app/Module/User/Dto/UserPublicDto.php

<?php

namespace App\Module\User\Dto;

use App\Module\User\Models\UserInfo;
use App\Module\User\Unit\UserPublic;

/**
 * 用户公开信息数据传输对象
 *
 * 用于在服务层返回用户公开信息，避免直接暴露模型对象
 */
class UserPublicDto
{
    /**
     * @var int 用户ID
     */
    public int $userId;

    /**
     * @var string|null 头像
     */
    public ?string $avatar;

    /**
     * @var int 状态
     */
    public int $status;

    /**
     * @var string|null 昵称
     */
    public ?string $nickName;

    /**
     * 从 UserPublic 对象创建 DTO
     *
     * @param UserPublic $userPublic 用户公开信息对象
     * @return self
     */
    public static function fromUserPublic(UserPublic $userPublic): self
    {
        $dto = new self();
        $dto->userId = $userPublic->user_id;
        $dto->avatar = $userPublic->avatar;
        $dto->status = $userPublic->status;
        $dto->nickName = $userPublic->nick_name;

        return $dto;
    }

    /**
     * 从 UserInfo 模型创建 DTO
     *
     * @param UserInfo $userInfo 用户详细信息模型
     * @return self
     */
    public static function fromUserInfo(UserInfo $userInfo): self
    {
        $dto = new self();
        $dto->userId = $userInfo->user_id;
        $dto->avatar = $userInfo->avatar;
        $dto->status = $userInfo->status->value;
        $dto->nickName = $userInfo->nickname;

        return $dto;
    }

    /**
     * 创建已注销用户的 DTO
     *
     * @param int $userId 用户ID
     * @return self
     */
    public static function createDeleted(int $userId): self
    {
        $dto = new self();
        $dto->userId = $userId;
        $dto->avatar = '';
        $dto->status = 0;
        $dto->nickName = '已注销';

        return $dto;
    }

    /**
     * 转换为数组
     *
     * @return array
     */
    public function toArray(): array
    {
        return [
            'user_id' => $this->userId,
            'avatar' => $this->avatar,
            'status' => $this->status,
            'nick_name' => $this->nickName,
        ];
    }
}