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

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 если не указана)

Пример:

PHP
1
2
3
4
5
6
7
8
9
$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 с данными из массива

Пример:

PHP
$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 Массив с данными о персоне в фильме, содержащий ключи:

Пример:

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

См. также:

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