FactInMovie

Описание: Модель фактов из фильма Представляет интересный факт о фильме, сериале или другом произведении. Может содержать как обычную информацию, так и спойлеры, а также имеет определенный тип (например, "блупер", "ошибка" и т.д.).

С версии: 1.0.0

Версия: 1.0.0

См. также:

• \KinopoiskDev\Models\Movie: Основная модель фильма
• \KinopoiskDev\Models\SearchMovie: Поисковая модель фильма

__construct()

Описание: Конструктор для создания объекта факта о фильме Создает новый экземпляр FactInMovie с указанным содержимым факта и дополнительными метаданными о типе и наличии спойлеров.

Параметры:

• $value (string): Текст факта - основное содержимое информации о фильме
• $type (string|null): Тип факта (например, "блупер", "ошибка", "интересный факт")
• $spoiler (bool|null): Содержит ли факт спойлеры (true - да, false - нет, null - неизвестно)

Пример:

$fact = new FactInMovie(
value: 'Во время съёмок актёр травмировал руку',
type: 'блупер',
spoiler: false
);

fromArray()

Описание: Создает объект факта о фильме из массива данных API Фабричный метод для создания экземпляра класса FactInMovie из массива данных, полученных от API Kinopoisk.dev. Метод безопасно обрабатывает отсутствующие значения полей type и spoiler, устанавливая их в null при отсутствии в исходных данных. Используется для десериализации данных фактов о фильмах, полученных от API.

• value: string - обязательное поле с текстом факта
• type: string|null - опциональный тип факта (по умолчанию null)
• spoiler: bool|null - опциональный флаг спойлера (по умолчанию null)

Возвращает: static Новый экземпляр FactInMovie с данными из массива

Исключения:

• \TypeError: Если поле 'value' отсутствует в массиве или имеет неправильный тип

Пример:

$data = [
'value' => 'Актёр получил травму во время съёмок',
'type' => 'блупер',
'spoiler' => false
];
$fact = FactInMovie::fromArray($data);

См. также:

• FactInMovie::toArray: () Для обратного преобразования объекта в массив
• FactInMovie::__construct: () Конструктор класса с описанием параметров

toArray()

Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса FactInMovie в ассоциативный массив, содержащий все основные свойства объекта. Используется для сериализации данных при отправке запросов к API или для экспорта данных в JSON. Возвращает массив с тремя основными полями: значение факта, тип и статус спойлера.

• value: string - текстовое содержимое факта
• type: string|null - тип факта (null если не определен)
• spoiler: bool|null - признак спойлера (null если не определен)

Возвращает: array Ассоциативный массив с данными факта о фильме, содержащий ключи:

См. также:

• FactInMovie::fromArray: () Для создания объекта из массива данных
• FactInMovie::__construct: () Для инициализации объекта с данными

validate()

Описание: Валидирует данные модели

Возвращает: bool True если данные валидны