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

Networks

Описание: Класс для работы с коллекцией сетей/телеканалов Представляет коллекцию сетей и телеканалов, связанных с фильмом или сериалом. Используется для группировки информации о производителях контента, таких как Netflix, HBO, BBC и других телевизионных сетях и стриминговых платформах. Содержит массив элементов NetworkItem с данными о каждой сети.

С версии: 1.0.0

Версия: 1.0.0

См. также:

  • \KinopoiskDev\Models\NetworkItem: Для отдельных элементов сети
  • \KinopoiskDev\Models\Movie: Для основной модели фильма

__construct()

Описание: Конструктор для создания объекта коллекции сетей Создает новый экземпляр класса Networks с указанным массивом элементов сетей. Параметр является опциональным и может быть null при отсутствии данных о сетях и телеканалах для данного фильма или сериала.

Параметры:

  • $items (NetworkItem[]|null): Массив элементов сетей или null если данные отсутствуют

Пример:

PHP
1
2
3
4
5
6
7
// Создание коллекции с несколькими сетями
$networks = new Networks([
new NetworkItem('Netflix', new Logo('https://example.com/netflix.png')),
new NetworkItem('HBO', new Logo('https://example.com/hbo.png'))
]);
// Создание пустой коллекции
$emptyNetworks = new Networks();

См. также:

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

fromArray()

Описание: Создает объект Networks из массива данных API Статический фабричный метод для создания экземпляра класса Networks из массива данных, полученных от API Kinopoisk.dev. Безопасно обрабатывает отсутствующие значения и автоматически создает массив объектов NetworkItem из данных API. Используется для десериализации ответов API в объекты модели. - items: array|null - массив данных об элементах сетей

Параметры:

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

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

Исключения:

  • \KinopoiskDev\Exceptions\KinopoiskDevException:

Пример:

PHP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
// Создание из полных данных API
$apiData = [
'items' => [
['name' => 'Netflix', 'logo' => ['url' => 'https://example.com/netflix.png']],
['name' => 'HBO', 'logo' => ['url' => 'https://example.com/hbo.png']]
]
];
$networks = Networks::fromArray($apiData);
// Создание из пустых данных
$emptyNetworks = Networks::fromArray([]);

См. также:

  • Networks::toArray: () Для обратного преобразования в массив
  • NetworkItem::fromArray: () Для создания отдельных элементов сети

toArray()

Описание: Преобразует объект в массив данных Конвертирует текущий экземпляр класса Networks в массив, совместимый с форматом API Kinopoisk.dev. Автоматически преобразует все вложенные объекты NetworkItem в массивы. Используется для сериализации данных при отправке запросов к API или для экспорта в JSON формат. - items: array|null - массив данных об элементах сетей или null

Возвращает: array Массив с данными о сетях, содержащий ключи:

Пример:

PHP
1
2
3
4
5
$networks = new Networks([
new NetworkItem('Netflix', new Logo('https://example.com/netflix.png'))
]);
$array = $networks->toArray();
// ['items' => [['name' => 'Netflix', 'logo' => ['url' => 'https://example.com/netflix.png']]]]

См. также:

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

validate()

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

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