dto.php

См. документацию.

<?php
 
namespace Bitrix\Calendar\Sync\Office365\Dto;
 
class Dto
{
    private array $metaFields = [];

    public function __construct(array $data = [])
    {
        $this->initComplexProperties($data);
        foreach ($data as $key => $value)
        {
            if($this->checkConstructException($key, $value))
            {
                continue;
            }
            if (property_exists($this, $key))
            {
                $this->$key = $value;
            }
        }
    }

    public function toArray(bool $filterEmptyValue = false)
    {
        return $this->prepareValue($this, $filterEmptyValue);
    }

    protected function prepareValue($value, bool $filterEmptyValue)
    {
        if (is_scalar($value))
        {
            return $value;
        }
 
        if (is_array($value) || is_object($value))
        {
            $result = [];
            foreach ($value as $index => $item)
            {
                if ($filterEmptyValue && $item === null)
                {
                    continue;
                }
                if ($this->checkPrepareToArrayException($index, $item))
                {
                    continue;
                }
                $result[$index] = $this->prepareValue($item, $filterEmptyValue);
            }
            return $result;
        }
    }

    private function initComplexProperties(array &$data)
    {
        $map = $this->getComplexPropertyMap();
        foreach ($map as $key => $item)
        {
            if (!empty($item['isArray']) && !empty($data[$key]) && is_array($data[$key]))
            {
                $this->$key = [];
                foreach ($data[$key] as $property)
                {
                    $this->$key[] = $this->prepareComplexProperty(
                        $property,
                        $item['class'],
                        $item['isMandatory'] ?? false
                    );
                }
            }
            elseif (empty($data[$key]))
            {
                $this->$key = null;
            }
            else
            {
                $this->$key = $this->prepareComplexProperty(
                    $data[$key],
                    $item['class'],
                    $item['isMandatory'] ?? false
                );
            }
            unset($data[$key]);
        }
    }

    protected function getComplexPropertyMap(): array
    {
        return [];
    }

    private function prepareComplexProperty(array $data, $className, $isMandatory = false)
    {
        if ($isMandatory)
        {
            return new $className($data);
        }
 
        return new $className($data ?? []);
    }

    public function getMetaFields(): array
    {
        return $this->metaFields;
    }
 
    protected function checkConstructException($key, $value): bool
    {
        if (strpos($key, '@') !== false)
        {
            $this->metaFields[$key] = $value;
            return true;
        }
 
        return false;
    }
 
    protected function checkPrepareToArrayException($key, $value): bool
    {
        if (strpos($key, 'metaFields') !== false)
        {
            return true;
        }
        if ($key === 'etag')
        {
            return true;
        }
 
        return false;
    }
}