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

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