Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Batch	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Compute	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Exception	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Iam	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Iterator	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Lock	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Logger	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
LongRunning	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Report	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Testing	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Upload	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
AnonymousCredentials.php	2.4 KB	-rw-r--r--	2026-03-17 23:07
ApiHelperTrait.php	8.01 KB	-rw-r--r--	2026-03-17 23:07
ArrayTrait.php	3.45 KB	-rw-r--r--	2026-03-17 23:07
Blob.php	2.02 KB	-rw-r--r--	2026-03-17 23:07
ClientTrait.php	8.36 KB	-rw-r--r--	2026-03-17 23:07
ConcurrencyControlTrait.php	1.35 KB	-rw-r--r--	2026-03-17 23:07
DebugInfoTrait.php	1.28 KB	-rw-r--r--	2026-03-17 23:07
DetectProjectIdTrait.php	2.98 KB	-rw-r--r--	2026-03-17 23:07
Duration.php	2.1 KB	-rw-r--r--	2026-03-17 23:07
EmulatorTrait.php	2.74 KB	-rw-r--r--	2026-03-17 23:07
ExponentialBackoff.php	4.71 KB	-rw-r--r--	2026-03-17 23:07
GeoPoint.php	5.99 KB	-rw-r--r--	2026-03-17 23:07
GrpcRequestWrapper.php	4.59 KB	-rw-r--r--	2026-03-17 23:07
GrpcTrait.php	8.92 KB	-rw-r--r--	2026-03-17 23:07
InsecureCredentialsWrapper.php	982 B	-rw-r--r--	2026-03-17 23:07
Int64.php	1.7 KB	-rw-r--r--	2026-03-17 23:07
JsonTrait.php	2.15 KB	-rw-r--r--	2026-03-17 23:07
OptionsValidator.php	4 KB	-rw-r--r--	2026-03-17 23:07
PhpArray.php	7.2 KB	-rw-r--r--	2026-03-17 23:07
RequestBuilder.php	5.18 KB	-rw-r--r--	2026-03-17 23:07
RequestHandler.php	4.18 KB	-rw-r--r--	2026-03-17 23:07
RequestProcessorTrait.php	4.47 KB	-rw-r--r--	2026-03-17 23:07
RequestWrapper.php	20.98 KB	-rw-r--r--	2026-03-17 23:07
RequestWrapperTrait.php	6.94 KB	-rw-r--r--	2026-03-17 23:07
RestTrait.php	4.78 KB	-rw-r--r--	2026-03-17 23:07
Retry.php	3.33 KB	-rw-r--r--	2026-03-17 23:07
RetryDeciderTrait.php	2.79 KB	-rw-r--r--	2026-03-17 23:07
ServiceBuilder.php	14.2 KB	-rw-r--r--	2026-03-17 23:07
SysvTrait.php	1.81 KB	-rw-r--r--	2026-03-17 23:07
TimeTrait.php	4.46 KB	-rw-r--r--	2026-03-17 23:07
Timestamp.php	4.02 KB	-rw-r--r--	2026-03-17 23:07
TimestampTrait.php	1.53 KB	-rw-r--r--	2026-03-17 23:07
UriTrait.php	1.78 KB	-rw-r--r--	2026-03-17 23:07
ValidateTrait.php	2.27 KB	-rw-r--r--	2026-03-17 23:07
ValueMapperTrait.php	1.74 KB	-rw-r--r--	2026-03-17 23:07
WhitelistTrait.php	1.13 KB	-rw-r--r--	2026-03-17 23:07

Rename

<?php
/**
 * Copyright 2016 Google Inc. All Rights Reserved.
 *
 * 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\Cloud\Core;

/**
 * Retry implementation.
 *
 * Unlike {@see \Google\Cloud\Core\ExponentialBackoff}, Retry requires an implementor
 * to supply wait times for each iteration.
 */
class Retry
{
    const RETRY_HEADER_KEY = 'x-goog-api-client';

/**
     * @var int
     */
    private $retries;

/**
     * @var callable
     */
    private $delayFunction;

/**
     * @var callable|null
     */
    private $retryFunction;

/**
     * @param int|null $retries Maximum number of retries for a failed request.
     * @param callable $delayFunction A function returning an array of format
     *        `['seconds' => (int >= 0), 'nanos' => (int >= 0)] specifying how
     *        long an operation should pause before retrying. Should accept a
     *        single argument of type `\Exception`.
     * @param callable $retryFunction [optional] returns bool for whether or not
     *        to retry.
     */
    public function __construct(
        $retries,
        callable $delayFunction,
        ?callable $retryFunction = null
    ) {
        $this->retries = $retries !== null ? (int) $retries : 3;
        $this->delayFunction = $delayFunction;
        $this->retryFunction = $retryFunction;
    }

/**
     * Executes the retry process.
     *
     * @param callable $function
     * @param array $arguments [optional]
     * @return mixed
     * @throws \Exception The last exception caught while retrying.
     */
    public function execute(callable $function, array $arguments = [])
    {
        $delayFunction = $this->delayFunction;
        $retryAttempt = 0;

$continue = true;
        do {
            try {
                $res = call_user_func_array($function, $arguments);
                $continue = false;
                return $res;
            } catch (\Exception $exception) {
                if ($this->retryFunction) {
                    if (!call_user_func($this->retryFunction, $exception, $retryAttempt)) {
                        throw $exception;
                    }
                }

if ($retryAttempt < $this->retries) {
                    $delay = $delayFunction($exception);
                    $delay += [
                        'seconds' => 0,
                        'nanos' => 0
                    ];

time_nanosleep($delay['seconds'], $delay['nanos']);

$retryAttempt++;
                } else {
                    $continue = false;
                    throw $exception;
                }
            }
        } while ($continue);
    }

/**
     * @param callable $delayFunction
     * @return void
     */
    public function setDelayFunction(callable $delayFunction)
    {
        $this->delayFunction = $delayFunction;
    }
}