Season¶

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

С версии: 1.0.0

Версия: 1.0.0

См. также:

• \KinopoiskDev\Models\EpisodeV1_4: Для информации об отдельных эпизодах
• \KinopoiskDev\Models\Movie: Для основной модели фильма/сериала

__construct()¶

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

Параметры:

• $movieId (int): ID фильма/сериала к которому относится сезон
• $number (int|null): Номер сезона
• $episodesCount (int|null): Количество эпизодов в сезоне
• $episodes (Episode[]): Массив эпизодов сезона
• $poster (ShortImage|null): Постер сезона
• $name (string|null): Название сезона на русском языке
• $enName (string|null): Название сезона на английском языке
• $duration (int|null): Длительность сезона в минутах
• $description (string|null): Описание сезона на русском языке
• $enDescription (string|null): Описание сезона на английском языке
• $airDate (string|null): Дата выхода сезона
• $updatedAt (string|null): Дата последнего обновления записи
• $createdAt (string|null): Дата создания записи

fromArray()¶

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

Параметры:

• $data (array): Массив данных о сезоне от API

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

Исключения:

• \KinopoiskDev\Exceptions\KinopoiskDevException:

toArray()¶

Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса Season в массив, совместимый с форматом API Kinopoisk.dev.

Возвращает: array Массив с полными данными о сезоне

getBestName()¶

Описание: Возвращает наилучшее доступное название сезона

Возвращает: string|null Название сезона или null если не задано

getBestDescription()¶

Описание: Возвращает наилучшее доступное описание сезона

Возвращает: string|null Описание сезона или null если не задано

hasEpisodes()¶

Описание: Проверяет, есть ли эпизоды в сезоне

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

getAvailableEpisodesCount()¶

Описание: Возвращает количество доступных эпизодов

Возвращает: int Количество эпизодов в массиве episodes

validate()¶

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

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