Merge branch 'YP-1269__nulle_email_bugfix' into 'main'

YP 1269 null email fix

See merge request ypmn-public/php-api-client!7

Author: payuru

src/Billing.php

@@ -13,38 +13,38 @@ class Billing implements BillingInterface
     /** @var ?string Фамилия */
     private string $lastName;
 
-    /** @var string Email */
-    private string $email;
+    /** @var ?string Email */
+    private ?string $email = null;
 
     /** @var ?string Номер телефона */
-    private ?string $phone;
+    private ?string $phone = null;
 
     /** @var ?string Код Страны */
-    private ?string $countryCode;
+    private ?string $countryCode = null;
 
     /** @var ?string Город */
-    private ?string $city;
+    private ?string $city = null;
 
     /** @var ?string Регион */
-    private ?string $state;
+    private ?string $state = null;
 
     /** @var ?string Название Компании */
-    private ?string $companyName;
+    private ?string $companyName = null;
 
     /** @var ?string Налоговый Идентификатор */
-    private ?string $taxId;
+    private ?string $taxId = null;
 
     /** @var ?string Первая строка адреса */
-    private ?string $addressLine1;
+    private ?string $addressLine1 = null;
 
     /** @var ?string Вторая строка адреса */
-    private ?string $addressLine2;
+    private ?string $addressLine2 = null;
 
     /** @var ?string Почтовый индекс */
-    private ?string $zipCode;
+    private ?string $zipCode = null;
 
     /** @var ?IdentityDocumentInterface удостоверение личности */
-    private ?IdentityDocumentInterface $identityDocument;
+    private ?IdentityDocumentInterface $identityDocument = null;
 
     /** @inheritDoc */
     public function getFirstName(): string
@@ -73,14 +73,15 @@ public function setLastName(string $lastName): self
     }
 
     /** @inheritDoc */
-    public function getEmail(): string
+    public function getEmail(): ?string
     {
         return $this->email;
     }
 
     /** @inheritDoc */
     public function setEmail(string $email): self
     {
+
         $this->email = $email;
         return $this;
     }

src/BillingInterface.php

@@ -39,9 +39,9 @@ public function setEmail(string $email) : self;
 
     /**
      * Получить Email
-     * @return string
+     * @return ?string
      */
-    public function getEmail() : string;
+    public function getEmail() : ?string;
 
     /**
      * Установить Номер Телефона

src/Delivery.php

@@ -11,41 +11,41 @@
  */
 class Delivery implements DeliveryInterface
 {
-    /** @var string Имя */
-    private string $firstName;
+    /** @var ?string Имя */
+    private ?string $firstName = null;
 
-    /** @var string Фамилия */
-    private string $lastName;
+    /** @var ?string Фамилия */
+    private ?string $lastName = null;
 
-    /** @var string Email */
-    private string $email;
+    /** @var ?string Email */
+    private ?string $email = null;
 
-    /** @var string Номер телефона */
-    private string $phone;
+    /** @var ?string Номер телефона */
+    private ?string $phone = null;
 
-    /** @var string Код Страны */
-    private string $countryCode;
+    /** @var ?string Код Страны */
+    private ?string $countryCode = null;
 
-    /** @var string Регион */
-    private string $state;
+    /** @var ?string Регион */
+    private ?string $state = null;
 
-    /** @var string Город */
-    private string $city;
+    /** @var ?string Город */
+    private ?string $city = null;
 
-    /** @var string Адрес - Первая Строка */
-    private string $addressLine1;
+    /** @var ?string Адрес - Первая Строка */
+    private ?string $addressLine1 = null;
 
-    /** @var string Адрес - Вторая Строка */
-    private string $addressLine2;
+    /** @var ?string Адрес - Вторая Строка */
+    private ?string $addressLine2 = null;
 
-    /** @var string Почтовый Индекс */
-    private string $zipCode;
+    /** @var ?string Почтовый Индекс */
+    private ?string $zipCode = null;
 
-    /** @var string Наименование Компании */
-    private string $companyName;
+    /** @var ?string Наименование Компании */
+    private ?string $companyName = null;
 
-    /** @var IdentityDocumentInterface Удостоверение Личности */
-    private IdentityDocumentInterface $identityDocument;
+    /** @var ?IdentityDocumentInterface Удостоверение Личности */
+    private ?IdentityDocumentInterface $identityDocument = null;
 
     /** @inheritDoc */
     public function getFirstName(): ?string
@@ -80,9 +80,14 @@ public function getEmail(): ?string
     }
 
     /** @inheritDoc */
-    public function setEmail(string $email): self
+    public function setEmail(?string $email): self
     {
-        $this->email = $email;
+        if (empty($email)) {
+            $this->email = null;
+        } else {
+            $this->email = $email;
+        }
+
         return $this;
     }
 

src/DeliveryInterface.php

@@ -32,10 +32,10 @@ public function getLastName() : ?string;
 
     /**
      * Установить Email Получателя
-     * @param string $email Email Получателя
+     * @param ?string $email Email Получателя
      * @return $this
      */
-    public function setEmail(string $email) : self;
+    public function setEmail(?string $email) : self;
 
     /**
      * Получить Email Получателя

src/Examples/simpleGetPaymentLink.php

@@ -36,7 +36,7 @@
 $billing->setFirstName('Иван');
 // Установим Фамилия Плательщика
 $billing->setLastName('Петров');
-// Установим Email Плательщика
+// Установим Email Плательщика (необязательно)
 $billing->setEmail('test1@ypmn.ru');
 // Установим Телефон Плательщика
 $billing->setPhone('+7-800-555-35-35');

src/PaymentException.php

@@ -7,10 +7,7 @@ class PaymentException extends \Exception
     /** @var string Подробности для логирования */
     private string $logText;
 
-    /**
-     * Ошибка в формате Bootstrap
-     * @return string текст ошибки
-     */
+    /** @return string Ошибка в формате Bootstrap */
     public function getHtmlMessage(): string
     {
         return '