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: () Для получения рейтинга IMDBRating::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 если данные валидны