MovieInPerson

Описание: Класс для представления персоны в контексте фильма Представляет информацию о персоне (актер, режиссер, сценарист и др.) в контексте конкретного фильма или сериала. Содержит основные данные о персоне, включая идентификатор, имена, рейтинг, описание роли и профессию. Используется для хранения и обработки данных об участниках кинопроизводства, полученных от API Kinopoisk.dev.

С версии: 1.0.0

Версия: 1.0.0

См. также:

• \KinopoiskDev\Models\PersonInMovie: Для обратной связи (персона в фильме)
• \KinopoiskDev\Models\Person: Для полной информации о персоне
• \KinopoiskDev\Models\Movie: Для использования в информации о фильмах

__construct()

Описание: Конструктор модели фильма в персоне Создает новый экземпляр класса MovieInPerson с указанными параметрами. Только идентификатор является обязательным параметром, остальные могут быть null при отсутствии соответствующей информации о персоне или её роли в конкретном фильме.

Параметры:

• $id (int): Уникальный идентификатор персоны в системе Kinopoisk
• $name (string|null): Имя персоны на русском языке (null если не указано)
• $alternativeName (string|null): Альтернативное имя персоны (null если не указано)
• $rating (float|null): Рейтинг персоны в контексте данного фильма (null если не указан)
• $general (bool|null): Является ли персона главным участником фильма (null если не определено)
• $description (string|null): Описание роли персоны в фильме (null если не указано)
• $enProfession (string|null): Профессия персоны на английском языке (null если не указана)

Пример:

$moviePerson = new MovieInPerson(
id: 123456,
name: 'Иван Петров',
alternativeName: 'Ivan Petrov',
rating: 8.5,
general: true,
description: 'Главная роль',
enProfession: 'actor'
);

См. также:

• MovieInPerson::fromArray: () Для создания объекта из массива данных API
• MovieInPerson::toArray: () Для преобразования объекта в массив

fromArray()

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

• id: int - уникальный идентификатор персоны (обязательный)
• name: string|null - имя персоны на русском языке
• alternativeName: string|null - альтернативное имя персоны
• rating: float|null - рейтинг персоны в контексте фильма
• general: bool|null - является ли персона главным участником
• description: string|null - описание роли в фильме
• enProfession: string|null - профессия на английском языке

Параметры:

• $data (array): Массив данных о персоне от API, содержащий ключи:

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

Пример:

$personData = [
'id' => 123456,
'name' => 'Иван Петров',
'alternativeName' => 'Ivan Petrov',
'rating' => 8.5,
'general' => true,
'description' => 'Главная роль',
'enProfession' => 'actor'
];
$moviePerson = MovieInPerson::fromArray($personData);

См. также:

• MovieInPerson::toArray: () Для обратного преобразования в массив
• BaseModel::fromArray: () Реализация интерфейса BaseModel

toArray()

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

• id: int - уникальный идентификатор персоны
• name: string|null - имя персоны на русском языке
• alternativeName: string|null - альтернативное имя персоны
• rating: float|null - рейтинг персоны в контексте фильма
• general: bool|null - является ли персона главным участником
• description: string|null - описание роли в фильме
• enProfession: string|null - профессия на английском языке

Параметры:

• $includeNulls (bool): * @return array Массив с данными о персоне в фильме, содержащий ключи:

Пример:

$moviePerson = new MovieInPerson(123456, 'Иван Петров', 'Ivan Petrov');
$array = $moviePerson->toArray();
// Результат: ['id' => 123456, 'name' => 'Иван Петров', 'alternativeName' => 'Ivan Petrov', ...]

См. также:

• MovieInPerson::fromArray: () Для создания объекта из массива
• BaseModel::toArray: () Реализация интерфейса BaseModel