PersonAward
Описание: Класс для представления награды персоны Представляет информацию о награде, полученной персоной (актером, режиссером и т.д.), включая номинацию, статус победы, связанный фильм и временные метки. Используется для отображения наградной истории персоны.
С версии: 1.0.0
Версия: 1.0.0
См. также:
\KinopoiskDev\Models\Nomination: Для информации о номинации\KinopoiskDev\Models\Movie: Для связанного фильма\KinopoiskDev\Models\Person: Для основной модели персоны
__construct()
Описание: Конструктор для создания объекта награды персоны Создает новый экземпляр класса PersonAward с указанными параметрами. Только personId является обязательным, остальные параметры опциональны.
Параметры:
$personId(int): ID персоны (обязательный параметр)$nomination(Nomination|null): Информация о номинации$winning(bool|null): Статус победы (true - победа, false - номинация)$updatedAt(string|null): Дата последнего обновления записи$createdAt(string|null): Дата создания записи$movie(Movie|null): Связанный фильм за который получена награда
__toString()
Описание: Возвращает строковое представление награды Формирует читаемое представление награды, включающее информацию о номинации, статусе победы и связанном фильме.
Возвращает: string Строковое представление награды
hasInfo()
Описание: Проверяет, установлена ли информация о награде
Возвращает: bool true если есть информация о номинации или статусе победы, иначе false
getWinningStatus()
Описание: Возвращает статус награды в текстовом виде
Возвращает: string Статус награды ("Победа", "Номинация", "Неизвестно")
getMovieTitle()
Описание: Возвращает название связанного фильма
Возвращает: string|null Название фильма за который получена награда или null
fromArray()
Описание: Создает объект PersonAward из массива данных API Фабричный метод для создания экземпляра класса PersonAward из массива данных, полученных от API Kinopoisk.dev. Безопасно обрабатывает отсутствующие значения и преобразует вложенные объекты в соответствующие классы.
- personId: int - ID персоны (обязательно)
- nomination: array|null - данные о номинации
- winning: bool|null - статус победы
- updatedAt: string|null - дата обновления
- createdAt: string|null - дата создания
- movie: array|null - данные о связанном фильме
Параметры:
$data(array): Массив данных о награде персоны от API, содержащий ключи:
Возвращает: \KinopoiskDev\Models\PersonAward Новый экземпляр класса PersonAward с данными из массива
Исключения:
\KinopoiskDev\Exceptions\KinopoiskDevException:
toArray()
Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса PersonAward в массив, совместимый с форматом API Kinopoisk.dev. Используется для сериализации данных при отправке запросов к API или для экспорта данных.
Возвращает: array Массив с данными о награде персоны
isWinning()
Описание: Проверяет, является ли награда победной
Возвращает: bool true если персона победила в номинации, иначе false
isNominationOnly()
Описание: Проверяет, является ли запись только номинацией
Возвращает: bool true если персона была только номинирована, иначе false
validate()
Описание: Валидирует данные модели
Возвращает: bool True если данные валидны