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