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
если данные валидны