2021-11-18 04:24:30 +00:00
|
|
|
<?php
|
2022-12-14 16:19:55 +00:00
|
|
|
|
2021-11-18 04:24:30 +00:00
|
|
|
/*
|
|
|
|
* Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
|
|
|
|
*
|
|
|
|
* This code is licensed under MIT.
|
|
|
|
* Этот код распространяется по лицензии MIT.
|
|
|
|
* https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
|
|
|
|
*/
|
|
|
|
|
2022-12-14 16:19:55 +00:00
|
|
|
declare(strict_types=1);
|
2021-11-18 04:24:30 +00:00
|
|
|
|
|
|
|
namespace AtolOnline\Entities;
|
|
|
|
|
2022-12-14 16:19:55 +00:00
|
|
|
use AtolOnline\Constraints;
|
2021-12-03 10:23:00 +00:00
|
|
|
use AtolOnline\Exceptions\{
|
|
|
|
InvalidEmailException,
|
|
|
|
InvalidInnLengthException,
|
|
|
|
InvalidPhoneException,
|
|
|
|
TooLongClientNameException,
|
2021-12-08 11:04:14 +00:00
|
|
|
TooLongEmailException};
|
2021-12-03 10:23:00 +00:00
|
|
|
use AtolOnline\Traits\{
|
|
|
|
HasEmail,
|
2021-12-08 11:04:14 +00:00
|
|
|
HasInn};
|
2021-12-03 10:23:00 +00:00
|
|
|
use JetBrains\PhpStorm\Pure;
|
2021-11-18 04:24:30 +00:00
|
|
|
|
|
|
|
/**
|
2021-12-01 12:11:08 +00:00
|
|
|
* Класс, описывающий покупателя
|
2021-11-18 04:24:30 +00:00
|
|
|
*
|
2021-12-01 12:11:08 +00:00
|
|
|
* @see https://online.atol.ru/files/API_atol_online_v4.pdf Документация, стр 17
|
2021-11-18 04:24:30 +00:00
|
|
|
*/
|
2021-12-03 10:24:21 +00:00
|
|
|
final class Client extends Entity
|
2021-11-18 04:24:30 +00:00
|
|
|
{
|
2022-12-14 16:19:55 +00:00
|
|
|
use HasEmail;
|
|
|
|
use HasInn;
|
2021-11-18 04:24:30 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Конструктор объекта покупателя
|
|
|
|
*
|
2021-11-23 17:30:54 +00:00
|
|
|
* @param string|null $name Наименование (1227)
|
2021-11-24 10:55:53 +00:00
|
|
|
* @param string|null $email Телефон (1008)
|
2021-12-03 10:23:00 +00:00
|
|
|
* @param string|null $phone Email (1008)
|
2021-11-23 17:30:54 +00:00
|
|
|
* @param string|null $inn ИНН (1228)
|
2021-11-21 11:06:55 +00:00
|
|
|
* @throws InvalidEmailException
|
|
|
|
* @throws InvalidInnLengthException
|
2021-12-03 10:23:00 +00:00
|
|
|
* @throws InvalidPhoneException
|
|
|
|
* @throws TooLongClientNameException
|
|
|
|
* @throws TooLongEmailException
|
2021-11-18 04:24:30 +00:00
|
|
|
*/
|
|
|
|
public function __construct(
|
2022-12-14 16:19:55 +00:00
|
|
|
protected ?string $name = null,
|
|
|
|
protected ?string $phone = null,
|
2021-11-18 04:24:30 +00:00
|
|
|
?string $email = null,
|
|
|
|
?string $inn = null
|
2021-11-24 10:55:53 +00:00
|
|
|
) {
|
2021-11-21 11:06:55 +00:00
|
|
|
!is_null($name) && $this->setName($name);
|
|
|
|
!is_null($email) && $this->setEmail($email);
|
|
|
|
!is_null($phone) && $this->setPhone($phone);
|
|
|
|
!is_null($inn) && $this->setInn($inn);
|
2021-11-18 04:24:30 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Возвращает наименование покупателя
|
|
|
|
*
|
|
|
|
* @return string|null
|
|
|
|
*/
|
|
|
|
public function getName(): ?string
|
|
|
|
{
|
|
|
|
return $this->name;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Устанавливает наименование покупателя
|
|
|
|
*
|
|
|
|
* @param string|null $name
|
|
|
|
* @return $this
|
2021-11-22 06:51:10 +00:00
|
|
|
* @throws TooLongClientNameException
|
2021-11-18 04:24:30 +00:00
|
|
|
*/
|
2021-11-21 11:06:55 +00:00
|
|
|
public function setName(?string $name): self
|
2021-11-18 04:24:30 +00:00
|
|
|
{
|
|
|
|
if (is_string($name)) {
|
|
|
|
$name = preg_replace('/[\n\r\t]/', '', trim($name));
|
|
|
|
if (mb_strlen($name) > Constraints::MAX_LENGTH_CLIENT_NAME) {
|
2021-11-22 06:51:10 +00:00
|
|
|
throw new TooLongClientNameException($name);
|
2021-11-18 04:24:30 +00:00
|
|
|
}
|
|
|
|
}
|
2021-12-08 11:04:14 +00:00
|
|
|
$this->name = $name ?: null;
|
2021-11-18 04:24:30 +00:00
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Возвращает установленный телефон
|
|
|
|
*
|
|
|
|
* @return string|null
|
|
|
|
*/
|
|
|
|
public function getPhone(): ?string
|
|
|
|
{
|
|
|
|
return $this->phone;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Устанавливает телефон
|
|
|
|
*
|
|
|
|
* @param string|null $phone Номер телефона
|
|
|
|
* @return $this
|
2021-12-01 12:11:08 +00:00
|
|
|
* @throws InvalidPhoneException
|
2021-11-18 04:24:30 +00:00
|
|
|
*/
|
2021-11-21 11:06:55 +00:00
|
|
|
public function setPhone(?string $phone): self
|
2021-11-18 04:24:30 +00:00
|
|
|
{
|
|
|
|
if (is_string($phone)) {
|
2022-12-14 16:19:55 +00:00
|
|
|
$phone = preg_replace('/\D/', '', trim($phone));
|
|
|
|
if (preg_match(Constraints::PATTERN_PHONE, $phone) !== 1) {
|
2021-12-01 12:11:08 +00:00
|
|
|
throw new InvalidPhoneException($phone);
|
2021-11-18 04:24:30 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
$this->phone = empty($phone) ? null : "+$phone";
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @inheritDoc
|
|
|
|
*/
|
2021-12-03 10:23:00 +00:00
|
|
|
#[Pure]
|
2021-11-23 17:30:54 +00:00
|
|
|
public function jsonSerialize(): array
|
2021-11-18 04:24:30 +00:00
|
|
|
{
|
|
|
|
$json = [];
|
2021-12-18 06:45:00 +00:00
|
|
|
!is_null($this->getName()) && $json['name'] = $this->getName();
|
|
|
|
!is_null($this->getPhone()) && $json['phone'] = $this->getPhone();
|
2022-12-14 16:19:55 +00:00
|
|
|
!is_null($this->getEmail()) && $json['email'] = $this->getEmail();
|
2021-12-18 06:45:00 +00:00
|
|
|
!is_null($this->getInn()) && $json['inn'] = $this->getInn();
|
2021-11-23 17:30:54 +00:00
|
|
|
return $json;
|
2021-11-18 04:24:30 +00:00
|
|
|
}
|
|
|
|
}
|