Draft workflow to open API refs PR

Author: adriendupuis

.github/workflows/api_refs.yaml

@@ -0,0 +1,54 @@
+name: 'Build API Refs'
+
+on:
+    workflow_dispatch:
+        inputs:
+            version:
+                description: 'Released version'
+                required: true
+                type: string
+
+jobs:
+    open_php_api_ref_pr:
+        name: "PHP & REST API References' PR"
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Set version and branches
+              id: version_and_branches
+              run: |
+                  version="${{ inputs.version }}"
+                  base_branch="$(echo $version | sed -s /v(.*\..*)\..*/\1/)"
+                  work_branch="api_refs_$version"
+                  echo "version=$version" >> "$GITHUB_OUTPUT"
+                  echo "base_branch=$base_branch" >> "$GITHUB_OUTPUT"
+                  echo "work_branch=$work_branch" >> "$GITHUB_OUTPUT"
+
+            - name: Checkout documentation
+              uses: actions/checkout@v4
+
+            - name: Build API Refs
+              # TODO: On 5.0, update tool to handle both PHP & REST APIs
+              # TODO: Composer auth?
+              run: tools/php_api_ref/phpdoc.sh
+
+            - name: Commit and push
+              run: |
+                  git checkout ${{ steps.version_and_branches.outputs.work_branch }}
+                  git add docs/api/php_api/php_api_reference/ tools/php_api_ref/.phpdoc/template/package-edition-map.twig
+                  #TODO: Set a user?
+                  git commit -m "PHP API Ref HTML"
+                  #TODO: git add doc/api/rest_api/rest_api_reference/rest_api_reference.html
+                  #TODO: git commit -m "REST API Ref HTML"
+                  #TODO: permission to push? Use an action? https://github.com/marketplace/actions/github-push 
+                  git push
+
+            - name: Create Pull Request
+              uses: peter-evans/create-pull-request@v3
+              with:
+                  #TODO: token: ${{ ? }}
+                  title: "PHP API Ref ${{ steps.version_and_branches.outputs.version }}"
+                  body: "PHP API Reference update for ${{ steps.version_and_branches.outputs.version }}"
+                  branch: "${{ steps.version_and_branches.outputs.work_branch }}"
+                  base: "${{ steps.version_and_branches.outputs.base_branch }}"
+                  draft: false