Download the PHP package k-shym/urfa-client without Composer
On this page you can find all versions of the php package k-shym/urfa-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package urfa-client
URFAClient
Универсальный PHP клиент для биллинговой системы NetUp UTM5 на основе api.xml
Установка (composer)
Зависимости
- UTM 5.2.1-008 >=
- PHP 5.4 >=
- Ext: JSON, OpenSSL, SimpleXML, Hash, Filter
Описание параметров
| option | default | описание |
|---|---|---|
| login* | — | логин администратора или пользователя |
| password* | — | пароль администратора или пользователя соответственно |
| address* | — | адрес ядра UTM5 |
| port | 11758 | порт ядра UTM5 |
| timeout | 30 | время ожидания ответа от сервера |
| protocol | auto | ssl или tls (доступно с версии UTM-5.3-002-update16) или auto (доступно с версии UTM-5.3-005-update2, работает с OpenSSL 1.1) |
| admin | true | указываем какой пользователь подключается, если TRUE предоставляет сертификат admin.crt для соединения, используется только для протокола ssl |
| api | api_53-006.xml | путь до файла api.xml |
CMD
Пример
Рассмотрим пример использования библиотеки на примере функции rpcf_add_user_new, у нас есть XML описание:
И так, нам нужно описать входные параметры (элемент input) в ассоциативный массив.
Если в элементе присутствует атрибут default, параметр считается необязательным.
Получаем полное описание параметров функции rpcf_add_user_new из api.xml:
На основе данного описания оставляем необходимые нам параметры, порядок параметров неважен.
Как было замечено, разработчики UTM5 не пришли к единому формату описания функций. Отсюда возник вопрос, какое имя давать параметру for для элементов массива?
Поэтому было принято решение, в качестве имени использовать имя атрибута счетчика *_count. В нашем случае будет так:
Если попадется элемент error будет выброшено исключение XML Described error:, а далее атрибуты ошибки.
C условиями if все просто, если истина, то заходим внутрь. И содержание обрабатывается, как описано выше.
В итоге, получаем минимальный набор параметров для создания пользователя:
В переменную $result попадут данные которые описаны в элементе output.
Тесты
Возможные проблемы
- Тестировалось на версии биллинга UTM-5.3-003, UTM-5.4-004 и UTM-5.5-015
- Тестировались не все функции из api.xml
- При обновлении api.xml обязательно проверяйте используемые функции
По возникшим проблемам присылайте api.xml и полную версию ядра UTM5. Удачи!
All versions of urfa-client with dependencies
ext-openssl Version *
ext-simplexml Version *
ext-bcmath Version *
ext-filter Version *
ext-hash Version *