帮助中心 > 技术文档 > 服务端SDK > PHP SDK > SDK配置

PHP SDK接入流程主要分为两个步骤(两个文档)

1、SDK配置:将对应的SDK集成到您的产品项目中,然后进行初始化代码处理;
2、SDK接入:将需要上报的业务数据,按照SDK中对应的的方法进行数据上送。


1. 集成Hina PHP SDK

SDK 最低兼容 PHP 7.4,部分功能依赖 curl 扩展。
有两种集成方式:
1、使用composer集成

{
    "require": {
        "hinacloud/hina-sdk-php": "v1.0.0"
    }
}

2、直接下载SDK源码集成到项目中

1)下载SDK离线包(zip包),详见【资源下载】;
2)下载zip包并解压,获取HinaSdk.php文件,集成到已有项目中

2. 获取数据接收地址

如果使用cloud服务,数据接收地址如:

参考文档: 数据上报地址获取

3. 初始化

3.1 生产环境中使用FileConsumer初始化

<?php
    require_once("HinaSdk.php");

    # 初始化一个 Consumer,用于数据发送
    $consumer = new FileConsumer("ha.log." . date('Y-m-d'));

    # 使用 Consumer 来构造 sdk 对象
    $ha = new HinaSdk($consumer);

    # 以下是触发一个事件测试数据发送
    $account_id = 'ABCDEF123456789';
    $ha->track($account_id, true, 'login');
    # flush方法可以保证条数在不足一个批次的时候,也可以发送出去
    $ha->flush();
?>

3.2 少量数据或者测试环境中使用BatchConsumer初始化

<?php
    require_once("HinaSdk.php");

    # 从海纳分析配置页面中获取的数据接收的 URL
    $SERVER_URL = 'YOUR_SERVER_URL';

    # 初始化一个 Consumer,用于数据发送
    $consumer = new BatchConsumer($SERVER_URL);
    # 支持指定每次发送的条数,默认是200条
    # $consumer = new BatchConsumer($SERVER_URL,200);

    # 使用 Consumer 来构造 sdk 对象
    $ha = new HinaSdk($consumer);

    # 以下是触发一个事件测试数据发送
    $account_id = 'ABCDEF123456789';
    $ha->track($account_id, true, 'login');

    # flush方法可以保证条数在不足一个批次的时候,也可以发送出去
    $ha->flush();
?>

3.3 调试模式用DebugConsumer

<?php
    require_once("HinaSdk.php");

    # 从海纳分析配置页面中获取的数据接收的 URL
    $SERVER_URL = 'YOUR_SERVER_URL';

    # 可选参数,Debug 模式下,是否将数据导入海纳分析
    $DEBUG_WRITE_DATA = True;
    # 可选参数,发送数据的超时时间,单位毫秒
    $REQUEST_TIMEOUT = 100000;
    # 初始化一个 Consumer,用于数据发送
    $consumer = new DebugConsumer($SERVER_URL, $DEBUG_WRITE_DATA, $REQUEST_TIMEOUT);

    # 使用 Consumer 来构造 sdk 对象
    $ha = new HinaSdk($consumer);

    # 以下是触发一个事件测试数据发送
    $account_id = 'ABCDEF123456789';
    $ha->track($account_id, true, 'login');

    # flush方法可以保证条数在不足一个批次的时候,也可以发送出去
    $ha->flush();
?>
作者:涂泽  创建时间:2024-10-12 16:28
最后编辑:涂泽  更新时间:2024-10-17 17:27