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

Rating

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

С версии: 1.0.0

Версия: 1.0.0

См. также:

  • \KinopoiskDev\Models\Movie::getRating: () Для получения рейтинга фильма
  • \KinopoiskDev\Models\Votes: Для информации о количестве голосов

__construct()

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

Параметры:

  • $kp (float|null): Рейтинг на Кинопоиске (0.0-10.0)
  • $imdb (float|null): Рейтинг на IMDB (0.0-10.0)
  • $tmdb (float|null): Рейтинг на TMDB (0.0-10.0)
  • $filmCritics (float|null): Рейтинг кинокритиков (0.0-100.0)
  • $russianFilmCritics (float|null): Рейтинг российских кинокритиков (0.0-100.0)
  • $await (float|null): Рейтинг ожидания (0.0-100.0)

См. также:

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

__toString()

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

Возвращает: string Строковое представление рейтингов или 'No ratings', если рейтинги отсутствуют

fromArray()

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

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

См. также:

  • Rating::toArray: () Для обратного преобразования в массив

toArray()

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

Возвращает: array<string, mixed> Массив с данными рейтингов

См. также:

  • Rating::fromArray: () Для создания объекта из массива

getKinopoiskRating()

Описание: Возвращает рейтинг фильма на Кинопоиске Предоставляет доступ к рейтингу фильма в системе Кинопоиск. Рейтинг представлен в виде числа с плавающей точкой в диапазоне от 0.0 до 10.0.

Возвращает: float|null Рейтинг на Кинопоиске или null, если рейтинг отсутствует

См. также:

  • Rating::getImdbRating: () Для получения рейтинга IMDB
  • Rating::getTmdbRating: () Для получения рейтинга TMDB

getImdbRating()

Описание: Возвращает рейтинг фильма на IMDB Предоставляет доступ к рейтингу фильма в системе Internet Movie Database (IMDB). Рейтинг представлен в виде числа с плавающей точкой в диапазоне от 0.0 до 10.0.

Возвращает: float|null Рейтинг на IMDB или null, если рейтинг отсутствует

См. также:

  • Rating::getKinopoiskRating: () Для получения рейтинга Кинопоиска
  • Rating::getTmdbRating: () Для получения рейтинга TMDB

getTmdbRating()

Описание: Возвращает рейтинг фильма на TMDB Предоставляет доступ к рейтингу фильма в системе The Movie Database (TMDB). Рейтинг представлен в виде числа с плавающей точкой в диапазоне от 0.0 до 10.0.

Возвращает: float|null Рейтинг на TMDB или null, если рейтинг отсутствует

См. также:

  • Rating::getKinopoiskRating: () Для получения рейтинга Кинопоиска
  • Rating::getImdbRating: () Для получения рейтинга IMDB

getFilmCriticsRating()

Описание: Возвращает рейтинг фильма от кинокритиков Предоставляет доступ к рейтингу фильма от международных кинокритиков. Рейтинг представлен в виде числа с плавающей точкой в диапазоне от 0.0 до 100.0.

Возвращает: float|null Рейтинг кинокритиков или null, если рейтинг отсутствует

См. также:

  • Rating::getRussianFilmCriticsRating: () Для получения рейтинга российских кинокритиков

getRussianFilmCriticsRating()

Описание: Возвращает рейтинг фильма от российских кинокритиков Предоставляет доступ к рейтингу фильма от российских кинокритиков. Рейтинг представлен в виде числа с плавающей точкой в диапазоне от 0.0 до 100.0.

Возвращает: float|null Рейтинг российских кинокритиков или null, если рейтинг отсутствует

См. также:

  • Rating::getFilmCriticsRating: () Для получения рейтинга международных кинокритиков

getAwaitRating()

Описание: Возвращает рейтинг ожидания фильма Предоставляет доступ к рейтингу ожидания фильма, который отражает интерес аудитории к еще не вышедшему фильму. Рейтинг представлен в виде числа с плавающей точкой в диапазоне от 0.0 до 100.0.

Возвращает: float|null Рейтинг ожидания или null, если рейтинг отсутствует

getHighestRating()

Описание: Возвращает наивысший доступный рейтинг Анализирует все доступные рейтинги и возвращает наивысший из них. Учитывает только основные рейтинги (Кинопоиск, IMDB, TMDB, кинокритики), игнорируя рейтинги ожидания и российских кинокритиков.

Возвращает: float|null Наивысший рейтинг или null, если все рейтинги отсутствуют

См. также:

  • Rating::getAverageRating: () Для получения среднего рейтинга

getAverageRating()

Описание: Возвращает средний рейтинг из всех доступных Вычисляет среднее арифметическое всех доступных рейтингов. Учитывает только основные рейтинги (Кинопоиск, IMDB, TMDB, кинокритики), игнорируя рейтинги ожидания и российских кинокритиков.

Возвращает: float|null Средний рейтинг или null, если все рейтинги отсутствуют

См. также:

  • Rating::getHighestRating: () Для получения наивысшего рейтинга

hasAnyRating()

Описание: Проверяет наличие хотя бы одного рейтинга Определяет, существует ли хотя бы один рейтинг из любого источника. Учитывает все возможные рейтинги, включая рейтинги ожидания и критиков.

Возвращает: bool true, если существует хотя бы один рейтинг, иначе false

См. также:

  • Rating::getAvailableRatings: () Для получения всех доступных рейтингов

getAvailableRatings()

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

Возвращает: array<string, mixed> Ассоциативный массив доступных рейтингов

См. также:

  • Rating::hasAnyRating: () Для проверки наличия хотя бы одного рейтинга

validate()

Описание: Валидирует данные модели Проверяет корректность рейтингов. Все рейтинги должны быть в допустимых диапазонах.

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