Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Cache	[ DIR ]	drwxr-sr-x	2026-03-18 20:03
CredentialSource	[ DIR ]	drwxr-sr-x	2026-03-18 20:03
Credentials	[ DIR ]	drwxr-sr-x	2026-03-18 20:03
ExecutableHandler	[ DIR ]	drwxr-sr-x	2026-03-18 20:03
HttpHandler	[ DIR ]	drwxr-sr-x	2026-03-18 20:03
Logging	[ DIR ]	drwxr-sr-x	2026-03-18 20:03
Middleware	[ DIR ]	drwxr-sr-x	2026-03-18 20:03
AccessToken.php	17.08 KB	-rw-r--r--	2026-03-18 20:03
ApplicationDefaultCredentials.php	15.04 KB	-rw-r--r--	2026-03-18 20:03
CacheTrait.php	2.56 KB	-rw-r--r--	2026-03-18 20:03
CredentialsLoader.php	10.87 KB	-rw-r--r--	2026-03-18 20:03
ExternalAccountCredentialSourceInterface.php	804 B	-rw-r--r--	2026-03-18 20:03
FetchAuthTokenCache.php	10.59 KB	-rw-r--r--	2026-03-18 20:03
FetchAuthTokenInterface.php	1.63 KB	-rw-r--r--	2026-03-18 20:03
GCECache.php	2.31 KB	-rw-r--r--	2026-03-18 20:03
GetQuotaProjectInterface.php	947 B	-rw-r--r--	2026-03-18 20:03
GetUniverseDomainInterface.php	1.06 KB	-rw-r--r--	2026-03-18 20:03
Iam.php	5.03 KB	-rw-r--r--	2026-03-18 20:03
IamSignerTrait.php	2.4 KB	-rw-r--r--	2026-03-18 20:03
MetricsTrait.php	3.9 KB	-rw-r--r--	2026-03-18 20:03
OAuth2.php	48.56 KB	-rw-r--r--	2026-03-18 20:03
ProjectIdProviderInterface.php	968 B	-rw-r--r--	2026-03-18 20:03
ServiceAccountSignerTrait.php	1.81 KB	-rw-r--r--	2026-03-18 20:03
SignBlobInterface.php	1.5 KB	-rw-r--r--	2026-03-18 20:03
UpdateMetadataInterface.php	1.22 KB	-rw-r--r--	2026-03-18 20:03
UpdateMetadataTrait.php	2.39 KB	-rw-r--r--	2026-03-18 20:03

Rename

<?php
/*
 * Copyright 2023 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

namespace Google\Auth;

/**
 * Provides shared methods for updating request metadata (request headers).
 *
 * Should implement {@see UpdateMetadataInterface} and {@see FetchAuthTokenInterface}.
 *
 * @internal
 */
trait UpdateMetadataTrait
{
    use MetricsTrait;

/**
     * export a callback function which updates runtime metadata.
     *
     * @return callable updateMetadata function
     * @deprecated
     */
    public function getUpdateMetadataFunc()
    {
        return [$this, 'updateMetadata'];
    }

/**
     * Updates metadata with the authorization token.
     *
     * @param array<mixed> $metadata metadata hashmap
     * @param string $authUri optional auth uri
     * @param callable|null $httpHandler callback which delivers psr7 request
     * @return array<mixed> updated metadata hashmap
     */
    public function updateMetadata(
        $metadata,
        $authUri = null,
        ?callable $httpHandler = null
    ) {
        $metadata_copy = $metadata;

// We do need to set the service api usage metrics irrespective even if
        // the auth token is set because invoking this method with auth tokens
        // would mean the intention is to just explicitly set the metrics metadata.
        $metadata_copy = $this->applyServiceApiUsageMetrics($metadata_copy);

if (isset($metadata_copy[self::AUTH_METADATA_KEY])) {
            // Auth metadata has already been set
            return $metadata_copy;
        }
        $result = $this->fetchAuthToken($httpHandler);
        if (isset($result['access_token'])) {
            $metadata_copy[self::AUTH_METADATA_KEY] = ['Bearer ' . $result['access_token']];
        } elseif (isset($result['id_token'])) {
            $metadata_copy[self::AUTH_METADATA_KEY] = ['Bearer ' . $result['id_token']];
        }
        return $metadata_copy;
    }
}