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 если данные валидны