README

CZ: PHP库，用于轻松处理IPEX B2B的Rest API IPEX B2B

感谢

如果没有Spoje.Net公司的慷慨支持，这个库的诞生是不可能的，该公司承担了为VoIP服务增加信用额度解决方案的开发费用。👍

在Spoje.Net公司，您可以订购商业支持，以将库集成到您的项目中。

安装

composer require spoje.net/ipexb2b

配置

配置是通过设置以下常量来执行的

/**
 * Write logs as:
 */
define('LOG_NAME', 'IPEXB2B_Test');
define('LOG_TYPE', 'syslog');

/*
 * URL ipex-b2b API
 */
define('IPEX_URL', 'https://restapi.ipex.cz');
/*
 * Uživatel ipex-b2b API
 */
define('IPEX_LOGIN', 'firma_api');
/*
 * Heslo ipex-b2b API
 */
define('IPEX_PASSWORD', 'Ceeghul');

或者在创建类实例时输入登录凭据。

    $pravnik = new \IPEXB2B\Rights(null,[
                'url' => 'https://testapi.ipex.cz',
                'user' => 'resttest',
                'password' => '-dj3x21xaA_'
            ]);

此设置方式优先于上述定义的常量。

整个库是如何工作的？

整个库的核心组件是ApiClient类，它能够通过PHP的curl扩展与IPEX的REST API进行通信。

由此衍生出用于各个部分的类，包含常用的操作方法，例如VoIP中的“增加信用”。

新的衍生类是通过将类名设置为部分名称来创建的。

也就是说，如果我们想为“simcards”部分创建一个新类，它将看起来像这样

    <?php
    class Simcards extends /IPEXB2B/ApiClient
    {
        /**
         * Evidence užitá objektem.
         *
         * @var string
         */
        public $evidence = 'merna-jednotka';
    }

然后就可以轻松地将SIM卡在两行中打印出来

    $jednotky = new Simcards();
    print_r( $jednotky->requestData() );

Docker

docker pull vitexsoftware/ipex-b2b

Debian/Ubuntu

对于Linux，提供了.deb软件包。请使用repo

sudo apt install lsb-release wget apt-transport-https bzip2

sudo wget -O /usr/share/keyrings/vitexsoftware.gpg https://repo.vitexsoftware.cz/keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/vitexsoftware.gpg]  https://repo.vitexsoftware.cz  $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update

sudo apt install php-spojenet-ipex-b2b

在这种情况下，需要将以下内容添加到您的应用程序的composer.json文件中

    "require": {
        "deb/ipex-b2b": "*",
        "deb/ease-core": "*"
    },
    "repositories": [
        {
            "type": "path",
            "url": "/usr/share/php/IPEXB2B",
            "options": {
                "symlink": true
            }
        },
        {
            "type": "path",
            "url": "/usr/share/php/EaseCore",
            "options": {
                "symlink": true
            }
        }
    ]

因此，在安装依赖项时，它将看起来像这样

Loading composer repositories with package information
Installing dependencies from lock file
  - Installing deb/ease-framework (1.24)
    Symlinked from /usr/share/php/Ease

  - Installing deb/ipex-b2b (0.2.1)
    Symlinked from /usr/share/php/IPEXB2B

可以通过apt-get全局更新整个系统的更新。

构建

通过运行debian/deb-package.sh来创建Debian软件包

Docker镜像

docker build -t vitexsoftware/ipex-b2b