Person¶
Описание: Класс для представления персоны из API Kinopoisk.dev Представляет информацию об актере, режиссере, сценаристе или другом участнике кинопроизводства. Содержит биографические данные, профессиональную информацию, фильмографию и другие связанные сведения.
С версии: 1.0.0
Версия: 1.0.0
См. также:
\KinopoiskDev\Models\PersonInMovie: Для информации о персоне в контексте фильма\KinopoiskDev\Enums\PersonProfession: Для типов профессий персон\KinopoiskDev\Enums\PersonSex: Для типов пола персон\KinopoiskDev\Models\MeiliPersonEntity: Родительский класс
__construct()¶
Описание: Конструктор для создания объекта персоны Создает новый экземпляр класса Person с полным набором данных о персоне. Все свойства класса являются для обеспечения неизменности данных. Конструктор также вызывает родительский конструктор для инициализации базовых свойств наследуемых от MeiliPersonEntity.
Параметры:
$id(int): Уникальный идентификатор персоны в системе Kinopoisk$name(string|null): Имя персоны на русском языке$enName(string|null): Имя персоны на английском языке$photo(string|null): URL фотографии персоны$sex(PersonSex|null): Пол персоны (enum значение)$growth(int|null): Рост персоны в сантиметрах$birthday(string|null): Дата рождения в формате ISO 8601$death(string|null): Дата смерти в формате ISO 8601$age(int|null): Возраст персоны в годах$birthPlace(\KinopoiskDev\Models\BirthPlace[]): Массив мест рождения персоны (пустой массив по умолчанию)$deathPlace(\KinopoiskDev\Models\DeathPlace[]): Массив мест смерти персоны (пустой массив по умолчанию)$profession(PersonProfession[]|null): Массив профессий персоны (может быть null если профессии неизвестны)$spouses(\KinopoiskDev\Models\Spouses[]): Массив данных о супругах персоны$countAwards(int): Количество наград персоны (по умолчанию 0)$facts(\KinopoiskDev\Models\FactInPerson[]): Массив интересных фактов о персоне$movies(\KinopoiskDev\Models\MovieInPerson[]): Массив фильмов с участием персоны$updatedAt(string|null): Дата последнего обновления записи в формате ISO 8601$createdAt(string|null): Дата создания записи в формате ISO 8601
См. также:
Person::fromArray: () Для создания объекта из массива данных APIPerson::toArray: () Для преобразования объекта в массивMeiliPersonEntity::__construct: () Конструктор родительского класса
fromArray()¶
Описание: Создает объект Person из массива данных API Фабричный метод для создания экземпляра класса Person из массива данных, полученных от API Kinopoisk.dev. Безопасно обрабатывает отсутствующие значения и преобразует вложенные объекты в соответствующие классы.
Параметры:
$data(array): Массив данных о персоне от API, содержащий все возможные поля персоны
Возвращает: \KinopoiskDev\Models\Person Новый экземпляр класса Person с данными из массива
Исключения:
\KinopoiskDev\Exceptions\KinopoiskDevException:
См. также:
Person::toArray: () Для обратного преобразования в массивDataManager::parseEnumValue: () Для преобразования enum значений
validate()¶
Описание: Валидирует данные модели
Возвращает: bool True если данные валидны
Исключения:
\KinopoiskDev\Exceptions\ValidationException: При ошибке валидации
toArray()¶
Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса Person в массив, совместимый с форматом API Kinopoisk.dev. Используется для сериализации данных при отправке запросов к API или для экспорта данных.
Возвращает: array Массив с полными данными о персоне, содержащий все поля объекта
См. также:
Person::fromArray: () Для создания объекта из массиваDataManager::getObjectsArray: () Для преобразования массива объектов в массив массивов
getName()¶
Описание: Возвращает наиболее подходящее имя персоны. Метод последовательно проверяет наличие русского имени (name) и английского имени (enName). Возвращается первое найденное не-null значение. Если оба имени отсутствуют, возвращается пустая строка.
С версии: 1.0.0
Возвращает: string Имя персоны или пустая строка, если имена не доступны.
См. также:
Person::: $enNamePerson::: $name