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