Перейти к содержанию

NominationAward

Описание: Класс для представления награды в номинации Представляет информацию о конкретной награде в рамках номинации, включая название награды и год ее вручения. Используется как часть более крупной структуры номинаций для фильмов и персон.

С версии: 1.0.0

Версия: 1.0.0

См. также:

  • \KinopoiskDev\Models\Nomination: Для полной информации о номинации
  • \KinopoiskDev\Models\MovieAward: Для наград фильмов
  • \KinopoiskDev\Models\PersonAward: Для наград персон

__construct()

Описание: Конструктор для создания объекта награды номинации Создает новый экземпляр класса NominationAward с указанными параметрами. Оба параметра являются опциональными и могут быть null при отсутствии соответствующей информации в источнике данных.

Параметры:

  • $title (string|null): Название награды (например, "Оскар", "Золотой глобус")
  • $year (int|null): Год вручения награды

__toString()

Описание: Возвращает строковое представление награды Формирует читаемое представление награды, включающее название и год вручения, если они доступны.

Возвращает: string Строковое представление награды

fromArray()

Описание: Создает объект NominationAward из массива данных API Фабричный метод для создания экземпляра класса NominationAward из массива данных, полученных от API Kinopoisk.dev. Безопасно обрабатывает отсутствующие значения, устанавливая их в null. - title: string|null - название награды - year: int|null - год вручения награды

Параметры:

  • $data (array): Массив данных о награде от API, содержащий ключи:

Возвращает: \KinopoiskDev\Models\NominationAward Новый экземпляр класса NominationAward с данными из массива

toArray()

Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса NominationAward в массив, совместимый с форматом API Kinopoisk.dev. Используется для сериализации данных при отправке запросов к API или для экспорта данных. - title: string|null - название награды - year: int|null - год вручения награды

Возвращает: array Массив с данными о награде, содержащий ключи:

hasInfo()

Описание: Проверяет, установлена ли информация о награде

Возвращает: bool true если есть название или год, иначе false

validate()

Описание: Валидирует данные модели

Возвращает: bool True если данные валидны