feat(php): Add Retry Strategy & cache for the PHP client

Dockerfile

@@ -6,6 +6,9 @@ ENV DOCKER=true
 
 RUN apk add openjdk11 maven jq bash perl curl
 
+# PHP dependencies
+RUN apk add composer php8 php8-tokenizer
+
 WORKDIR /app
 
 CMD ["bash"]

clients/algoliasearch-client-php/composer.json

@@ -24,14 +24,19 @@
         "ext-json": "*",
         "ext-mbstring": "*",
         "guzzlehttp/guzzle": "^7.3",
-        "guzzlehttp/psr7": "^2.0"
+        "guzzlehttp/psr7": "^2.0",
+        "psr/http-message": "^1.0",
+        "psr/log": "^1.0 || ^2.0 || ^3.0",
+        "psr/simple-cache": "^1.0 || ^2.0 || ^3.0"
     },
     "require-dev": {
-        "phpunit/phpunit": "^8.0 || ^9.0",
-        "friendsofphp/php-cs-fixer": "^2.12"
+        "friendsofphp/php-cs-fixer": "^3.5.0"
     },
     "autoload": {
-        "psr-4": { "Algolia\\AlgoliaSearch\\" : "lib/" }
+        "psr-4": { "Algolia\\AlgoliaSearch\\" : "lib/" },
+        "files": [
+            "lib/Http/Psr7/functions.php"
+        ]
     },
     "autoload-dev": {
         "psr-4": { "Algolia\\AlgoliaSearch\\Test\\" : "test/" }

clients/algoliasearch-client-php/lib/Algolia.php

@@ -0,0 +1,118 @@
+<?php
+
+namespace Algolia\AlgoliaSearch;
+
+use Algolia\AlgoliaSearch\Cache\NullCacheDriver;
+use Algolia\AlgoliaSearch\Http\HttpClientInterface;
+use Algolia\AlgoliaSearch\Log\DebugLogger;
+use Psr\Log\LoggerInterface;
+use Psr\SimpleCache\CacheInterface;
+
+final class Algolia
+{
+    const VERSION = '0.0.0';
+
+    /**
+     * Holds an instance of the simple cache repository (PSR-16).
+     *
+     * @var \Psr\SimpleCache\CacheInterface|null
+     */
+    private static $cache;
+
+    /**
+     * Holds an instance of the logger (PSR-3).
+     *
+     * @var \Psr\Log\LoggerInterface|null
+     */
+    private static $logger;
+
+    /**
+     * @var \Algolia\AlgoliaSearch\Http\HttpClientInterface
+     */
+    private static $httpClient;
+
+    public static function isCacheEnabled()
+    {
+        if (null === self::$cache) {
+            return false;
+        }
+
+        return !self::getCache() instanceof NullCacheDriver;
+    }
+
+    /**
+     * Gets the cache instance.
+     *
+     * @return \Psr\SimpleCache\CacheInterface
+     */
+    public static function getCache()
+    {
+        if (null === self::$cache) {
+            self::setCache(new NullCacheDriver());
+        }
+
+        return self::$cache;
+    }
+
+    /**
+     * Sets the cache instance.
+     */
+    public static function setCache(CacheInterface $cache)
+    {
+        self::$cache = $cache;
+    }
+
+    /**
+     * Gets the logger instance.
+     *
+     * @return \Psr\Log\LoggerInterface
+     */
+    public static function getLogger()
+    {
+        if (null === self::$logger) {
+            self::setLogger(new DebugLogger());
+        }
+
+        return self::$logger;
+    }
+
+    /**
+     * Sets the logger instance.
+     */
+    public static function setLogger(LoggerInterface $logger)
+    {
+        self::$logger = $logger;
+    }
+
+    public static function getHttpClient()
+    {
+        $guzzleVersion = null;
+        if (interface_exists('\GuzzleHttp\ClientInterface')) {
+            if (defined('\GuzzleHttp\ClientInterface::VERSION')) {
+                $guzzleVersion = (int) mb_substr(\GuzzleHttp\Client::VERSION, 0, 1);
+            } else {
+                $guzzleVersion = \GuzzleHttp\ClientInterface::MAJOR_VERSION;
+            }
+        }
+
+        if (null === self::$httpClient) {
+            if (class_exists('\GuzzleHttp\Client') && 6 <= $guzzleVersion) {
+                self::setHttpClient(new \Algolia\AlgoliaSearch\Http\GuzzleHttpClient());
+            } else {
+                self::setHttpClient(new \Algolia\AlgoliaSearch\Http\CurlHttpClient());
+            }
+        }
+
+        return self::$httpClient;
+    }
+
+    public static function setHttpClient(HttpClientInterface $httpClient)
+    {
+        self::$httpClient = $httpClient;
+    }
+
+    public static function resetHttpClient()
+    {
+        self::$httpClient = null;
+    }
+}