GroupMessageResponse 내 여러 타입 추가 및 MMS 기능 추가

Author: Palbahngmiyine

src/Exceptions/MessageNotReceivedException.php

@@ -3,25 +3,26 @@
 namespace Nurigo\Solapi\Exceptions;
 
 use Exception;
+use Nurigo\Solapi\Models\Response\FailedMessage;
 
 class MessageNotReceivedException extends Exception
 {
     /**
-     * @var array
+     * @var FailedMessage[]
      */
     public $failedMessageList;
 
     /**
-     * @param array $failedMessageList
+     * @param FailedMessage[] $failedMessageList
      */
-    public function __construct(array $failedMessageList)
+    public function __construct($failedMessageList)
     {
         $this->failedMessageList = $failedMessageList;
         parent::__construct("메시지 접수에 실패했습니다.");
     }
 
     /**
-     * @return array
+     * @return FailedMessage[]
      */
     public function getFailedMessageList(): array
     {

src/Libraries/Authenticator.php

@@ -4,13 +4,19 @@
 
 class Authenticator
 {
+    /**
+     * @param string $apiKey
+     * @param string $apiSecretKey
+     * @return string
+     */
     public static function getAuthorizationHeaderInfo(string $apiKey, string $apiSecretKey): string
     {
         // TODO: Timezone 문제가 생길 수 있어 추후 수정 필요
         date_default_timezone_set("Asia/Seoul");
         $date = date("Y-m-d\TH:i:s.Z\Z", time());
         $salt = uniqid();
         $signature = hash_hmac("sha256", $date . $salt, $apiSecretKey);
+
         return "Authorization: HMAC-SHA256 apiKey={$apiKey}, date={$date}, salt={$salt}, signature={$signature}";
     }
 }

src/Libraries/Fetcher.php

@@ -10,19 +10,31 @@
  */
 class Fetcher
 {
+    /**
+     * @var Fetcher
+     */
     private static $singleton;
 
     protected $apiKey = '';
     protected $apiSecretKey = '';
 
     const API_URL = "https://api.solapi.com";
 
-    public static function getInstance(string $apiKey, string $apiSecretKey)
+    /**
+     * @param string $apiKey
+     * @param string $apiSecretKey
+     * @return Fetcher
+     */
+    public static function getInstance(string $apiKey, string $apiSecretKey): Fetcher
     {
         if (!isset(Fetcher::$singleton)) Fetcher::$singleton = new Fetcher($apiKey, $apiSecretKey);
         return Fetcher::$singleton;
     }
 
+    /**
+     * @param string $apiKey
+     * @param string $apiSecretKey
+     */
     public function __construct(string $apiKey, string $apiSecretKey)
     {
         $this->apiKey = $apiKey;

src/Models/Message.php

@@ -4,7 +4,6 @@
 
 use Nurigo\Solapi\Models\Kakao\KakaoOption;
 
-// TODO: Property 설명 정의해야 함
 class Message
 {
     /**
@@ -26,9 +25,20 @@ class Message
      * @var string 스토리지 내 이미지 ID
      */
     public $imageId;
+
+    /**
+     * @var string 문자 제목(LMS, MMS 전용 옵션)
+     */
     public $subject;
+
+    /**
+     * @var string 국가번호
+     */
     public $country = "82";
 
+    /**
+     * @var KakaoOption
+     */
     public $kakaoOptions;
 
     /**

src/Models/Request/SendRequest.php

@@ -32,7 +32,7 @@ class SendRequest
      * @param DateTime|null $scheduledDate
      * @param bool $allowDuplicates
      */
-    public function __construct(array $messages, DateTime $scheduledDate = null, bool $allowDuplicates = false)
+    public function __construct($messages, $scheduledDate = null, $allowDuplicates = false)
     {
         $this->messages = $messages;
         if ($scheduledDate != null) {

src/Models/Request/UploadFileRequest.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace Nurigo\Solapi\Models\Request;
+
+class UploadFileRequest
+{
+    /**
+     * @var string base64 encode된 문자
+     */
+    public $file;
+
+    /**
+     * @var string file 유형(MMS, KAKAO 등)
+     */
+    public $type;
+
+    /**
+     * @var string|null 파일 이름
+     */
+    public $name;
+
+    /**
+     * @var string|null 첨부파일 링크(친구톡 이미지 전용)
+     */
+    public $link;
+
+    /**
+     * @return string
+     */
+    public function getFile(): string
+    {
+        return $this->file;
+    }
+
+    /**
+     * @param string $file
+     * @return UploadFileRequest
+     */
+    public function setFile(string $file): UploadFileRequest
+    {
+        $this->file = $file;
+        return $this;
+    }
+
+    /**
+     * @return string
+     */
+    public function getType(): string
+    {
+        return $this->type;
+    }
+
+    /**
+     * @param string $type
+     * @return UploadFileRequest
+     */
+    public function setType(string $type): UploadFileRequest
+    {
+        $this->type = $type;
+        return $this;
+    }
+
+    /**
+     * @return string|null
+     */
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * @param string|null $name
+     * @return UploadFileRequest
+     */
+    public function setName(string $name): UploadFileRequest
+    {
+        $this->name = $name;
+        return $this;
+    }
+
+    /**
+     * @return string|null
+     */
+    public function getLink(): string
+    {
+        return $this->link;
+    }
+
+    /**
+     * @param string|null $link
+     * @return UploadFileRequest
+     */
+    public function setLink(string $link): UploadFileRequest
+    {
+        $this->link = $link;
+        return $this;
+    }
+
+    public function __construct()
+    {
+        unset($this->name);
+        unset($this->link);
+    }
+}

src/Models/Response/FailedMessage.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace Nurigo\Solapi\Models\Response;
+
+class FailedMessage
+{
+    /**
+     * @var string
+     */
+    public $to;
+
+    /**
+     * @var string
+     */
+    public $from;
+
+    /**
+     * @var string
+     */
+    public $type;
+
+    /**
+     * @var string
+     */
+    public $statusMessage;
+
+    /**
+     * @var string
+     */
+    public $country;
+
+    /**
+     * @var string
+     */
+    public $messageId;
+
+    /**
+     * @var string
+     */
+    public $statusCode;
+
+    /**
+     * @var string
+     */
+    public $accountId;
+}

src/Models/Response/SendResponse.php

@@ -12,7 +12,7 @@ class SendResponse implements JsonSerializable
     public $groupInfo;
 
     /**
-     * @var array
+     * @var FailedMessage[]
      */
     public $failedMessageList;
 
@@ -25,6 +25,9 @@ public function __construct($value)
         $this->failedMessageList = $value->failedMessageList;
     }
 
+    /**
+     * @return array
+     */
     public function jsonSerialize(): array
     {
         return [

src/Models/Response/UploadFileResponse.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace Nurigo\Solapi\Models\Response;
+
+class UploadFileResponse
+{
+    /**
+     * @var string
+     */
+    public $type;
+
+    /**
+     * @var string
+     */
+    public $originalName;
+
+    /**
+     * @var string
+     */
+    public $link;
+
+    /**
+     * @var string
+     */
+    public $fileId;
+
+    /**
+     * @var string
+     */
+    public $name;
+
+    /**
+     * @var string
+     */
+    public $url;
+
+    /**
+     * @var string
+     */
+    public $accountId;
+
+    /**
+     * @var string
+     */
+    public $dateCreated;
+
+    /**
+     * @var string
+     */
+    public $dateUpdated;
+
+    /**
+     * @param mixed $value
+     */
+    public function __construct($value)
+    {
+        $this->type = $value->type;
+        $this->originalName = $value->originalName;
+        $this->link = $value->link;
+        $this->fileId = $value->fileId;
+        $this->name = $value->name;
+        $this->url = $value->url;
+        $this->accountId = $value->accountId;
+        $this->dateCreated = $value->dateCreated;
+        $this->dateUpdated = $value->dateUpdated;
+    }
+}