phpdoc parser Download - phpdoc parser Source code download

phpdoc parser

Other categories

2.0.0

Download

PHPDoc Parser for PHPStan

This library phpstan/phpdoc-parser represents PHPDocs with an AST (Abstract Syntax Tree). It supports parsing and modifying PHPDocs.

For the complete list of supported PHPDoc features check out PHPStan documentation. PHPStan is the main (but not the only) user of this library.

PHPDoc Basics (list of PHPDoc tags)
PHPDoc Types (list of PHPDoc types)
phpdoc-parser API Reference with all the AST node types etc.

This parser also supports parsing Doctrine Annotations. The AST nodes live in the PHPStanPhpDocParserAstPhpDocDoctrine namespace.

Installation

composer require phpstan/phpdoc-parser

Basic usage

<?php

require_once __DIR__ . '/vendor/autoload.php';

use PHPStanPhpDocParserAstPhpDocParamTagValueNode;
use PHPStanPhpDocParserAstPhpDocPhpDocNode;
use PHPStanPhpDocParserAstTypeIdentifierTypeNode;
use PHPStanPhpDocParserLexerLexer;
use PHPStanPhpDocParserParserConfig;
use PHPStanPhpDocParserParserConstExprParser;
use PHPStanPhpDocParserParserPhpDocParser;
use PHPStanPhpDocParserParserTokenIterator;
use PHPStanPhpDocParserParserTypeParser;

// basic setup

$config = new ParserConfig(usedAttributes: []);
$lexer = new Lexer($config);
$constExprParser = new ConstExprParser($config);
$typeParser = new TypeParser($config, $constExprParser);
$phpDocParser = new PhpDocParser($config, $typeParser, $constExprParser);

// parsing and reading a PHPDoc string

$tokens = new TokenIterator($lexer->tokenize('/** @param Lorem $a */'));
$phpDocNode = $phpDocParser->parse($tokens); // PhpDocNode
$paramTags = $phpDocNode->getParamTagValues(); // ParamTagValueNode[]
echo $paramTags[0]->parameterName; // '$a'
echo $paramTags[0]->type; // IdentifierTypeNode - 'Lorem'

Format-preserving printer

This component can be used to modify the AST and print it again as close as possible to the original.

It's heavily inspired by format-preserving printer component in nikic/PHP-Parser.

<?php

require_once __DIR__ . '/vendor/autoload.php';

use PHPStanPhpDocParserAstNodeTraverser;
use PHPStanPhpDocParserAstNodeVisitorCloningVisitor;
use PHPStanPhpDocParserAstPhpDocPhpDocNode;
use PHPStanPhpDocParserAstTypeIdentifierTypeNode;
use PHPStanPhpDocParserLexerLexer;
use PHPStanPhpDocParserParserConfig;
use PHPStanPhpDocParserParserConstExprParser;
use PHPStanPhpDocParserParserPhpDocParser;
use PHPStanPhpDocParserParserTokenIterator;
use PHPStanPhpDocParserParserTypeParser;
use PHPStanPhpDocParserPrinterPrinter;

// basic setup with enabled required lexer attributes

$config = new ParserConfig(usedAttributes: ['lines' => true, 'indexes' => true]);
$lexer = new Lexer($config);
$constExprParser = new ConstExprParser($config);
$typeParser = new TypeParser($config, $constExprParser);
$phpDocParser = new PhpDocParser($config, $typeParser, $constExprParser);

$tokens = new TokenIterator($lexer->tokenize('/** @param Lorem $a */'));
$phpDocNode = $phpDocParser->parse($tokens); // PhpDocNode

$cloningTraverser = new NodeTraverser([new CloningVisitor()]);

/** @var PhpDocNode $newPhpDocNode */
[$newPhpDocNode] = $cloningTraverser->traverse([$phpDocNode]);

// change something in $newPhpDocNode
$newPhpDocNode->getParamTagValues()[0]->type = new IdentifierTypeNode('Ipsum');

// print changed PHPDoc
$printer = new Printer();
$newPhpDoc = $printer->printFormatPreserving($newPhpDocNode, $phpDocNode, $tokens);
echo $newPhpDoc; // '/** @param Ipsum $a */'