Update README and Fetcher/HttpClient classes for improved error handling and requirements

- Added requirements section to README, specifying PHP version and necessary extensions.
- Updated installation instructions to use Composer instead of npm.
- Refactored Fetcher and HttpClient classes to replace CurlException with HttpException for better error handling.
- Modified Fetcher to allow injection of a custom PSR-18 HTTP client.

Author: Palbahngmiyine

README.md

@@ -4,9 +4,17 @@ You can send text messages(SMS, LMS, MMS), Kakao friendtalk(include notification
 package.  
 This package is 100% compatible with SOLAPI family services (Purple Book, Nurigo, etc.).
 
+## Requirements
+
+- PHP 7.1 or higher
+- `ext-json` extension
+- `allow_url_fopen` enabled in php.ini (for the default HTTP client)
+
+> **Note:** If `allow_url_fopen` is disabled in your environment (common in shared hosting), you can inject a custom PSR-18 HTTP client (e.g., Guzzle) via the `Fetcher` constructor or `getInstance()` method.
+
 ## Installing
 
-To use the SDK, simply use npm package manager CLI. Type the following into a terminal window.
+To use the SDK, simply use Composer. Type the following into a terminal window.
 
 ```bash
 composer require solapi/sdk

src/Libraries/Fetcher.php

@@ -8,7 +8,7 @@
 use Nyholm\Psr7\Request;
 use Nyholm\Psr7\Uri;
 use Nurigo\Solapi\Exceptions\BaseException;
-use Nurigo\Solapi\Exceptions\CurlException;
+use Nurigo\Solapi\Exceptions\HttpException;
 use Nurigo\Solapi\Exceptions\UnknownException;
 use Nurigo\Solapi\Models\Response\ErrorResponse;
 
@@ -22,12 +22,11 @@ class Fetcher
 
     const API_URL = "https://api.solapi.com";
     const DEFAULT_TIMEOUT = 30.0;
-    const DEFAULT_CONNECT_TIMEOUT = 10.0;
 
-    public static function getInstance(string $apiKey, string $apiSecretKey): Fetcher
+    public static function getInstance(string $apiKey, string $apiSecretKey, ?ClientInterface $httpClient = null): Fetcher
     {
         if (!isset(Fetcher::$singleton)) {
-            Fetcher::$singleton = new Fetcher($apiKey, $apiSecretKey);
+            Fetcher::$singleton = new Fetcher($apiKey, $apiSecretKey, $httpClient);
         }
         return Fetcher::$singleton;
     }
@@ -38,7 +37,6 @@ public function __construct(string $apiKey, string $apiSecretKey, ?ClientInterfa
         $this->apiSecretKey = $apiSecretKey;
         $this->httpClient = $httpClient ?? new HttpClient([
             'timeout' => self::DEFAULT_TIMEOUT,
-            'connect_timeout' => self::DEFAULT_CONNECT_TIMEOUT,
             'verify' => true,
         ]);
     }
@@ -54,7 +52,7 @@ public function __destruct()
      * @param string $uri
      * @param mixed $data
      * @return mixed
-     * @throws Exception|CurlException|BaseException|UnknownException
+     * @throws Exception|HttpException|BaseException|UnknownException
      */
     public function request(string $method, string $uri, $data = false)
     {
@@ -103,7 +101,7 @@ public function request(string $method, string $uri, $data = false)
             return $jsonResult;
 
         } catch (ClientExceptionInterface $e) {
-            throw new CurlException($e->getMessage(), null, null, $e);
+            throw new HttpException($e->getMessage(), null, null, $e);
         }
     }
 }

src/Libraries/HttpClient.php

@@ -6,18 +6,16 @@
 use Psr\Http\Message\RequestInterface;
 use Psr\Http\Message\ResponseInterface;
 use Nyholm\Psr7\Response;
-use Nurigo\Solapi\Exceptions\CurlException;
+use Nurigo\Solapi\Exceptions\HttpException;
 
 class HttpClient implements ClientInterface
 {
     protected $timeout;
-    protected $connectTimeout;
     protected $verifySsl;
 
     public function __construct(array $options = [])
     {
         $this->timeout = $options['timeout'] ?? 30.0;
-        $this->connectTimeout = $options['connect_timeout'] ?? 10.0;
         $this->verifySsl = $options['verify'] ?? true;
     }
 
@@ -66,11 +64,8 @@ public function sendRequest(RequestInterface $request): ResponseInterface
 
         if ($responseBody === false) {
             $error = error_get_last();
-            throw new CurlException(
-                $error['message'] ?? 'HTTP request failed: ' . $url,
-                null,
-                null,
-                null
+            throw new HttpException(
+                $error['message'] ?? 'HTTP request failed: ' . $url
             );
         }