kilylabs/qr-payment-php

Генерация QR-кодов для оплаты на базе ГОСТ Р 56042-2014 для PHP

Maintainers

Details

github.com/kilylabs/qr-payment-php

Source

Issues

Installs: 5 933

Dependents: 0

Suggesters: 0

Security: 0

Stars: 13

Watchers: 2

Forks: 5

Open Issues: 2

0.1 2021-09-29 14:14 UTC

Requires

Requires (Dev)

MIT 84b17aecebc37df819711fda53d6b7eb7418f979

  • Alexander Bogdanov <ab.woop@dev.kily.ru>

paymentqrgost56042

This package is auto-updated.

Last update: 2025-01-06 19:19:31 UTC

README

Библиотека для генерации QR-кодов оплаты (с банковскими реквизитами), соответствующая стандарту ГОСТ Р 56042—2014 для PHP 7.4+. Эти коды принимаются почти всеми банками (включая Сбербанк) и существенно упрощают жизнь обычными пользователям, которым не нужно вбивать реквизиты вручную.

Установка

Рекомендуемый способ установки через Composer:

$ composer require kilylabs/qr-payment-php

Использование

Пример использования

<?php

require __DIR__.'/vendor/autoload.php';

use Kily\Payment\QR\Gost;
use Kily\Payment\QR\Exception as QRException;

$g = new Gost();

$g->setThrowExceptions(true); // Бросать исключения (поведение по-умолчанию)
$g->setValidateOnSet(false); // Отключить валидацию при уcтановке значения (поведение по-умолчанию)

var_dump($g->listRequired());
// выводится список обязательных атрибутов
//var_dump($g->listAdditional());
// выводится список дополнительных атрибутов
//var_dump($g->listOther());
// выводится список других атрибутов

$g->Name = 'ИП Богданов Александр Сергеевич';
$g->PersonalAcc = '40802810700020000317';
$g->BankName = 'ОАО АКБ «АВАНГАРД»';
$g->BIC = '044525201';
$g->CorrespAcc = '30101810000000000201';

try {
    $g->validate();

    echo $g->generate();
    // выводит: ST00012|Name=ИП Богданов Александр Сергеевич|PersonalAcc=40802810700020000317|BankName=ОАО АКБ «АВАНГАРД»|BIC=044525201|CorrespAcc=30101810000000000201
    echo $g->render();
    // выводит QR-код в бинарном формате (PNG)
    echo $g->render(false,[
        'imageBase64'=>true,
    ]);
    // выводит изображение в base64 (inline)
    // больше опций здесь: (https://github.com/chillerlan/php-qrcode/wiki/QROptions)
    $g->render("qr.png");
    // сохраняет QR-код в файл
} catch(QRException $e) {
    // something went wrong
    throw $e;
}

TODO

  • сделать генерацию Aztec и DataMatrix кодов (согласно стандарту ГОСТ)
  • сделать список доступных полей
  • добавить другие кодировки (win1251, koi8-r) для сокращения размера

Купите мне... кофе ☕

Вы можете купить мне кофе, отсканировав QR-код, сделанный с помощью этой библиотеки. Возможно, этот кофе поможет сделать очередное улучшение этой библиотеки 😌

Alt text