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

SearchMovie

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

С версии: 1.0.0

Версия: 1.0.0

См. также:

  • \KinopoiskDev\Models\Movie: Для полной информации о фильме
  • \KinopoiskDev\Models\Name: Для названий фильмов
  • \KinopoiskDev\Models\ExternalId: Для внешних идентификаторов
  • \KinopoiskDev\Models\Rating: Для рейтингов
  • \KinopoiskDev\Models\ShortImage: Для изображений
  • \KinopoiskDev\Models\ItemName: Для жанров и стран
  • \KinopoiskDev\Models\YearRange: Для годов выпуска
  • \KinopoiskDev\Models\Logo: Для логотипов
  • \KinopoiskDev\Models\Votes: Для голосов

__construct()

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

Параметры:

  • $id (int): Уникальный идентификатор фильма в системе Kinopoisk
  • $name (string|null): Название фильма на русском языке
  • $alternativeName (string|null): Альтернативное название фильма
  • $enName (string|null): Название фильма на английском языке
  • $type (\KinopoiskDev\Enums\MovieType|null): Тип фильма (фильм, сериал, мультфильм и т.д.)
  • $year (int|null): Год выпуска фильма
  • $description (string|null): Полное описание сюжета фильма
  • $shortDescription (string|null): Краткое описание фильма
  • $movieLength (int|null): Длительность фильма в минутах
  • $names (\KinopoiskDev\Models\Name[]|null): Массив всех названий фильма на разных языках
  • $externalId (ExternalId|null): Внешние идентификаторы (IMDB, TMDB, KinopoiskHD)
  • $logo (Logo|null): Логотип фильма
  • $poster (ShortImage|null): Постер фильма
  • $backdrop (ShortImage|null): Фоновое изображение фильма
  • $rating (Rating|null): Рейтинг фильма
  • $votes (Votes|null): Информация о голосах
  • $genres (\KinopoiskDev\Models\ItemName[]|null): Массив жанров фильма
  • $countries (\KinopoiskDev\Models\ItemName[]|null): Массив стран производства фильма
  • $releaseYears (\KinopoiskDev\Models\YearRange[]|null): Массив годов выпуска для разных стран
  • $isSeries (bool|null): Является ли произведение сериалом
  • $ticketsOnSale (bool|null): Доступны ли билеты к покупке
  • $totalSeriesLength (int|null): Общее количество серий
  • $seriesLength (int|null): Количество серий в сезоне
  • $ratingMpaa (\KinopoiskDev\Enums\RatingMpaa|null): Рейтинг MPAA (G, PG, PG-13, R, NC-17)
  • $ageRating (int|null): Возрастной рейтинг
  • $top10 (int|null): Позиция в топ-10 (null если не входит)
  • $top250 (int|null): Позиция в топ-250 (null если не входит)
  • $typeNumber (int|null): Числовой код типа фильма
  • $status (\KinopoiskDev\Enums\MovieStatus|null): Статус производства фильма

См. также:

  • SearchMovie::fromArray: () Для создания объекта из массива данных API
  • SearchMovie::toArray: () Для преобразования объекта в массив

fromArray()

Описание: Создает объект SearchMovie из массива данных API Фабричный метод для создания экземпляра класса SearchMovie из массива данных, полученных от API Kinopoisk.dev. Безопасно обрабатывает отсутствующие значения, устанавливая их в null. Автоматически преобразует массивы данных в соответствующие объекты модели при их наличии.

Параметры:

  • $data (array): Массив данных от API, содержащий информацию о фильме

Возвращает: static Новый экземпляр SearchMovie с данными из массива

Исключения:

  • \TypeError: Если обязательный параметр 'id' отсутствует или имеет неверный тип

См. также:

  • SearchMovie::toArray: () Для обратного преобразования в массив
  • SearchMovie::__construct: () Для создания объекта через конструктор

toArray()

Описание: Преобразует объект SearchMovie в массив Конвертирует текущий экземпляр SearchMovie в ассоциативный массив, сохраняя все свойства объекта. Полезно для сериализации данных, передачи в API или сохранения в базе данных. именам свойств, а значения - их содержимому

Возвращает: array Ассоциативный массив с данными объекта, где ключи соответствуют

См. также:

  • SearchMovie::fromArray: () Для создания объекта из массива
  • SearchMovie::__construct: () Для создания объекта через конструктор

validate()

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

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