divineniiquaye/rade-di

<?php

declare(strict_types=1);

/*
 * This file is part of DivineNii opensource projects.
 *
 * PHP version 7.4 and above required
 *
 * @author    Divine Niiquaye Ibok <divineibok@gmail.com>
 * @copyright 2021 DivineNii (https://divinenii.com/)
 * @license   https://opensource.org/licenses/BSD-3-Clause License
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Rade\DI\Builder;

use PhpParser\{NodeTraverser, ParserFactory};
use Rade\DI\NodeVisitor\PhpLiteralVisitor;

/**
 * PHP literal value.
 *
 * Example:
 *
 * ```php
 * $literal = new PhpLiteral("$hello = ['%?' => '%?'];", ['Hello', '344']);
 * // Expected output when resolved is: $hello => ['Hello' => 344];
 * ```
 *
 * @author Divine Niiquaye Ibok <divineibok@gmail.com>
 */
class PhpLiteral
{
    /**
     * `%?` is a reserved string in code, as it used to resolve missing values.
     *
     * @param string $value Should be a php code excluding `<?php`
     * @param array<int,mixed> $args
     */
    public function __construct(private string $value, private array $args = [])
    {
    }

    public function resolve(\Rade\DI\Resolver $resolver)
    {
        return (function () use ($resolver) {
            $parser = (new ParserFactory())->create(ParserFactory::PREFER_PHP7);
            $astCode = $parser->parse("<?php\n" . $this->value);

            if ([] !== $this->args) {
                $traverser = new NodeTraverser();
                $traverser->addVisitor(new PhpLiteralVisitor($resolver->resolveArguments($this->args)));

                $astCode = $traverser->traverse($astCode);
            }

            return $astCode;
        })();
    }
}