CommentParser.php

Go to the documentation of this file.

<?php
namespace Magento\Framework\App\DeploymentConfig;

use Magento\Framework\App\Config\CommentParserInterface;
use Magento\Framework\Filesystem;
use Magento\Framework\App\Filesystem\DirectoryList;
use Magento\Framework\Config\File\ConfigFilePool;

class CommentParser implements CommentParserInterface
{
    private $filesystem;

    private $configFilePool;

    public function __construct(
        Filesystem $filesystem,
        ConfigFilePool $configFilePool
    ) {
        $this->filesystem = $filesystem;
        $this->configFilePool = $configFilePool;
    }

    public function execute($fileName)
    {
        $result = [];
        $dirReader = $this->filesystem->getDirectoryRead(DirectoryList::CONFIG);

        if (!$dirReader->isExist($fileName)) {
            return $result;
        }

        $fileContent = $dirReader->readFile($fileName);
        $commentBlocks = array_filter(
            token_get_all($fileContent),
            function ($entry) {
                return T_DOC_COMMENT == $entry[0];
            }
        );

        foreach ($commentBlocks as $commentBlock) {
            $text = $this->getCommentText($commentBlock[1]);
            $section = $this->getSectionName($commentBlock[1]);

            if ($section && $text) {
                $result[$section] = $text;
            }
        }

        return $result;
    }

    private function getCommentText($commentBlock)
    {
        $commentsLine = [];
        foreach (preg_split("/(\r?\n)/", $commentBlock) as $commentLine) {
            if (preg_match('/^(?=\s+?\*[^\/])(.+)/', $commentLine, $matches)
                && false === strpos($commentLine, 'For the section')
            ) {
                $commentsLine[] = preg_replace('/^(\*\s?)/', '', trim($matches[1]));
            }
        }

        return empty($commentsLine) ? null : implode(PHP_EOL, $commentsLine);
    }

    private function getSectionName($comment)
    {
        $pattern = '/\s+\* For the section: (.+)\s/';
        preg_match_all($pattern, $comment, $matches);

        return empty($matches[1]) ? null : trim(array_shift($matches[1]));
    }
}