ModelInterface¶

Интерфейс для моделей с возможностью преобразования в/из массива.

Описание¶

Определяет базовый контракт для всех моделей данных в системе. Обеспечивает единообразную работу с преобразованием объектов в массивы и создания объектов из массивов данных API.

Основные возможности¶

• Унификация процесса создания моделей из данных API
• Стандартизация сериализации объектов в массивы
• Обеспечение совместимости с системами кэширования
• Упрощение работы с JSON API responses

Методы¶

fromArray(array $data): object¶

Создает экземпляр модели из массива данных API.

Параметры:

• $data (array) - Массив данных от API, содержащий все необходимые поля для модели

Возвращает:

• object - Новый экземпляр класса-реализации с данными из массива

Исключения:

• InvalidArgumentException - Если обязательные поля отсутствуют в массиве данных
• InvalidArgumentException - Если данные имеют неверный тип или формат

Пример:

1
2
3
4
5
6

$apiData = [
    'id' => 123,
    'name' => 'Название',
    'description' => 'Описание'
];
$model = ConcreteModel::fromArray($apiData);

toArray(): array¶

Преобразует объект модели в массив.

Возвращает:

• array - Ассоциативный массив со всеми данными объекта

Пример:

1
2
3

$model = new ConcreteModel('value1', 'value2');
$array = $model->toArray();
// Результат: ['field1' => 'value1', 'field2' => 'value2']

Пример реализации¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

class ExampleModel implements ModelInterface {
    public function __construct(
        private string $field1,
        private string $field2
    ) {}

    public static function fromArray(array $data): object {
        return new static($data['field1'], $data['field2']);
    }

    public function toArray(): array {
        return [
            'field1' => $this->field1,
            'field2' => $this->field2
        ];
    }
}

// Использование
$model = ExampleModel::fromArray($apiData);
$serialized = $model->toArray();

Связанные файлы¶

• Film - Основная модель фильма
• Person - Модель персоны
• Staff - Модель съемочной группы

📚 Навигация: Главная → Интерфейсы → ModelInterface