Chris@13: <?php
Chris@13: 
Chris@13: /*
Chris@13:  * This file is part of Psy Shell.
Chris@13:  *
Chris@13:  * (c) 2012-2018 Justin Hileman
Chris@13:  *
Chris@13:  * For the full copyright and license information, please view the LICENSE
Chris@13:  * file that was distributed with this source code.
Chris@13:  */
Chris@13: 
Chris@13: namespace Psy;
Chris@13: 
Chris@13: use PhpParser\Lexer;
Chris@13: use PhpParser\Parser;
Chris@13: use PhpParser\ParserFactory as OriginalParserFactory;
Chris@13: 
Chris@13: /**
Chris@13:  * Parser factory to abstract over PHP parser library versions.
Chris@13:  */
Chris@13: class ParserFactory
Chris@13: {
Chris@13:     const ONLY_PHP5   = 'ONLY_PHP5';
Chris@13:     const ONLY_PHP7   = 'ONLY_PHP7';
Chris@13:     const PREFER_PHP5 = 'PREFER_PHP5';
Chris@13:     const PREFER_PHP7 = 'PREFER_PHP7';
Chris@13: 
Chris@13:     /**
Chris@13:      * Possible kinds of parsers for the factory, from PHP parser library.
Chris@13:      *
Chris@13:      * @return array
Chris@13:      */
Chris@13:     public static function getPossibleKinds()
Chris@13:     {
Chris@13:         return ['ONLY_PHP5', 'ONLY_PHP7', 'PREFER_PHP5', 'PREFER_PHP7'];
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * Is this parser factory supports kinds?
Chris@13:      *
Chris@13:      * PHP parser < 2.0 doesn't support kinds, >= 2.0 — does.
Chris@13:      *
Chris@13:      * @return bool
Chris@13:      */
Chris@13:     public function hasKindsSupport()
Chris@13:     {
Chris@17:         return \class_exists('PhpParser\ParserFactory');
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * Default kind (if supported, based on current interpreter's version).
Chris@13:      *
Chris@13:      * @return string|null
Chris@13:      */
Chris@13:     public function getDefaultKind()
Chris@13:     {
Chris@13:         if ($this->hasKindsSupport()) {
Chris@17:             return \version_compare(PHP_VERSION, '7.0', '>=') ? static::ONLY_PHP7 : static::ONLY_PHP5;
Chris@13:         }
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * New parser instance with given kind.
Chris@13:      *
Chris@13:      * @param string|null $kind One of class constants (only for PHP parser 2.0 and above)
Chris@13:      *
Chris@13:      * @return Parser
Chris@13:      */
Chris@13:     public function createParser($kind = null)
Chris@13:     {
Chris@13:         if ($this->hasKindsSupport()) {
Chris@13:             $originalFactory = new OriginalParserFactory();
Chris@13: 
Chris@13:             $kind = $kind ?: $this->getDefaultKind();
Chris@13: 
Chris@17:             if (!\in_array($kind, static::getPossibleKinds())) {
Chris@13:                 throw new \InvalidArgumentException('Unknown parser kind');
Chris@13:             }
Chris@13: 
Chris@17:             $parser = $originalFactory->create(\constant('PhpParser\ParserFactory::' . $kind));
Chris@13:         } else {
Chris@13:             if ($kind !== null) {
Chris@13:                 throw new \InvalidArgumentException('Install PHP Parser v2.x to specify parser kind');
Chris@13:             }
Chris@13: 
Chris@13:             $parser = new Parser(new Lexer());
Chris@13:         }
Chris@13: 
Chris@13:         return $parser;
Chris@13:     }
Chris@13: }