mirror of
https://git.yoomoney.ru/scm/sdk/yookassa-sdk-php.git
synced 2026-08-21 18:43:26 +00:00
2db9951ff6
Информация про чеки самозанятых в платежах и возвратах удалена - больше не поддерживаем сервисы для самозанятых Добавлена возможность выставления счета по смс и email Добавлена поддержка работы со списками выплат Обновлен Copyright
761 lines
25 KiB
PHP
761 lines
25 KiB
PHP
<?php
|
||
|
||
/*
|
||
* The MIT License
|
||
*
|
||
* Copyright (c) 2026 "YooMoney", NBСO LLC
|
||
*
|
||
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
* of this software and associated documentation files (the "Software"), to deal
|
||
* in the Software without restriction, including without limitation the rights
|
||
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
* copies of the Software, and to permit persons to whom the Software is
|
||
* furnished to do so, subject to the following conditions:
|
||
*
|
||
* The above copyright notice and this permission notice shall be included in
|
||
* all copies or substantial portions of the Software.
|
||
*
|
||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||
* THE SOFTWARE.
|
||
*/
|
||
|
||
namespace YooKassa\Helpers;
|
||
|
||
use YooKassa\Model\Receipt\MarkCodeInfo;
|
||
|
||
/**
|
||
* Класс, представляющий модель ProductCode.
|
||
*
|
||
* Класс для формирования тега 1162 на основе кода в формате Data Matrix.
|
||
*
|
||
* @category Class
|
||
* @package YooKassa\Model
|
||
* @author cms@yoomoney.ru
|
||
* @link https://yookassa.ru/developers/api
|
||
*
|
||
* @example 04-product-code.php 6 7 Вариант через метод
|
||
* @example 04-product-code.php 15 7 Вариант через массив
|
||
*
|
||
* @see https://git.yoomoney.ru/projects/SDK/repos/yookassa-sdk-php/browse/lib/Helpers/ProductCode.php
|
||
*/
|
||
class ProductCode
|
||
{
|
||
/** @var string Код типа маркировки DataMatrix */
|
||
public const PREFIX_DATA_MATRIX = '444D';
|
||
|
||
/** @var string Код типа маркировки UNKNOWN */
|
||
public const PREFIX_UNKNOWN = '0000';
|
||
|
||
/** @var string Код типа маркировки EAN_8 */
|
||
public const PREFIX_EAN_8 = '4508';
|
||
|
||
/** @var string Код типа маркировки EAN_13 */
|
||
public const PREFIX_EAN_13 = '450D';
|
||
|
||
/** @var string Код типа маркировки ITF_14 */
|
||
public const PREFIX_ITF_14 = '4909';
|
||
|
||
/** @var string Код типа маркировки FUR */
|
||
public const PREFIX_FUR = '5246';
|
||
|
||
/** @var string Код типа маркировки EGAIS_20 */
|
||
public const PREFIX_EGAIS_20 = 'C514';
|
||
|
||
/** @var string Код типа маркировки EGAIS_30 */
|
||
public const PREFIX_EGAIS_30 = 'C51E';
|
||
|
||
/** @var string Тип маркировки UNKNOWN */
|
||
public const TYPE_UNKNOWN = 'unknown';
|
||
|
||
/** @var string Тип маркировки EAN_8 */
|
||
public const TYPE_EAN_8 = 'ean_8';
|
||
|
||
/** @var string Тип маркировки EAN_13 */
|
||
public const TYPE_EAN_13 = 'ean_13';
|
||
|
||
/** @var string Тип маркировки ITF_14 */
|
||
public const TYPE_ITF_14 = 'itf_14';
|
||
|
||
/** @var string Тип маркировки GS_10 */
|
||
public const TYPE_GS_10 = 'gs_10';
|
||
|
||
/** @var string Тип маркировки GS_1M */
|
||
public const TYPE_GS_1M = 'gs_1m';
|
||
|
||
/** @var string Тип маркировки SHORT */
|
||
public const TYPE_SHORT = 'short';
|
||
|
||
/** @var string Тип маркировки FUR */
|
||
public const TYPE_FUR = 'fur';
|
||
|
||
/** @var string Тип маркировки EGAIS_20 */
|
||
public const TYPE_EGAIS_20 = 'egais_20';
|
||
|
||
/** @var string Тип маркировки EGAIS_30 */
|
||
public const TYPE_EGAIS_30 = 'egais_30';
|
||
|
||
/** @var string Идентификатор применения (идентификационный номер единицы товара) */
|
||
public const AI_GTIN = '01';
|
||
|
||
/** @var string Идентификатор применения (серийный номер) */
|
||
public const AI_SERIAL = '21';
|
||
|
||
/** @var string Дополнительный идентификатор применения (цена единицы измерения товара) */
|
||
public const AI_SUM = '8005';
|
||
|
||
/** @var int Максимальная длина последовательности для кода продукта unknown */
|
||
public const MAX_PRODUCT_CODE_LENGTH = 30;
|
||
|
||
/** @var int Максимальная длина последовательности для кода маркировки типа unknown */
|
||
public const MAX_MARK_CODE_LENGTH = 32;
|
||
|
||
/** @var string|null Код типа маркировки */
|
||
private ?string $prefix = null;
|
||
|
||
/**
|
||
* @var string|null Тип маркировки
|
||
*
|
||
* @example unknown
|
||
*/
|
||
private ?string $type = null;
|
||
|
||
/**
|
||
* @var string|null Global Trade Item Number
|
||
* Глобальный номер товарной продукции в единой международной базе товаров GS1 https://ru.wikipedia.org/wiki/GS1
|
||
*
|
||
* @example 04630037591316
|
||
*/
|
||
private ?string $gtin = null;
|
||
|
||
/**
|
||
* @var string|null Серийный номер товара
|
||
*
|
||
* @example sgEKKPPcS25y5
|
||
*/
|
||
private ?string $serial = null;
|
||
|
||
/**
|
||
* @var null|array Массив дополнительных идентификаторов применения
|
||
*/
|
||
private ?array $appIdentifiers = null;
|
||
|
||
/**
|
||
* @var string|null Сформированный тег 1162. Формат: hex([prefix]+gtin+serial)
|
||
*
|
||
* @example 04 36 03 BE F5 14 73 67 45 4b 4b 50 50 63 53 32 35 79 35
|
||
*/
|
||
private ?string $result = null;
|
||
|
||
/**
|
||
* @var MarkCodeInfo|null Сформированный код товара (тег в 54 ФЗ — 1163)
|
||
*/
|
||
private ?MarkCodeInfo $markCodeInfo = null;
|
||
|
||
/** @var bool Флаг использования кода типа маркировки */
|
||
private bool $usePrefix = false;
|
||
|
||
/**
|
||
* ProductCode constructor.
|
||
*
|
||
* @param null|string $codeDataMatrix Строка, расшифрованная из QR-кода
|
||
* @param bool|string $usePrefix Нужен ли код типа маркировки в результате
|
||
*/
|
||
public function __construct(?string $codeDataMatrix = null, mixed $usePrefix = true)
|
||
{
|
||
$this->preparePrefix($usePrefix);
|
||
|
||
if (!empty($codeDataMatrix) && $this->parseCodeMatrixData($codeDataMatrix)) {
|
||
$this->result = $this->calcResult();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Приводит объект к строке.
|
||
*/
|
||
public function __toString(): string
|
||
{
|
||
return $this->getResult();
|
||
}
|
||
|
||
/**
|
||
* Возвращает код типа маркировки.
|
||
*
|
||
* @return ?string Код типа маркировки
|
||
*/
|
||
public function getPrefix(): ?string
|
||
{
|
||
return $this->prefix;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает код типа маркировки.
|
||
*
|
||
* @param int|string|null $prefix Код типа маркировки
|
||
*/
|
||
public function setPrefix(mixed $prefix): ProductCode
|
||
{
|
||
if (null === $prefix || '' === $prefix) {
|
||
$this->prefix = null;
|
||
|
||
return $this;
|
||
}
|
||
|
||
if (is_int($prefix)) {
|
||
$prefix = dechex($prefix);
|
||
}
|
||
$this->prefix = str_pad($prefix, 4, '0', STR_PAD_LEFT);
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает тип маркировки.
|
||
*
|
||
* @return string|null Тип маркировки
|
||
*/
|
||
public function getType(): ?string
|
||
{
|
||
return $this->type;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает тип маркировки.
|
||
*
|
||
* @param string $type Тип маркировки
|
||
*/
|
||
public function setType(string $type): void
|
||
{
|
||
$this->type = $type;
|
||
}
|
||
|
||
/**
|
||
* Возвращает глобальный номер товарной продукции.
|
||
*
|
||
* @return string|null Глобальный номер товарной продукции
|
||
*/
|
||
public function getGtin(): ?string
|
||
{
|
||
return $this->gtin;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает глобальный номер товарной продукции.
|
||
*
|
||
* @param string|null $gtin Глобальный номер товарной продукции
|
||
* @return ProductCode
|
||
*/
|
||
public function setGtin(?string $gtin): ProductCode
|
||
{
|
||
if (null === $gtin || '' === $gtin) {
|
||
$this->gtin = null;
|
||
} else {
|
||
$this->gtin = $gtin;
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает серийный номер товара.
|
||
*
|
||
* @return string|null Серийный номер товара
|
||
*/
|
||
public function getSerial(): ?string
|
||
{
|
||
return $this->serial;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает серийный номер товара.
|
||
*
|
||
* @param string|null $serial Серийный номер товара
|
||
* @return ProductCode
|
||
*/
|
||
public function setSerial(?string $serial): ProductCode
|
||
{
|
||
if (null === $serial || '' === $serial) {
|
||
$this->prefix = null;
|
||
} else {
|
||
$this->serial = $serial;
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает массив дополнительных идентификаторов применения.
|
||
*
|
||
* @return null|array Массив дополнительных идентификаторов применения
|
||
*/
|
||
public function getAppIdentifiers(): ?array
|
||
{
|
||
return $this->appIdentifiers;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает массив дополнительных идентификаторов применения.
|
||
*
|
||
* @param null|array $appIdentifiers Массив дополнительных идентификаторов применения
|
||
*/
|
||
public function setAppIdentifiers(?array $appIdentifiers): void
|
||
{
|
||
$this->appIdentifiers = $appIdentifiers;
|
||
}
|
||
|
||
/**
|
||
* Возвращает сформированный тег 1162.
|
||
*
|
||
* @return string Сформированный тег 1162
|
||
*/
|
||
public function getResult(): string
|
||
{
|
||
if (!$this->result) {
|
||
$this->result = $this->calcResult();
|
||
}
|
||
|
||
return $this->result;
|
||
}
|
||
|
||
public function getMarkCodeInfo(): ?MarkCodeInfo
|
||
{
|
||
return $this->markCodeInfo;
|
||
}
|
||
|
||
/**
|
||
* @param array|MarkCodeInfo|string $markCodeInfo
|
||
*/
|
||
public function setMarkCodeInfo(mixed $markCodeInfo): void
|
||
{
|
||
if (is_array($markCodeInfo)) {
|
||
$markCodeInfo = new MarkCodeInfo($markCodeInfo);
|
||
}
|
||
if (is_string($markCodeInfo)) {
|
||
$markCodeInfo = new MarkCodeInfo([
|
||
$this->getType() => $markCodeInfo,
|
||
]);
|
||
}
|
||
|
||
$this->markCodeInfo = $markCodeInfo;
|
||
}
|
||
|
||
/**
|
||
* Возвращает флаг использования кода типа маркировки.
|
||
*/
|
||
public function isUsePrefix(): bool
|
||
{
|
||
return $this->usePrefix;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает флаг использования кода типа маркировки.
|
||
*
|
||
* @param bool $usePrefix Флаг использования кода типа маркировки
|
||
* @return ProductCode
|
||
*/
|
||
public function setUsePrefix(bool $usePrefix): ProductCode
|
||
{
|
||
$this->usePrefix = $usePrefix;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Формирует тег 1162.
|
||
*
|
||
* @return string Сформированный тег 1162
|
||
*/
|
||
public function calcResult(): string
|
||
{
|
||
$result = '';
|
||
|
||
if (!$this->validate()) {
|
||
return $result;
|
||
}
|
||
|
||
if ($this->isUsePrefix()) {
|
||
$result = $this->getPrefix() ?: self::PREFIX_DATA_MATRIX;
|
||
}
|
||
|
||
switch ($this->getType()) {
|
||
case self::TYPE_EAN_8:
|
||
case self::TYPE_EAN_13:
|
||
case self::TYPE_ITF_14:
|
||
$result .= $this->numToHex($this->getGtin());
|
||
|
||
break;
|
||
|
||
case self::TYPE_FUR:
|
||
case self::TYPE_EGAIS_20:
|
||
case self::TYPE_EGAIS_30:
|
||
case self::TYPE_UNKNOWN:
|
||
$result .= $this->strToHex($this->getGtin());
|
||
|
||
break;
|
||
|
||
case self::TYPE_SHORT:
|
||
$result .= $this->numToHex($this->getGtin());
|
||
$result .= $this->strToHex($this->getSerial());
|
||
|
||
break;
|
||
|
||
case self::TYPE_GS_1M:
|
||
case self::TYPE_GS_10:
|
||
$result .= $this->numToHex($this->getGtin());
|
||
$result .= $this->strToHex($this->getSerial());
|
||
if ($sum = $this->getAIValue(self::AI_SUM)) {
|
||
$result .= $this->strToHex($sum);
|
||
}
|
||
|
||
break;
|
||
}
|
||
|
||
return $this->chunkStr($result);
|
||
}
|
||
|
||
/**
|
||
* Проверяет заполненность необходимых свойств.
|
||
*/
|
||
public function validate(): bool
|
||
{
|
||
if (!$this->getType()) {
|
||
return false;
|
||
}
|
||
|
||
return match ($this->getType()) {
|
||
self::TYPE_EAN_8, self::TYPE_EAN_13, self::TYPE_ITF_14, self::TYPE_FUR, self::TYPE_EGAIS_20, self::TYPE_EGAIS_30, self::TYPE_UNKNOWN => null !== $this->getGtin(),
|
||
self::TYPE_GS_10, self::TYPE_GS_1M, self::TYPE_SHORT => $this->getGtin() && $this->getSerial(),
|
||
default => false,
|
||
};
|
||
|
||
}
|
||
|
||
/**
|
||
* Устанавливает prefix и usePrefix в зависимости от входящего параметра.
|
||
*
|
||
* @param mixed $usePrefix Код типа маркировки или bool
|
||
*/
|
||
private function preparePrefix(mixed $usePrefix): void
|
||
{
|
||
if ($usePrefix) {
|
||
$this->setUsePrefix(true);
|
||
if (is_string($usePrefix) || is_int($usePrefix)) {
|
||
$this->setPrefix($usePrefix);
|
||
} else {
|
||
$this->setPrefix(self::PREFIX_UNKNOWN);
|
||
}
|
||
} else {
|
||
$this->setUsePrefix(false);
|
||
$this->setPrefix(null);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Извлекает необходимые данные из строки, расшифрованной из QR-кода и устанавливает соответствующие свойства.
|
||
* Возвращает результат в виде bool.
|
||
*
|
||
* @param string $codeDataMatrix Строки, расшифрованная из QR-кода
|
||
*
|
||
* @return false
|
||
*/
|
||
private function parseCodeMatrixData(string $codeDataMatrix): bool
|
||
{
|
||
$this->fillData(
|
||
$this->parseScanString($codeDataMatrix)
|
||
?: ['type' => self::TYPE_UNKNOWN, 'code' => $codeDataMatrix]
|
||
);
|
||
|
||
return $this->validate();
|
||
}
|
||
|
||
/**
|
||
* Заполняет поля объекта из массива данных.
|
||
*
|
||
* @param array $data Массив данных
|
||
*/
|
||
private function fillData(array $data): void
|
||
{
|
||
$this->setType($data['type']);
|
||
$this->setPrefix($this->getPrefixByType($data['type']));
|
||
|
||
switch ($this->getType()) {
|
||
case self::TYPE_EAN_8:
|
||
case self::TYPE_EAN_13:
|
||
case self::TYPE_ITF_14:
|
||
case self::TYPE_FUR:
|
||
case self::TYPE_EGAIS_30:
|
||
$this->setGtin($data['match1']);
|
||
$this->setMarkCodeInfo($this->getGtin());
|
||
|
||
break;
|
||
|
||
case self::TYPE_EGAIS_20:
|
||
$this->setGtin($data['match2']);
|
||
$this->setMarkCodeInfo($this->getGtin());
|
||
|
||
break;
|
||
|
||
case self::TYPE_SHORT:
|
||
$this->setGtin($data['match1']);
|
||
$this->setSerial($data['match2']);
|
||
$this->setMarkCodeInfo(self::AI_GTIN . $this->getGtin() . self::AI_SERIAL . $this->getSerial());
|
||
|
||
break;
|
||
|
||
case self::TYPE_GS_1M:
|
||
case self::TYPE_GS_10:
|
||
$this->setGtin($data['match1']);
|
||
if (!empty($data['split']) && count($data['split']) > 1) {
|
||
$this->setSerial(array_shift($data['split']));
|
||
$this->setAppIdentifiers($data['split']);
|
||
} else {
|
||
$this->setSerial($data['match2']);
|
||
}
|
||
$this->setMarkCodeInfo(self::AI_GTIN . $this->getGtin() . self::AI_SERIAL . $this->getSerial());
|
||
|
||
break;
|
||
|
||
case self::TYPE_UNKNOWN:
|
||
$this->setGtin(strlen($data['code']) > self::MAX_PRODUCT_CODE_LENGTH ? substr($data['code'], 0, self::MAX_PRODUCT_CODE_LENGTH) : $data['code']);
|
||
$this->setSerial(strlen($data['code']) > self::MAX_MARK_CODE_LENGTH ? substr($data['code'], 0, self::MAX_MARK_CODE_LENGTH) : $data['code']);
|
||
$this->setMarkCodeInfo($this->getSerial());
|
||
|
||
break;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Возвращает массив данных, полученных по правилам из считанной сканером последовательности.
|
||
*
|
||
* @param string $code Считанная сканером последовательность
|
||
*
|
||
* @return array|void Массив данных, полученных по правилам
|
||
*/
|
||
private function parseScanString(string $code)
|
||
{
|
||
foreach ($this->getMarkCodeRules() as $codeType => $rule) {
|
||
if (!empty($rule['length']) && strlen($code) !== $rule['length']) {
|
||
continue;
|
||
}
|
||
preg_match($rule['pattern'], $code, $matches);
|
||
if ($rule['matches'][1] && empty($matches[1])) {
|
||
continue;
|
||
}
|
||
if ($rule['matches'][2] && empty($matches[2])) {
|
||
continue;
|
||
}
|
||
if (!empty($rule['split'])) {
|
||
$split = preg_split($rule['split'], $matches[2]);
|
||
}
|
||
|
||
return [
|
||
'type' => $codeType,
|
||
'code' => $code,
|
||
'rules' => $rule['matches'],
|
||
'match1' => $rule['matches'][1] ? $matches[1] : null,
|
||
'match2' => $rule['matches'][2] ? $matches[2] : null,
|
||
'split' => !empty($split) ? $split : null,
|
||
];
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Возвращает список правил определения типа маркировки.
|
||
*
|
||
* @return array[]
|
||
*/
|
||
private function getMarkCodeRules(): array
|
||
{
|
||
return [
|
||
self::TYPE_GS_1M => [
|
||
'pattern' => '#^01(\d{14})21(.+)((91(.+)92(.+))|(93[\w!"%&\'()*+,-./_:;=<>?]{4}(.*)))$#ui',
|
||
'matches' => [1 => true, 2 => true],
|
||
'split' => '#\\\u001d|\x{001d}#ui',
|
||
],
|
||
self::TYPE_GS_10 => [
|
||
'pattern' => '#^01(\d{14})21(.+)$#ui',
|
||
'matches' => [1 => true, 2 => true],
|
||
'split' => '#\\\u001d|\x{001d}#ui',
|
||
],
|
||
self::TYPE_SHORT => [
|
||
'length' => 29,
|
||
'pattern' => '#^(\d{14})(.+)$#i',
|
||
'matches' => [1 => true, 2 => true],
|
||
],
|
||
self::TYPE_EGAIS_20 => [
|
||
'length' => 68,
|
||
'pattern' => '#^(.{8})(.{33})(.+)$#ui',
|
||
'matches' => [1 => false, 2 => true],
|
||
],
|
||
self::TYPE_EGAIS_30 => [
|
||
'length' => 150,
|
||
'pattern' => '#^(.{14})(.+)$#ui',
|
||
'matches' => [1 => true, 2 => false],
|
||
],
|
||
self::TYPE_ITF_14 => [
|
||
'length' => 14,
|
||
'pattern' => '#^(0\d{13})$#ui',
|
||
'matches' => [1 => true, 2 => false],
|
||
],
|
||
self::TYPE_EAN_13 => [
|
||
'length' => 13,
|
||
'pattern' => '#^(\d{13})$#ui',
|
||
'matches' => [1 => true, 2 => false],
|
||
],
|
||
self::TYPE_EAN_8 => [
|
||
'length' => 8,
|
||
'pattern' => '#^(\d{8})$#ui',
|
||
'matches' => [1 => true, 2 => false],
|
||
],
|
||
self::TYPE_FUR => [
|
||
'length' => 20,
|
||
'pattern' => '#^((\w{2})-(\d{6})-(\w{10}))$#ui',
|
||
'matches' => [1 => true, 2 => false],
|
||
],
|
||
];
|
||
}
|
||
|
||
/**
|
||
* Возвращает значение идентификатора применения, если он присутствует
|
||
*
|
||
* @param string $appIdentifier Идентификатор применения
|
||
*
|
||
* @return null|string Значение идентификатора применения
|
||
*/
|
||
private function getAIValue(string $appIdentifier): ?string
|
||
{
|
||
if (!$this->getAppIdentifiers()) {
|
||
return null;
|
||
}
|
||
foreach ($this->getAppIdentifiers() as $item) {
|
||
if (str_starts_with($item, $appIdentifier)) {
|
||
return str_replace($appIdentifier, '', $item);
|
||
}
|
||
}
|
||
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* Возвращает префикс кода товара типу маркировки.
|
||
*
|
||
* @param null|string $type Тип маркировки
|
||
*
|
||
* @return null|string Префикс кода товара
|
||
*/
|
||
private function getPrefixByType(?string $type = null): ?string
|
||
{
|
||
if (!$type) {
|
||
$type = $this->getType();
|
||
}
|
||
$map = [
|
||
self::TYPE_UNKNOWN => self::PREFIX_UNKNOWN,
|
||
self::TYPE_EAN_8 => self::PREFIX_EAN_8,
|
||
self::TYPE_EAN_13 => self::PREFIX_EAN_13,
|
||
self::TYPE_ITF_14 => self::PREFIX_ITF_14,
|
||
self::TYPE_GS_10 => self::PREFIX_DATA_MATRIX,
|
||
self::TYPE_GS_1M => self::PREFIX_DATA_MATRIX,
|
||
self::TYPE_SHORT => self::PREFIX_DATA_MATRIX,
|
||
self::TYPE_FUR => self::PREFIX_FUR,
|
||
self::TYPE_EGAIS_20 => self::PREFIX_EGAIS_20,
|
||
self::TYPE_EGAIS_30 => self::PREFIX_EGAIS_30,
|
||
];
|
||
|
||
return !empty($map[$type]) ? $map[$type] : self::PREFIX_UNKNOWN;
|
||
}
|
||
|
||
/**
|
||
* Разбивает пробелами строку на пары символов и переводит в верхний регистр
|
||
*
|
||
* @param string $string Подготовленная к разбиению строка
|
||
*/
|
||
private function chunkStr(string $string): string
|
||
{
|
||
return strtoupper(trim(chunk_split($string, 2, ' ')));
|
||
}
|
||
|
||
/**
|
||
* Переводит десятичное число в шестнадцатеричный вид и дополняет нулями до 12 символов слева.
|
||
*
|
||
* @param string $string Входящее число (Глобальный номер товарной продукции)
|
||
*/
|
||
private function numToHex(string $string): string
|
||
{
|
||
return str_pad($this->baseConvert($string), 12, '0', STR_PAD_LEFT);
|
||
}
|
||
|
||
/**
|
||
* Переводит число из одной системы исчисления в другую
|
||
* Замена dechex() для 32-битных версии PHP.
|
||
*/
|
||
private function baseConvert(string $numString, int $fromBase = 10, int $toBase = 16): string
|
||
{
|
||
$chars = '0123456789abcdefghijklmnopqrstuvwxyz';
|
||
$toString = substr($chars, 0, $toBase);
|
||
|
||
$length = mb_strlen($numString);
|
||
$result = '';
|
||
$number = [];
|
||
|
||
for ($i = 0; $i < $length; $i++) {
|
||
$number[$i] = strpos($chars, $numString[$i]);
|
||
}
|
||
|
||
do {
|
||
$divide = 0;
|
||
$newLen = 0;
|
||
for ($i = 0; $i < $length; $i++) {
|
||
$divide = $divide * $fromBase + $number[$i];
|
||
if ($divide >= $toBase) {
|
||
$number[$newLen++] = (int) ($divide / $toBase);
|
||
$divide %= $toBase;
|
||
} elseif ($newLen > 0) {
|
||
$number[$newLen++] = 0;
|
||
}
|
||
}
|
||
$length = $newLen;
|
||
$result = $toString[$divide] . $result;
|
||
} while (0 !== $newLen);
|
||
|
||
return $result;
|
||
}
|
||
|
||
/**
|
||
* Переводит строку в шестнадцатеричный вид.
|
||
*
|
||
* @param string $string Входящая строка (Серийный номер товара)
|
||
*/
|
||
private function strToHex(string $string): string
|
||
{
|
||
$hex = '';
|
||
$length = mb_strlen($string);
|
||
for ($i = 0; $i < $length; $i++) {
|
||
$ord = ord($string[$i]);
|
||
$hexCode = dechex($ord);
|
||
$hex .= substr('0' . $hexCode, -2);
|
||
}
|
||
|
||
return $hex;
|
||
}
|
||
|
||
/**
|
||
* Переводит строку из шестнадцатеричного вида в обычный
|
||
* Нужен для тестирования.
|
||
*
|
||
* @param string $hex Входящая строка в шестнадцатеричном виде
|
||
*/
|
||
private function hexToStr(string $hex): string
|
||
{
|
||
$string = '';
|
||
for ($i = 0; $i < strlen($hex) - 1; $i += 2) {
|
||
$string .= chr(hexdec($hex[$i] . $hex[$i + 1]));
|
||
}
|
||
|
||
return $string;
|
||
}
|
||
}
|