4.3 KiB

Raw Permalink Blame History

АТОЛ Онлайн

Библиотека для фискализации чеков по 54-ФЗ через облачные ККТ АТОЛ.

Текущие поддерживаемые версии АТОЛ Онлайн:

Протокол	API	ФФД	Статус
v4	5.10	1.05	Поддерживается
v5	3.0	1.2	В планах

Поддерживаемые возможности:

Мониторинг ККТ и ФН
Фискализация документов на облачной ККТ
Валидация данных до отправки документа на ККТ (насколько это возможно, согласно схеме)
Расчёты денег в копейках
PSR-4 автозагрузка, покрытие настоящими тестами, fluent-setters, докблоки

Системные требования

php v8.1 и выше
php-json
php-mbstring
composer

Для использования на php8.0 используйте версии библиотеки до 1.0.2 включительно.

Начало работы

Подключение библиотеки

Подключить пакет к проекту:
```
composer require axenov/atol-online
```
В нужном месте проекта подключить автозагрузчик composer-зависимостей, если это не сделано ранее:
```
require($project_root . '/vendor/autoload.php');
```
где $project_root — абсолютный путь к корневой директории вашего проекта.

При использовании фреймворков это обычно не требуется.

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

Вы имеете право использовать и распространять код на условиях лицензии MIT.

Дополнительная информация может быть найдена здесь:

Тестирование кода библиотеки

Файлы тестов находятся в директории /tests корня репозитория.

Для запуска тестов необходимо перейти в корень репозитория и выполнить одну из команд:

composer psalm    # статический анализ
composer phpcs    # синтаксический анализ
composer test     # полное тестирование без покрытия
composer coverage # полное тестирование с покрытием

После тестирования с покрытием в корне репозитория создаётся отчёт, который сохраняется в директории .coverage. Для тестирования с покрытием необходим php-xdebug с параметром xdebug.mode = coverage,....

4.3 KiB Raw Permalink Blame History Unescape Escape