README

KatenaChain Symfony 客户端扩展包，集成了 sdk-php-client。

安装

使用 Symfony Flex 的应用程序

目前不可用。

不使用 Symfony Flex 的应用程序

步骤 1: 下载扩展包

打开终端，进入您的项目目录，然后执行以下命令以下载此扩展包的最新稳定版本

$ composer require katena-chain/client-bundle

此命令需要您全局安装了 Composer，如 Composer 文档中的安装章节所述。

步骤 2: 启用扩展包

Symfony 版本 < 4.0

然后，通过将扩展包添加到项目中 app/AppKernel.php 文件中注册的扩展包列表中，来启用扩展包

// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            // ...
            new <vendor>\<bundle-name>\<bundle-long-name>(),
        ];

        // ...
    }

    // ...
}

Symfony 版本 > 4.0

然后，通过将扩展包添加到项目中 bundles.php 文件中注册的扩展包列表中，来启用扩展包

// bundles.php

return [
    //...
    KatenaChain\ClientBundle\KCClientBundle::class => ['all' => true]
];

步骤 3: 添加配置文件

Symfony 版本 < 4.0

然后，在 app/config/kc_client.yml 中添加配置文件

#app/config/kc_client.yml

kc_client:
    chain:
        chain_id: "%env(resolve:KC_CHAIN_ID)%"
        signer_company_bcid: "%env(resolve:KC_SIGNER_COMPANY_BCID)%"
        signer_id: "%env(resolve:KC_SIGNER_ID)%"
        signer_private_key: "%env(resolve:KC_SIGNER_PRIVATE_KEY)%"
    api:
        url: "%env(resolve:KC_API_URL)%"

Symfony 版本 > 4.0

然后，在 config/packages/kc_client.yml 中添加配置文件

#config/packages/kc_client.yml

kc_client:
    chain:
        chain_id: "%env(resolve:KC_CHAIN_ID)%"
        signer_company_bcid: "%env(resolve:KC_SIGNER_COMPANY_BCID)%"
        signer_id: "%env(resolve:KC_SIGNER_ID)%"
        signer_private_key: "%env(resolve:KC_SIGNER_PRIVATE_KEY)%"
    api:
        url: "%env(resolve:KC_API_URL)%"

步骤 4: 更新 .env 文件

在您的 .env 文件中添加以下内容

###> katena-chain/client-bundle ###
KC_SIGNER_PRIVATE_KEY="7C67DeoLnhI6jvsp3eMksU2Z6uzj8sqZbpgwZqfIyuCZbfoPcitCiCsSp2EzCfkY52Mx58xDOyQLb1OhC7cL5A=="
KC_SIGNER_COMPANY_BCID="abcdef"
KC_SIGNER_ID="36b72ca9-fd58-44aa-b90d-5a855276ff82"
KC_CHAIN_ID="katena-chain-test"
KC_API_URL="https://nodes.test.katena.transchain.io/api/v1"
###< katena-chain/client-bundle###

使用方法

通过依赖注入

只需需要 KatenaChain\ClientBundle\Services\Transactor 服务。

//...

use KatenaChain\ClientBundle\Services\Transactor;

//...

    /**
     * @var Transactor
     */
    protected $transactor;

//...
    public function __construct(Transactor $transactor)
    {
        //...
        $this->transactor = $transactor;
        //...
    }
//...

通过服务容器

$transactor = $this->get("kc_client.transactor");

发送证书

$transactor->sendCertificateRawV1Tx("ce492f92-a529-40c1-91e9-2af71e74ebea", "document_signature_value");

Katena 文档

有关更多信息，请参阅katena 文档