init

2026-05-12 21:10:38 +02:00
commit ab96d82fcf
2544 changed files with 721700 additions and 0 deletions
@@ -0,0 +1,95 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
+ * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ * @link          https://cakephp.org CakePHP(tm) Project
+ * @since         3.6.0
+ * @license       https://opensource.org/licenses/mit-license.php MIT License
+ */
+namespace Cake\Core\Retry;
+
+use Closure;
+use Exception;
+
+/**
+ * Allows any action to be retried in case of an exception.
+ *
+ * This class can be parametrized with a strategy, which will be followed
+ * to determine whether the action should be retried.
+ */
+class CommandRetry
+{
+    /**
+     * The strategy to follow should the executed action fail.
+     *
+     * @var \Cake\Core\Retry\RetryStrategyInterface
+     */
+    protected RetryStrategyInterface $strategy;
+
+    /**
+     * @var int
+     */
+    protected int $maxRetries;
+
+    /**
+     * @var int
+     */
+    protected int $numRetries;
+
+    /**
+     * Creates the CommandRetry object with the given strategy and retry count
+     *
+     * @param \Cake\Core\Retry\RetryStrategyInterface $strategy The strategy to follow should the action fail
+     * @param int $maxRetries The maximum number of retry attempts allowed
+     */
+    public function __construct(RetryStrategyInterface $strategy, int $maxRetries = 1)
+    {
+        $this->strategy = $strategy;
+        $this->maxRetries = $maxRetries;
+    }
+
+    /**
+     * The number of retries to perform in case of failure
+     *
+     * @param \Closure $action Callback to run for each attempt
+     * @return mixed The return value of the passed action callable
+     * @throws \Exception Throws exception from last failure
+     */
+    public function run(Closure $action): mixed
+    {
+        $this->numRetries = 0;
+        while (true) {
+            try {
+                return $action();
+            } catch (Exception $e) {
+                if (
+                    $this->numRetries < $this->maxRetries &&
+                    $this->strategy->shouldRetry($e, $this->numRetries)
+                ) {
+                    $this->numRetries++;
+                    continue;
+                }
+
+                throw $e;
+            }
+        }
+    }
+
+    /**
+     * Returns the last number of retry attempts.
+     *
+     * @return int
+     */
+    public function getRetries(): int
+    {
+        return $this->numRetries;
+    }
+}
@@ -0,0 +1,35 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
+ * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ * @link          https://cakephp.org CakePHP(tm) Project
+ * @since         3.6.0
+ * @license       https://opensource.org/licenses/mit-license.php MIT License
+ */
+namespace Cake\Core\Retry;
+
+use Exception;
+
+/**
+ * Used to instruct a CommandRetry object on whether a retry
+ * for an action should be performed
+ */
+interface RetryStrategyInterface
+{
+    /**
+     * Returns true if the action can be retried, false otherwise.
+     *
+     * @param \Exception $exception The exception that caused the action to fail
+     * @param int $retryCount The number of times action has been retried
+     * @return bool Whether it is OK to retry the action
+     */
+    public function shouldRetry(Exception $exception, int $retryCount): bool;
+}