Merge branch 'main' into refactor-verify

Author: bshaffer

.github/CODEOWNERS

@@ -4,4 +4,4 @@
 # For syntax help see:
 # https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners#codeowners-syntax
 
-*     @googleapis/yoshi-php
+*     @googleapis/cloud-sdk-php-team

.github/actions/docs/entrypoint.sh

@@ -0,0 +1,2 @@
+always_check_pr_title: true
+

.github/actions/docs/sami.php

@@ -1,3 +1,3 @@
-releaseType: simple
+releaseType: php-yoshi
 handleGHRelease: true
-primaryBranch: main 
+primaryBranch: main

.github/conventional-commit-lint.yaml

@@ -10,14 +10,13 @@ branchProtectionRules:
     - 'PHP 8.1 Unit Test'
     - 'PHP 8.2 Unit Test'
     - 'PHP 8.3 Unit Test'
-    - 'PHP 8.3 --prefer-lowest Unit Test'
+    - 'PHP 8.4'
+    - 'PHP 8.4 --prefer-lowest Unit Test'
     - 'PHP Style Check'
     - 'cla/google'
   requiredApprovingReviewCount: 1
   requiresCodeOwnerReviews: true
   requiresStrictStatusChecks: true
 permissionRules:
-  - team: yoshi-php-admins
-    permission: admin
-  - team: yoshi-php
+  - team: cloud-sdk-php-team
     permission: push

.github/release-please.yml

@@ -1,29 +1,34 @@
 name: Add Release Assets
 
+permissions:
+    contents: write
+
 on:
     release:
         types: [published]
-
+    workflow_dispatch:
+        inputs:
+              tag:
+                  description: 'Tag to generate documentation for'
+                  required: true
+              upload-on-workflow-dispatch:
+                  description: 'Upload assets?'
+                  required: false
+                  default: "false"
 jobs:
     asset:
         runs-on: ${{ matrix.operating-system }}
         strategy:
             matrix:
                 operating-system: [ ubuntu-latest ]
-                php: [ "8.0", "8.3" ]
+                php: [ "8.1", "8.3" ]
 
         name: Upload Release Assets
         steps:
             - id: getTag
               name: Get Tag
               run: echo ::set-output name=tag::${GITHUB_REF#refs/*/}
 
-            - name: Get release
-              id: get_release
-              uses: bruceadams/get-release@v1.2.2
-              env:
-                GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
             - name: Checkout
               uses: actions/checkout@v2
 
@@ -50,14 +55,12 @@ jobs:
                 zip -d ${fileName} "tests*" || true &&
                 zip -d ${fileName} "examples*" || true
               env:
-                fileName: google-api-php-client-${{ steps.tagName.outputs.tag }}-PHP${{ matrix.php }}.zip
+                fileName: google-api-php-client-${{ inputs.tag || steps.tagName.outputs.tag }}-PHP${{ matrix.php }}.zip
 
             - name: Upload Release Archive
-              uses: actions/upload-release-asset@v1
-              env:
-                GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
+              uses: softprops/action-gh-release@v2
+              if: github.ref_type == 'tag' || inputs.upload-on-workflow-dispatch == 'true'
               with:
-                upload_url: ${{ steps.get_release.outputs.upload_url }}
-                asset_path: ./google-api-php-client-${{ steps.tagName.outputs.tag }}-PHP${{ matrix.php }}.zip
-                asset_name: google-api-php-client-${{ steps.tagName.outputs.tag }}-PHP${{ matrix.php }}.zip
-                asset_content_type: application/zip
+                tag_name: ${{ inputs.tag || steps.tagName.outputs.tag }}
+                files: |
+                  ./google-api-php-client-${{ inputs.tag || steps.tagName.outputs.tag }}-PHP${{ matrix.php }}.zip

.github/sync-repo-settings.yaml

@@ -1,31 +1,26 @@
 name: Generate Documentation
 on:
     push:
-        branches: [main]
+        tags:
+            - "*"
+    workflow_dispatch:
+        inputs:
+            tag:
+                description: 'Tag to generate documentation for'
+                required: false
+    pull_request:
+
+permissions:
+  contents: write
 
 jobs:
     docs:
-        name: "Generate Project Documentation"
-        runs-on: ubuntu-latest
-        steps:
-        - name: Checkout
-          uses: actions/checkout@v2
-        - run: git fetch --depth=1 origin +refs/tags/*:refs/tags/*
-        - name: Install Dependencies
-          uses: nick-invision/retry@v1
-          with:
-            timeout_minutes: 10
-            max_attempts: 3
-            command: composer install
-        - name: Generate and Push Documentation
-          uses: docker://php:8.1-cli
-          env:
-            GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
-          with:
-            entrypoint: ./.github/actions/docs/entrypoint.sh
-        - name: Deploy 🚀
-          uses: JamesIves/github-pages-deploy-action@releases/v3
-          with:
-            ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN }}
-            BRANCH: gh-pages
-            FOLDER: .docs
+        name: "Generate and Deploy Documentation"
+        uses: GoogleCloudPlatform/php-tools/.github/workflows/doctum.yml@main
+        with:
+          title: "Google Cloud PHP Client"
+          default_version: ${{ inputs.tag || github.head_ref || github.ref_name }}
+          exclude_file: aliases.php
+          tag_pattern: "v2.*"
+          dry_run: ${{ github.event_name == 'pull_request' }}
+

.github/workflows/asset-release.yml

@@ -11,12 +11,12 @@ jobs:
         strategy:
             fail-fast: false
             matrix:
-                php: [ "8.0", "8.1", "8.2", "8.3" ]
+                php: [ "8.1", "8.2", "8.3", "8.4" ]
                 composer-flags: [""]
                 include:
-                  - php: "8.0"
+                  - php: "8.1"
                     composer-flags: "--prefer-lowest "
-                  - php: "8.3"
+                  - php: "8.4"
                     composer-flags: "--prefer-lowest "
         name: PHP ${{ matrix.php }} ${{ matrix.composer-flags }}Unit Test
         steps:
@@ -65,4 +65,22 @@ jobs:
                 composer install
                 composer global require phpstan/phpstan
                 ~/.composer/vendor/bin/phpstan analyse
+    libver-check:
+        runs-on: ubuntu-latest
+        name: Verify Google\Client::LIBVER
+        steps:
+
+            - uses: actions/checkout@v2
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                php-version: '8.1'
+            - name: Verify libver
+              run: |
+                  LIBVER=$(php -r 'require "src/Client.php"; echo Google\Client::LIBVER;')
+                  RELEASEVER=$(php -r 'preg_match("/## \[(\d.\d+.\d+)\]\(/", file_get_contents("CHANGELOG.md"), $matches);echo $matches[1];')
+                  if [ "$LIBVER" != "$RELEASEVER" ]; then
+                      echo "Google\Client::LIBVER ($LIBVER) does not equal the current release ($RELEASEVER)."
+                      exit 1
+                  fi
 

.github/workflows/docs.yml

@@ -1,5 +1,74 @@
 # Changelog
 
+## 2.19.2
+
+## [2.19.1](https://github.com/googleapis/google-api-php-client/compare/v2.19.0...v2.19.1) (2026-03-27)
+
+
+### Bug Fixes
+
+* Update phpseclib minimum version ([#2709](https://github.com/googleapis/google-api-php-client/issues/2709)) ([7bb27a5](https://github.com/googleapis/google-api-php-client/commit/7bb27a5357905200a9a8affe73a61a0aec69dde7))
+
+## [2.19.0](https://github.com/googleapis/google-api-php-client/compare/v2.18.4...v2.19.0) (2026-01-09)
+
+
+### Features
+
+* Support firebase/php-jwt version 6.0 and 7.0 ([#2696](https://github.com/googleapis/google-api-php-client/issues/2696)) ([70ea42a](https://github.com/googleapis/google-api-php-client/commit/70ea42a6aa29a1321825c3dcda39cf39174390ea))
+
+
+### Bug Fixes
+
+* Upload assets release job ([#2671](https://github.com/googleapis/google-api-php-client/issues/2671)) ([0f56ea7](https://github.com/googleapis/google-api-php-client/commit/0f56ea773cb51cc6131c442d112d7fd630b49b5c))
+
+## [2.18.4](https://github.com/googleapis/google-api-php-client/compare/v2.18.3...v2.18.4) (2025-09-29)
+
+
+### Bug Fixes
+
+* Ensure credentials can be of type FetchAuthTokenInterface ([#2684](https://github.com/googleapis/google-api-php-client/issues/2684)) ([ed70802](https://github.com/googleapis/google-api-php-client/commit/ed70802cc4886ef1f513a2c0b56a8a972db5e7ab))
+
+## [2.18.3](https://github.com/googleapis/google-api-php-client/compare/v2.18.2...v2.18.3) (2025-04-08)
+
+
+### Bug Fixes
+
+* Convert Finder lazy iterator to array before deletion ([#2663](https://github.com/googleapis/google-api-php-client/issues/2663)) ([c699405](https://github.com/googleapis/google-api-php-client/commit/c6994051af1568359c97d267d9ef34ccbda31387))
+
+## [2.18.2](https://github.com/googleapis/google-api-php-client/compare/v2.18.1...v2.18.2) (2024-12-16)
+
+
+### Bug Fixes
+
+* Correct type for jwt constructor arg ([#2648](https://github.com/googleapis/google-api-php-client/issues/2648)) ([31a9861](https://github.com/googleapis/google-api-php-client/commit/31a9861af02a8e9070b395f05caed7ffce0ef8be))
+
+## [2.18.1](https://github.com/googleapis/google-api-php-client/compare/v2.18.0...v2.18.1) (2024-11-24)
+
+
+### Bug Fixes
+
+* Implicitly marking parameter  as nullable is deprecated ([#2638](https://github.com/googleapis/google-api-php-client/issues/2638)) ([de57db2](https://github.com/googleapis/google-api-php-client/commit/de57db2fdc0d56de1abbf778b28b77c3347eb3fd))
+
+## [2.18.0](https://github.com/googleapis/google-api-php-client/compare/v2.17.0...v2.18.0) (2024-10-16)
+
+
+### Features
+
+* **docs:** Use doctum shared workflow for reference docs ([#2618](https://github.com/googleapis/google-api-php-client/issues/2618)) ([242e2cb](https://github.com/googleapis/google-api-php-client/commit/242e2cb09ad5b25b047a862b4d521037e74cae29))
+
+
+### Bug Fixes
+
+* Explicit token caching issue ([#2358](https://github.com/googleapis/google-api-php-client/issues/2358)) ([dc13e5e](https://github.com/googleapis/google-api-php-client/commit/dc13e5e3f517148d3c66d151a5ab133b7840d8fb))
+
+## [2.17.0](https://github.com/googleapis/google-api-php-client/compare/v2.16.0...v2.17.0) (2024-07-10)
+
+
+### Features
+
+* Add logger to client constructor config ([#2606](https://github.com/googleapis/google-api-php-client/issues/2606)) ([1f47133](https://github.com/googleapis/google-api-php-client/commit/1f4713329d71111a317cda8ef8603fa1bdc88858))
+* Add the protected apiVersion property ([#2588](https://github.com/googleapis/google-api-php-client/issues/2588)) ([7e79f3d](https://github.com/googleapis/google-api-php-client/commit/7e79f3d7be4811f760e19cc4a2c558e04196ec1d))
+
 ## [2.16.0](https://github.com/googleapis/google-api-php-client/compare/v2.15.4...v2.16.0) (2024-04-24)