PHP: Как разобрать сложный XML-файл и не утонуть в собственном коде

<?php

class XMLReaderStruct extends XMLReader
{
    /**
     * @param string        $source
     * @param               $structure
     * @param string|null   $encoding
     * @param int           $options
     * @param callable|null $debug
     * @return bool
     */
    public function xmlStruct($source, $structure, $encoding = null, $options = 0, $debug = null)
    {
        $this->XML($source, $encoding, $options);
        $stack = [];
        $node = &$structure;
        $skipToDepth = false;
        while ($this->read()) {
            switch ($this->nodeType) {
                case self::ELEMENT:
                    if (false === $this->element($skipToDepth, $node, $stack, $debug)) {
                        return false;
                    }
                    break;
                case self::TEXT:
                    if (false === $this->text($skipToDepth, $node, $debug)) {
                        return false;
                    }
                    break;
                case self::END_ELEMENT:
                    if (false === $this->endElement($skipToDepth, $node, $debug)) {
                        return false;
                    }
                    break;
            }
        }

        return true;
    }

    /**
     * @param $skipToDepth
     * @param $node
     * @param $stack
     * @param $debug
     * @return bool
     */
    private function element(&$skipToDepth, &$node, &$stack, $debug)
    {
        // Если текущая ветка не входит в структуру, то просто игнорируем открытие тегов, иначе смотрим: если текущий узел структуры содержит
        // текущий тег, то открываем его, предварительно запоминая в стеке текущую позицию, чтобы при закрытии можно было вернуться. Если
        // не содержит, то открываем режим пропуска, пока не встретим закрывающий тег с текущей глубиной.

        if ($skipToDepth !== false) {
            if ($debug) {
                $debug("( Открытие ): {$this->name} - в режиме пропуска тегов.");
            }

            return true;
        }

        if (!isset($node[$this->name])) {
            $skipToDepth = $this->depth;
            if ($debug) {
                $debug("[ Открытие ]: {$this->name} - не найден в структуре. Запуск режима пропуска тегов до достижения вложенности {$skipToDepth}.");
            }

            return true;
        }

        if ($debug) {
            $debug("[ Открытие ]: {$this->name} - найден в структуре. Спуск по структуре.");
        }

        $stack[$this->depth] = &$node;
        $node = &$node[$this->name];

        if (isset($node['__open'])) {
            if ($debug) {
                $debug("              Найден обработчик открытия {$this->name} - выполняю.");
            }
            if (false === $node['__open']()) {
                return false;
            }
        }

        if (isset($node['__attrs'])) {
            if ($debug) {
                $debug("              Найден обработчик атрибутов {$this->name} - выполняю.");
            }
            $attrs = [];
            if ($this->hasAttributes) {
                while ($this->moveToNextAttribute()) {
                    $attrs[$this->name] = $this->value;
                }
            }
            if (false === $node['__attrs']($attrs)) {
                return false;
            }
        }

        if (!$this->isEmptyElement) {
            return true;
        }

        if ($debug) {
            $debug("              Элемент {$this->name} пустой. Возврат по структуре.");
        }
        if (isset($node['__close'])) {
            if ($debug) {
                $debug("              Найден обработчик закрытия {$this->name} - выполняю.");
            }
            if (false === $node['__close']()) {
                return false;
            }
        }
        $node = &$stack[$this->depth];

        return true;
    }

    /**
     * @param $skipToDepth
     * @param $node
     * @param $debug
     * @return bool
     */
    private function text(&$skipToDepth, &$node, $debug)
    {
        if ($skipToDepth !== false) {
            if ($debug) {
                $debug("( Текст    ): {$this->value} - в режиме пропуска тегов.");
            }

            return true;
        }

        if ($debug) {
            $debug("[ Текст    ]: {$this->value} - в структуре.");
        }

        if (!isset($node['__text'])) {
            return true;
        }

        if ($debug) {
            $debug('              Найден обработчик текста - выполняю.');
        }

        return (false !== $node['__text']($this->value));
    }

    /**
     * @param $skipToDepth
     * @param $node
     * @param $debug
     * @return bool
     */
    private function endElement(&$skipToDepth, &$node, $debug)
    {

        if (false === $skipToDepth) {
            // Если $skipToDepth не установлен, то это значит, что предшествующее ему открытие тега было внутри структуры,
            // и поэтому текущий узел структуры надо откатить.
            if ($debug) {
                $debug("[ Закрытие ]: {$this->name} - мы в структуре. Подьем по структуре.");
            }
            if (isset($node['__close'])) {
                if ($debug) {
                    $debug("              Найден обработчик закрытия {$this->name} - выполняю.");
                }
                if (false === $node['__close']()) {
                    return false;
                }
            }
            $node = &$stack[$this->depth];

            return true;
        }

        if ($this->depth === $skipToDepth) {
            // Если $skipToDepth установлен, то игнорируем все, что имеет бОльшую глубину, пока не дойдем до закрытие игнора с текущей глубиной.
            if ($debug) {
                $debug("[ Закрытие ]: {$this->name} - достигнута вложенность {$skipToDepth}. Отмена режима пропуска тегов.");
            }
            $skipToDepth = false;

            return true;
        }

        if ($debug) {
            $debug("( Закрытие ): {$this->name} - в режиме пропуска тегов.");
        }

        return true;
    }

}