Review¶
Описание: Класс для представления рецензии на фильм Представляет информацию о рецензии пользователя на фильм или сериал, включая текст рецензии, тип (позитивная/негативная/нейтральная), автора и статистику лайков/дизлайков.
С версии: 1.0.0
Версия: 1.0.0
См. также:
\KinopoiskDev\Models\Movie: Для основной модели фильма
__construct()¶
Описание: Конструктор для создания объекта рецензии Создает новый экземпляр класса Review с указанными параметрами. Все обязательные поля должны быть переданы при создании объекта.
Параметры:
$id(int): Уникальный идентификатор рецензии$movieId(int): ID фильма к которому относится рецензия$authorId(int): ID автора рецензии$reviewLikes(int): Количество лайков рецензии$reviewDislikes(int): Количество дизлайков рецензии$updatedAt(string): Дата последнего обновления$createdAt(string): Дата создания рецензии$title(string|null): Заголовок рецензии$type(string|null): Тип рецензии (Позитивный/Негативный/Нейтральный)$review(string|null): Текст рецензии$date(string|null): Дата создания рецензии (альтернативное поле)$author(string|null): Имя автора рецензии$userRating(int|null): Пользовательский рейтинг
fromArray()¶
Описание: Создает объект Review из массива данных API Фабричный метод для создания экземпляра класса Review из массива данных, полученных от API Kinopoisk.dev. Безопасно обрабатывает отсутствующие значения для опциональных полей.
Параметры:
$data(array): Массив данных о рецензии от API
Возвращает: \KinopoiskDev\Models\Review Новый экземпляр класса Review с данными из массива
toArray()¶
Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса Review в массив, совместимый с форматом API Kinopoisk.dev.
Возвращает: array Массив с данными о рецензии
isPositive()¶
Описание: Проверяет, является ли рецензия позитивной
Возвращает: bool true если рецензия позитивная, иначе false
isNegative()¶
Описание: Проверяет, является ли рецензия негативной
Возвращает: bool true если рецензия негативная, иначе false
isNeutral()¶
Описание: Проверяет, является ли рецензия нейтральной
Возвращает: bool true если рецензия нейтральная, иначе false
getNetRating()¶
Описание: Возвращает общий рейтинг рецензии (лайки - дизлайки)
Возвращает: int Разность между лайками и дизлайками
getPositivePercentage()¶
Описание: Возвращает процент позитивных оценок рецензии
Возвращает: float Процент лайков от общего количества оценок
getActualDate()¶
Описание: Возвращает актуальную дату рецензии Приоритет отдается createdAt над полем date
Возвращает: string Дата рецензии
validate()¶
Описание: Валидирует данные модели
Возвращает: bool True если данные валидны