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 *