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

PersonPlace

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

С версии: 1.0.0

Версия: 1.0.0

См. также:

  • \KinopoiskDev\Models\Person: Для работы с персонами
  • \KinopoiskDev\Models\PersonPlaceValue: Для более детальной географической информации

__construct()

Описание: Строковое значение места рождения или смерти персоны Содержит текстовое описание географического места, связанного с персоной. Может содержать название города, страны или полный адрес места рождения/смерти. Значение доступно только для чтения после создания объекта.

__toString()

Описание: Возвращает строковое представление места персоны Магический метод для получения строкового представления объекта PersonPlace. Используется при приведении объекта к строке или при выводе объекта в контексте, где требуется строковое значение. Возвращает непосредственно значение места без дополнительного форматирования.

Возвращает: string Строковое представление места рождения/смерти персоны

См. также:

  • PersonPlace::toArray: () Для получения данных в формате массива
  • PersonPlace::: $value Для доступа к свойству места напрямую

fromArray()

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

Параметры:

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

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

См. также:

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

toArray()

Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса PersonPlace в массив, совместимый с форматом API Kinopoisk.dev. Используется для сериализации данных при отправке запросов к API, кэшировании или экспорте данных. Возвращает массив с единственным ключом 'value'. - value: string - текстовое значение места рождения/смерти

Возвращает: array Массив с данными о месте, содержащий:

См. также:

  • PersonPlace::fromArray: () Для создания объекта из массива
  • PersonPlace::__toString: () Для получения только текстового значения

validate()

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

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