@flarum/cli 2.0.0-beta.8 → 3.0.0

package/php-subsystem/vendor/nikic/php-parser/lib/PhpParser/ParserFactory.php

@@ -2,43 +2,41 @@
 
 namespace PhpParser;
 
-class ParserFactory
-{
-    const PREFER_PHP7 = 1;
-    const PREFER_PHP5 = 2;
-    const ONLY_PHP7 = 3;
-    const ONLY_PHP5 = 4;
+use PhpParser\Parser\Php7;
+use PhpParser\Parser\Php8;
 
+class ParserFactory {
     /**
-     * Creates a Parser instance, according to the provided kind.
-     *
-     * @param int        $kind  One of ::PREFER_PHP7, ::PREFER_PHP5, ::ONLY_PHP7 or ::ONLY_PHP5
-     * @param Lexer|null $lexer Lexer to use. Defaults to emulative lexer when not specified
-     * @param array      $parserOptions Parser options. See ParserAbstract::__construct() argument
-     *
-     * @return Parser The parser instance
+     * Create a parser targeting the given version on a best-effort basis. The parser will generally
+     * accept code for the newest supported version, but will try to accommodate code that becomes
+     * invalid in newer versions or changes in interpretation.
      */
-    public function create(int $kind, Lexer $lexer = null, array $parserOptions = []) : Parser {
-        if (null === $lexer) {
-            $lexer = new Lexer\Emulative();
+    public function createForVersion(PhpVersion $version): Parser {
+        if ($version->isHostVersion()) {
+            $lexer = new Lexer();
+        } else {
+            $lexer = new Lexer\Emulative($version);
         }
-        switch ($kind) {
-            case self::PREFER_PHP7:
-                return new Parser\Multiple([
-                    new Parser\Php7($lexer, $parserOptions), new Parser\Php5($lexer, $parserOptions)
-                ]);
-            case self::PREFER_PHP5:
-                return new Parser\Multiple([
-                    new Parser\Php5($lexer, $parserOptions), new Parser\Php7($lexer, $parserOptions)
-                ]);
-            case self::ONLY_PHP7:
-                return new Parser\Php7($lexer, $parserOptions);
-            case self::ONLY_PHP5:
-                return new Parser\Php5($lexer, $parserOptions);
-            default:
-                throw new \LogicException(
-                    'Kind must be one of ::PREFER_PHP7, ::PREFER_PHP5, ::ONLY_PHP7 or ::ONLY_PHP5'
-                );
+        if ($version->id >= 80000) {
+            return new Php8($lexer, $version);
         }
+        return new Php7($lexer, $version);
+    }
+
+    /**
+     * Create a parser targeting the newest version supported by this library. Code for older
+     * versions will be accepted if there have been no relevant backwards-compatibility breaks in
+     * PHP.
+     */
+    public function createForNewestSupportedVersion(): Parser {
+        return $this->createForVersion(PhpVersion::getNewestSupported());
+    }
+
+    /**
+     * Create a parser targeting the host PHP version, that is the PHP version we're currently
+     * running on. This parser will not use any token emulation.
+     */
+    public function createForHostVersion(): Parser {
+        return $this->createForVersion(PhpVersion::getHostVersion());
     }
 }

package/php-subsystem/vendor/nikic/php-parser/lib/PhpParser/PhpVersion.php

@@ -0,0 +1,164 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser;
+
+/**
+ * A PHP version, representing only the major and minor version components.
+ */
+class PhpVersion {
+    /** @var int Version ID in PHP_VERSION_ID format */
+    public int $id;
+
+    /** @var int[] Minimum versions for builtin types */
+    private const BUILTIN_TYPE_VERSIONS = [
+        'array'    => 50100,
+        'callable' => 50400,
+        'bool'     => 70000,
+        'int'      => 70000,
+        'float'    => 70000,
+        'string'   => 70000,
+        'iterable' => 70100,
+        'void'     => 70100,
+        'object'   => 70200,
+        'null'     => 80000,
+        'false'    => 80000,
+        'mixed'    => 80000,
+        'never'    => 80100,
+        'true'     => 80200,
+    ];
+
+    private function __construct(int $id) {
+        $this->id = $id;
+    }
+
+    /**
+     * Create a PhpVersion object from major and minor version components.
+     */
+    public static function fromComponents(int $major, int $minor): self {
+        return new self($major * 10000 + $minor * 100);
+    }
+
+    /**
+     * Get the newest PHP version supported by this library. Support for this version may be partial,
+     * if it is still under development.
+     */
+    public static function getNewestSupported(): self {
+        return self::fromComponents(8, 3);
+    }
+
+    /**
+     * Get the host PHP version, that is the PHP version we're currently running on.
+     */
+    public static function getHostVersion(): self {
+        return self::fromComponents(\PHP_MAJOR_VERSION, \PHP_MINOR_VERSION);
+    }
+
+    /**
+     * Parse the version from a string like "8.1".
+     */
+    public static function fromString(string $version): self {
+        if (!preg_match('/^(\d+)\.(\d+)/', $version, $matches)) {
+            throw new \LogicException("Invalid PHP version \"$version\"");
+        }
+        return self::fromComponents((int) $matches[1], (int) $matches[2]);
+    }
+
+    /**
+     * Check whether two versions are the same.
+     */
+    public function equals(PhpVersion $other): bool {
+        return $this->id === $other->id;
+    }
+
+    /**
+     * Check whether this version is greater than or equal to the argument.
+     */
+    public function newerOrEqual(PhpVersion $other): bool {
+        return $this->id >= $other->id;
+    }
+
+    /**
+     * Check whether this version is older than the argument.
+     */
+    public function older(PhpVersion $other): bool {
+        return $this->id < $other->id;
+    }
+
+    /**
+     * Check whether this is the host PHP version.
+     */
+    public function isHostVersion(): bool {
+        return $this->equals(self::getHostVersion());
+    }
+
+    /**
+     * Check whether this PHP version supports the given builtin type. Type name must be lowercase.
+     */
+    public function supportsBuiltinType(string $type): bool {
+        $minVersion = self::BUILTIN_TYPE_VERSIONS[$type] ?? null;
+        return $minVersion !== null && $this->id >= $minVersion;
+    }
+
+    /**
+     * Whether this version supports [] array literals.
+     */
+    public function supportsShortArraySyntax(): bool {
+        return $this->id >= 50400;
+    }
+
+    /**
+     * Whether this version supports [] for destructuring.
+     */
+    public function supportsShortArrayDestructuring(): bool {
+        return $this->id >= 70100;
+    }
+
+    /**
+     * Whether this version supports flexible heredoc/nowdoc.
+     */
+    public function supportsFlexibleHeredoc(): bool {
+        return $this->id >= 70300;
+    }
+
+    /**
+     * Whether this version supports trailing commas in parameter lists.
+     */
+    public function supportsTrailingCommaInParamList(): bool {
+        return $this->id >= 80000;
+    }
+
+    /**
+     * Whether this version allows "$var =& new Obj".
+     */
+    public function allowsAssignNewByReference(): bool {
+        return $this->id < 70000;
+    }
+
+    /**
+     * Whether this version allows invalid octals like "08".
+     */
+    public function allowsInvalidOctals(): bool {
+        return $this->id < 70000;
+    }
+
+    /**
+     * Whether this version allows DEL (\x7f) to occur in identifiers.
+     */
+    public function allowsDelInIdentifiers(): bool {
+        return $this->id < 70100;
+    }
+
+    /**
+     * Whether this version supports yield in expression context without parentheses.
+     */
+    public function supportsYieldWithoutParentheses(): bool {
+        return $this->id >= 70000;
+    }
+
+    /**
+     * Whether this version supports unicode escape sequences in strings.
+     */
+    public function supportsUnicodeEscapes(): bool {
+        return $this->id >= 70000;
+    }
+}