Fixed broken documentation building script (#1294)

* Fixed broken documentation building script

* Fixed references to non existing matrix values

Author: norberttech

.github/workflows/docs.yml

@@ -28,6 +28,43 @@ jobs:
       - name: "Checkout"
         uses: "actions/checkout@v4"
 
+      - name: "Install PHP"
+        uses: "shivammathur/setup-php@v2"
+        with:
+          tools: composer:v2
+          php-version: "${{ matrix.php-version }}"
+          ini-values: memory_limit=-1, post_max_size=32M, upload_max_filesize=32M
+          extensions: :psr, bcmath, dom, hash, json, mbstring, xml, xmlwriter, xmlreader, zlib, curl
+
+      - name: "Get Composer Cache Directory"
+        id: composer-cache
+        run: |
+          echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: "Cache Composer dependencies"
+        uses: "actions/cache@v4"
+        with:
+          path: "${{ steps.composer-cache.outputs.dir }}"
+          key: "php-8.2-locked-composer-${{ hashFiles('**/composer.lock') }}"
+          restore-keys: |
+            php-8.2-locked-composer-
+
+      - name: "Install dependencies"
+        run: "composer install --no-interaction --no-progress --no-suggest"
+
+      - name: "Build Docs"
+        run: "composer build:docs"
+
+      - name: Check for uncommitted changes
+        run: |
+          if [[ -n "$(git status --porcelain)" ]]; then
+            echo "Uncommitted changes detected, please run `composer build:docs` and commit the changes."
+            git status
+            exit 1
+          else
+            echo "No uncommitted changes."
+          fi
+
       - name: "MD Link Linter"
         uses: "docker://norberttech/md-link-linter:latest"
         with:

src/tools/documentation/src/Flow/Documentation/FunctionsExtractor.php

@@ -5,7 +5,7 @@
 namespace Flow\Documentation;
 
 use Flow\Documentation\Models\FunctionModel;
-use PhpParser\{NodeTraverser, ParserFactory};
+use PhpParser\{NodeTraverser, ParserFactory, PhpVersion};
 
 final class FunctionsExtractor
 {
@@ -20,7 +20,7 @@ public function __construct(
      */
     public function extract(array $paths) : \Generator
     {
-        $parser = (new ParserFactory())->create(ParserFactory::PREFER_PHP7);
+        $parser = (new ParserFactory())->createForVersion(PhpVersion::fromComponents(8, 2));
 
         $includedFiles = get_included_files();