Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Middleware	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Options	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
ResourceTemplate	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Testing	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Transport	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
AgentHeader.php	5.84 KB	-rw-r--r--	2026-03-12 21:22
ApiException.php	12.17 KB	-rw-r--r--	2026-03-12 21:22
ApiKeyHeaderCredentials.php	3.71 KB	-rw-r--r--	2026-03-12 21:22
ApiStatus.php	6.51 KB	-rw-r--r--	2026-03-12 21:22
ArrayTrait.php	4.57 KB	-rw-r--r--	2026-03-12 21:22
BidiStream.php	7.11 KB	-rw-r--r--	2026-03-12 21:22
Call.php	3.46 KB	-rw-r--r--	2026-03-12 21:22
ClientOptionsTrait.php	15.28 KB	-rw-r--r--	2026-03-12 21:22
ClientStream.php	4.72 KB	-rw-r--r--	2026-03-12 21:22
CredentialsWrapper.php	13.6 KB	-rw-r--r--	2026-03-12 21:22
FixedSizeCollection.php	6.26 KB	-rw-r--r--	2026-03-12 21:22
GPBLabel.php	1.82 KB	-rw-r--r--	2026-03-12 21:22
GPBType.php	2.19 KB	-rw-r--r--	2026-03-12 21:22
GapicClientTrait.php	38.24 KB	-rw-r--r--	2026-03-12 21:22
GrpcSupportTrait.php	2.24 KB	-rw-r--r--	2026-03-12 21:22
HeaderCredentialsInterface.php	2.1 KB	-rw-r--r--	2026-03-12 21:22
InsecureCredentialsWrapper.php	2.09 KB	-rw-r--r--	2026-03-12 21:22
InsecureRequestBuilder.php	649 B	-rw-r--r--	2026-03-12 21:22
KnownTypes.php	3.87 KB	-rw-r--r--	2026-03-12 21:22
OperationResponse.php	20.86 KB	-rw-r--r--	2026-03-12 21:22
Page.php	9.22 KB	-rw-r--r--	2026-03-12 21:22
PageStreamingDescriptor.php	6.18 KB	-rw-r--r--	2026-03-12 21:22
PagedListResponse.php	6.78 KB	-rw-r--r--	2026-03-12 21:22
PathTemplate.php	4.06 KB	-rw-r--r--	2026-03-12 21:22
PollingTrait.php	3.65 KB	-rw-r--r--	2026-03-12 21:22
RequestBuilder.php	9.77 KB	-rw-r--r--	2026-03-12 21:22
RequestParamsHeaderDescriptor.php	2.57 KB	-rw-r--r--	2026-03-12 21:22
ResourceHelperTrait.php	3.93 KB	-rw-r--r--	2026-03-12 21:22
RetrySettings.php	21.64 KB	-rw-r--r--	2026-03-12 21:22
Serializer.php	19.45 KB	-rw-r--r--	2026-03-12 21:22
ServerStream.php	4.49 KB	-rw-r--r--	2026-03-12 21:22
ServerStreamingCallInterface.php	2.94 KB	-rw-r--r--	2026-03-12 21:22
ServiceAddressTrait.php	2.48 KB	-rw-r--r--	2026-03-12 21:22
UriTrait.php	2.33 KB	-rw-r--r--	2026-03-12 21:22
ValidationException.php	1.7 KB	-rw-r--r--	2026-03-12 21:22
ValidationTrait.php	2.93 KB	-rw-r--r--	2026-03-12 21:22
Version.php	2.49 KB	-rw-r--r--	2026-03-12 21:22

Rename

<?php
/*
 * Copyright 2016 Google LLC
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *
 *     * Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above
 * copyright notice, this list of conditions and the following disclaimer
 * in the documentation and/or other materials provided with the
 * distribution.
 *     * Neither the name of Google Inc. nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

namespace Google\ApiCore;

/**
 * Class containing functions used to build the Agent header.
 */
class AgentHeader
{
    const AGENT_HEADER_KEY = 'x-goog-api-client';
    const UNKNOWN_VERSION = '';

/**
     * @param array $headerInfo {
     *     Optional.
     *
     *     @type string $phpVersion the PHP version.
     *     @type string $libName the name of the client application.
     *     @type string $libVersion the version of the client application.
     *     @type string $gapicVersion the code generator version of the GAPIC library.
     *     @type string $apiCoreVersion the ApiCore version.
     *     @type string $grpcVersion the gRPC version.
     *     @type string $restVersion the REST transport version (typically same as the
     *           ApiCore version).
     *     @type string $protobufVersion the protobuf version in format 'x.y.z+a' where both 'x.y.z'
     *           and '+a' are optional, and where 'a' is a single letter representing the
     *           implementation type of the protobuf runtime. It is recommended to use 'c' for a C
     *           implementation, and 'n' for the native language implementation (PHP).
     * }
     * @return array Agent header array
     */
    public static function buildAgentHeader(array $headerInfo)
    {
        $metricsHeaders = [];

// The ordering of the headers is important. We use the fact that $metricsHeaders is an
        // ordered dict. The desired ordering is:
        //      - phpVersion (gl-php/)
        //      - clientName (e.g. gccl/)
        //      - gapicVersion (gapic/)
        //      - apiCoreVersion (gax/)
        //      - grpcVersion (grpc/)
        //      - restVersion (rest/)
        //      - protobufVersion (pb/)

$metricsHeaders['gl-php'] = $headerInfo['phpVersion'] ?? phpversion();

if (isset($headerInfo['libName'])) {
            $metricsHeaders[$headerInfo['libName']] =
                $headerInfo['libVersion'] ?? self::UNKNOWN_VERSION;
        }

$apiCoreVersion = $headerInfo['apiCoreVersion'] ?? Version::getApiCoreVersion();
        $metricsHeaders['gapic'] = $headerInfo['gapicVersion'] ?? self::UNKNOWN_VERSION;
        $metricsHeaders['gax'] = $apiCoreVersion;

// Context on library type identification (between gRPC+REST and REST-only):
        // This uses the gRPC extension's version if 'grpcVersion' is not set, so we
        // cannot use the presence of 'grpcVersion' to determine whether or not a library
        // is gRPC+REST or REST-only. However, we cannot use the extension's presence
        // either, since some clients may have the extension installed but opt to use a
        // REST-only library (e.g. GCE).
        // TODO: Should we stop sending empty gRPC headers?
        $metricsHeaders['grpc'] = $headerInfo['grpcVersion'] ?? phpversion('grpc');
        $metricsHeaders['rest'] = $headerInfo['restVersion'] ?? $apiCoreVersion;

// The native version is not set by default because it is complex and costly to retrieve.
        // Users can override this default behavior if needed.
        $metricsHeaders['pb'] = $headerInfo['protobufVersion']
            ?? (phpversion('protobuf') ? phpversion('protobuf') . '+c' : '+n');

$metricsList = [];
        foreach ($metricsHeaders as $key => $value) {
            $metricsList[] = $key . '/' . $value;
        }
        return [self::AGENT_HEADER_KEY => [implode(' ', $metricsList)]];
    }

/**
     * Reads the gapic version string from a VERSION file. In order to determine the file
     * location, this method follows this procedure:
     * - accepts a class name $callingClass
     * - identifies the file defining that class
     * - searches up the directory structure for the 'src' directory
     * - looks in the directory above 'src' for a file named VERSION
     *
     * @param string $callingClass
     * @return string the gapic version
     * @throws \ReflectionException
     */
    public static function readGapicVersionFromFile(string $callingClass)
    {
        $callingClassFile = (new \ReflectionClass($callingClass))->getFileName();
        $versionFile = substr(
            $callingClassFile,
            0,
            strrpos($callingClassFile, DIRECTORY_SEPARATOR . 'src' . DIRECTORY_SEPARATOR)
        ) . DIRECTORY_SEPARATOR . 'VERSION';

return Version::readVersionFile($versionFile);
    }
}