207 lines
6.4 KiB
PHP
207 lines
6.4 KiB
PHP
#!/usr/bin/env php
|
|
<?php
|
|
|
|
foreach ([__DIR__ . '/../../../autoload.php', __DIR__ . '/../vendor/autoload.php'] as $file) {
|
|
if (file_exists($file)) {
|
|
require $file;
|
|
break;
|
|
}
|
|
}
|
|
|
|
ini_set('xdebug.max_nesting_level', 3000);
|
|
|
|
// Disable Xdebug var_dump() output truncation
|
|
ini_set('xdebug.var_display_max_children', -1);
|
|
ini_set('xdebug.var_display_max_data', -1);
|
|
ini_set('xdebug.var_display_max_depth', -1);
|
|
|
|
list($operations, $files, $attributes) = parseArgs($argv);
|
|
|
|
/* Dump nodes by default */
|
|
if (empty($operations)) {
|
|
$operations[] = 'dump';
|
|
}
|
|
|
|
if (empty($files)) {
|
|
showHelp("Must specify at least one file.");
|
|
}
|
|
|
|
$parser = (new PhpParser\ParserFactory())->createForVersion($attributes['version']);
|
|
$dumper = new PhpParser\NodeDumper([
|
|
'dumpComments' => true,
|
|
'dumpPositions' => $attributes['with-positions'],
|
|
]);
|
|
$prettyPrinter = new PhpParser\PrettyPrinter\Standard;
|
|
|
|
$traverser = new PhpParser\NodeTraverser();
|
|
$traverser->addVisitor(new PhpParser\NodeVisitor\NameResolver);
|
|
|
|
foreach ($files as $file) {
|
|
if ($file === '-') {
|
|
$code = file_get_contents('php://stdin');
|
|
fwrite(STDERR, "====> Stdin:\n");
|
|
} else if (strpos($file, '<?php') === 0) {
|
|
$code = $file;
|
|
fwrite(STDERR, "====> Code $code\n");
|
|
} else {
|
|
if (!file_exists($file)) {
|
|
fwrite(STDERR, "File $file does not exist.\n");
|
|
exit(1);
|
|
}
|
|
|
|
$code = file_get_contents($file);
|
|
fwrite(STDERR, "====> File $file:\n");
|
|
}
|
|
|
|
if ($attributes['with-recovery']) {
|
|
$errorHandler = new PhpParser\ErrorHandler\Collecting;
|
|
$stmts = $parser->parse($code, $errorHandler);
|
|
foreach ($errorHandler->getErrors() as $error) {
|
|
$message = formatErrorMessage($error, $code, $attributes['with-column-info']);
|
|
fwrite(STDERR, $message . "\n");
|
|
}
|
|
if (null === $stmts) {
|
|
continue;
|
|
}
|
|
} else {
|
|
try {
|
|
$stmts = $parser->parse($code);
|
|
} catch (PhpParser\Error $error) {
|
|
$message = formatErrorMessage($error, $code, $attributes['with-column-info']);
|
|
fwrite(STDERR, $message . "\n");
|
|
exit(1);
|
|
}
|
|
}
|
|
|
|
foreach ($operations as $operation) {
|
|
if ('dump' === $operation) {
|
|
fwrite(STDERR, "==> Node dump:\n");
|
|
echo $dumper->dump($stmts, $code), "\n";
|
|
} elseif ('pretty-print' === $operation) {
|
|
fwrite(STDERR, "==> Pretty print:\n");
|
|
echo $prettyPrinter->prettyPrintFile($stmts), "\n";
|
|
} elseif ('json-dump' === $operation) {
|
|
fwrite(STDERR, "==> JSON dump:\n");
|
|
echo json_encode($stmts, JSON_PRETTY_PRINT), "\n";
|
|
} elseif ('var-dump' === $operation) {
|
|
fwrite(STDERR, "==> var_dump():\n");
|
|
var_dump($stmts);
|
|
} elseif ('resolve-names' === $operation) {
|
|
fwrite(STDERR, "==> Resolved names.\n");
|
|
$stmts = $traverser->traverse($stmts);
|
|
}
|
|
}
|
|
}
|
|
|
|
function formatErrorMessage(PhpParser\Error $e, $code, $withColumnInfo) {
|
|
if ($withColumnInfo && $e->hasColumnInfo()) {
|
|
return $e->getMessageWithColumnInfo($code);
|
|
} else {
|
|
return $e->getMessage();
|
|
}
|
|
}
|
|
|
|
function showHelp($error = '') {
|
|
if ($error) {
|
|
fwrite(STDERR, $error . "\n\n");
|
|
}
|
|
fwrite($error ? STDERR : STDOUT, <<<'OUTPUT'
|
|
Usage: php-parse [operations] file1.php [file2.php ...]
|
|
or: php-parse [operations] "<?php code"
|
|
Turn PHP source code into an abstract syntax tree.
|
|
|
|
Operations is a list of the following options (--dump by default):
|
|
|
|
-d, --dump Dump nodes using NodeDumper
|
|
-p, --pretty-print Pretty print file using PrettyPrinter\Standard
|
|
-j, --json-dump Print json_encode() result
|
|
--var-dump var_dump() nodes (for exact structure)
|
|
-N, --resolve-names Resolve names using NodeVisitor\NameResolver
|
|
-c, --with-column-info Show column-numbers for errors (if available)
|
|
-P, --with-positions Show positions in node dumps
|
|
-r, --with-recovery Use parsing with error recovery
|
|
--version=VERSION Target specific PHP version (default: newest)
|
|
-h, --help Display this page
|
|
|
|
Example:
|
|
php-parse -d -p -N -d file.php
|
|
|
|
Dumps nodes, pretty prints them, then resolves names and dumps them again.
|
|
|
|
|
|
OUTPUT
|
|
);
|
|
exit($error ? 1 : 0);
|
|
}
|
|
|
|
function parseArgs($args) {
|
|
$operations = [];
|
|
$files = [];
|
|
$attributes = [
|
|
'with-column-info' => false,
|
|
'with-positions' => false,
|
|
'with-recovery' => false,
|
|
'version' => PhpParser\PhpVersion::getNewestSupported(),
|
|
];
|
|
|
|
array_shift($args);
|
|
$parseOptions = true;
|
|
foreach ($args as $arg) {
|
|
if (!$parseOptions) {
|
|
$files[] = $arg;
|
|
continue;
|
|
}
|
|
|
|
switch ($arg) {
|
|
case '--dump':
|
|
case '-d':
|
|
$operations[] = 'dump';
|
|
break;
|
|
case '--pretty-print':
|
|
case '-p':
|
|
$operations[] = 'pretty-print';
|
|
break;
|
|
case '--json-dump':
|
|
case '-j':
|
|
$operations[] = 'json-dump';
|
|
break;
|
|
case '--var-dump':
|
|
$operations[] = 'var-dump';
|
|
break;
|
|
case '--resolve-names':
|
|
case '-N';
|
|
$operations[] = 'resolve-names';
|
|
break;
|
|
case '--with-column-info':
|
|
case '-c';
|
|
$attributes['with-column-info'] = true;
|
|
break;
|
|
case '--with-positions':
|
|
case '-P':
|
|
$attributes['with-positions'] = true;
|
|
break;
|
|
case '--with-recovery':
|
|
case '-r':
|
|
$attributes['with-recovery'] = true;
|
|
break;
|
|
case '--help':
|
|
case '-h';
|
|
showHelp();
|
|
break;
|
|
case '--':
|
|
$parseOptions = false;
|
|
break;
|
|
default:
|
|
if (preg_match('/^--version=(.*)$/', $arg, $matches)) {
|
|
$attributes['version'] = PhpParser\PhpVersion::fromString($matches[1]);
|
|
} elseif ($arg[0] === '-' && \strlen($arg[0]) > 1) {
|
|
showHelp("Invalid operation $arg.");
|
|
} else {
|
|
$files[] = $arg;
|
|
}
|
|
}
|
|
}
|
|
|
|
return [$operations, $files, $attributes];
|
|
}
|