PHP Code AST

PHP code generation based on AST.

Installation

$ composer require open-code-modeling/php-code-ast

Usage

See unit tests in tests folder for comprehensive examples.

Let's start with a straightforward example of generating a class with the ClassBuilder:

<?php$parser = (newPhpParser\ParserFactory())->create(PhpParser\ParserFactory::ONLY_PHP7);
$printer = newPhpParser\PrettyPrinter\Standard(['shortArraySyntax' => true]);
$ast = $parser->parse('');
$classBuilder = OpenCodeModeling\CodeAst\Builder\ClassBuilder::fromScratch('TestClass', 'My\\Awesome\\Service');
$classBuilder
->setFinal(true)
->setExtends('BaseClass')
->setNamespaceImports('Foo\\Bar')
->setImplements('\\Iterator', 'Bar');
$nodeTraverser = newPhpParser\NodeTraverser();
$classBuilder->injectVisitors($nodeTraverser, $parser);
print_r($printer->prettyPrintFile($nodeTraverser->traverse($ast)));

Will print the following output:

<?phpdeclare (strict_types=1);
namespaceMy\Awesome\Service;
useFoo\Bar;
finalclass TestClass extends BaseClass implements \Iterator, Bar
{
}

All this is done via PHP AST and it checks if the AST token is already defined. So it will not override your code.

You can also use the code and PHP AST visitor classes to generate code via the low level API. To add a method toInt() to the class above you can add this via the ClassMethod visitor.

<?php$method = newOpenCodeModeling\CodeAst\Code\MethodGenerator(
'toInt',
[],
OpenCodeModeling\CodeAst\Code\MethodGenerator::FLAG_PUBLIC,
newOpenCodeModeling\CodeAst\Code\BodyGenerator($this->parser, 'return $this->myValue;')
);
$method->setReturnType('int');
$nodeTraverser->addVisitor(newOpenCodeModeling\CodeAst\NodeVisitor\ClassMethod($method));
print_r($printer->prettyPrintFile($nodeTraverser->traverse($ast)));

This will print the following output.

<?phpdeclare (strict_types=1);
namespaceMy\Awesome\Service;
useFoo\Bar;
finalclass TestClass extends BaseClass implements \Iterator, Bar
{
publicfunctiontoInt() : int
{
return$this->myValue;
}
}

Now, change the body of the toInt() method to something else. You will see that your changes will NOT be overwritten.

Reverse usage

It is also possible to create a factory class from parsed PHP AST. You can create an instance of OpenCodeModeling\CodeAst\Builder\ClassBuilder by calling OpenCodeModeling\CodeAst\Builder\ClassBuilder::fromNodes().

<?php$parser = (newPhpParser\ParserFactory())->create(PhpParser\ParserFactory::ONLY_PHP7);
$printer = newPhpParser\PrettyPrinter\Standard(['shortArraySyntax' => true]);
$expected = <<<'EOF'<?phpdeclare (strict_types=1);namespace My\Awesome\Service;use Foo\Bar;final class TestClass extends BaseClass implements \Iterator, Bar{ private const PRIV = 'private';}
EOF;
$ast = $parser->parse($expected);
$classBuilder = OpenCodeModeling\CodeAst\Builder\ClassBuilder::fromNodes(...$ast);
$classBuilder->getName(); // TestClass$classBuilder->getExtends(); // BaseClass$classBuilder->isFinal(); // true$classBuilder->isStrict(); // true$classBuilder->isAbstract(); // false