TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:31 +02:00
commit 3e43c11539
407 changed files with 51272 additions and 0 deletions
@@ -0,0 +1,85 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Install\ExtensionScanner\Php\Matcher;
+
+use PhpParser\Node;
+use PhpParser\Node\Expr\MethodCall;
+use PhpParser\Node\Identifier;
+
+/**
+ * Find usages of method calls which were removed / deprecated.
+ * This is a "weak" match since we're just testing for method name
+ * but not connected class.
+ * @internal This class is only meant to be used within EXT:install and is not part of the TYPO3 Core API.
+ */
+class MethodCallMatcher extends AbstractCoreMatcher
+{
+    /**
+     * Prepare $this->flatMatcherDefinitions once
+     *
+     * @param array $matcherDefinitions Incoming main configuration
+     */
+    public function __construct(array $matcherDefinitions)
+    {
+        $this->matcherDefinitions = $matcherDefinitions;
+        $this->validateMatcherDefinitions(['numberOfMandatoryArguments', 'maximumNumberOfArguments']);
+        $this->initializeFlatMatcherDefinitions();
+    }
+
+    /**
+     * Called by PhpParser.
+     * Test for "->deprecated()" (weak match)
+     */
+    public function enterNode(Node $node): null
+    {
+        // Match method call (not static)
+        if (!$this->isFileIgnored($node)
+            && !$this->isLineIgnored($node)
+            && $node instanceof MethodCall
+            && $node->name instanceof Identifier
+            && array_key_exists($node->name->name, $this->flatMatcherDefinitions)
+        ) {
+            $match = [
+                'restFiles' => [],
+                'line' => $node->getAttribute('startLine'),
+                'message' => 'Call to method "' . $node->name->name . '()"',
+                'indicator' => 'weak',
+            ];
+
+            $numberOfArguments = count($node->args);
+            $isArgumentUnpackingUsed = $this->isArgumentUnpackingUsed($node->args);
+
+            $isPossibleMatch = false;
+            foreach ($this->flatMatcherDefinitions[$node->name->name]['candidates'] as $candidate) {
+                // A method call is considered a match if it is called with argument unpacking, or
+                // if the number of given arguments is within range of mandatory / max number of arguments
+                if ($isArgumentUnpackingUsed
+                    || ($numberOfArguments >= $candidate['numberOfMandatoryArguments']
+                        && $numberOfArguments <= $candidate['maximumNumberOfArguments'])
+                ) {
+                    $isPossibleMatch = true;
+                    $match['restFiles'] = array_unique(array_merge($match['restFiles'], $candidate['restFiles']));
+                }
+            }
+            if ($isPossibleMatch) {
+                $this->matches[] = $match;
+            }
+        }
+        return null;
+    }
+}