{"id":19411496,"url":"https://github.com/volcengine/datarangers-sdk-php","last_synced_at":"2025-04-24T10:33:42.563Z","repository":{"id":44876593,"uuid":"318428117","full_name":"volcengine/datarangers-sdk-php","owner":"volcengine","description":"SDK in php for datarangers products","archived":false,"fork":false,"pushed_at":"2024-12-10T03:37:19.000Z","size":82,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-11T22:09:24.120Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/volcengine.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-04T06:43:44.000Z","updated_at":"2024-12-10T03:21:32.000Z","dependencies_parsed_at":"2024-02-17T16:22:53.149Z","dependency_job_id":"2c5af865-1b5f-4bfa-8a65-87c28e8e3540","html_url":"https://github.com/volcengine/datarangers-sdk-php","commit_stats":{"total_commits":29,"total_committers":5,"mean_commits":5.8,"dds":0.4137931034482759,"last_synced_commit":"463ad92849d65be447e0b3de256fb43eb4bb5d87"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fdatarangers-sdk-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fdatarangers-sdk-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fdatarangers-sdk-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fdatarangers-sdk-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/volcengine","download_url":"https://codeload.github.com/volcengine/datarangers-sdk-php/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250609262,"owners_count":21458455,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T12:21:43.028Z","updated_at":"2025-04-24T10:33:42.270Z","avatar_url":"https://github.com/volcengine.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DataRangers\n\n## 项目背景\ndatarangers-sdk-php是 [DataRangers](https://datarangers.com.cn/) 的用户行为采集服务端SDK。\n\n服务端埋点支持在客户的服务端进行埋点采集和上报，作为客户端埋点的补充或替代，其支持的典型场景包括：\n1. 客户端埋点+服务端埋点组合：该场景下，服务端埋点一般用来弥补客户端埋点覆盖不到的部分数据，是目前最常见的使用场景。\n2. 纯服务端埋点：所有的埋点收集和上报都由服务端完成，需要的客户端数据则由服务端收集和提取后上报到DataRangers。\n\n## 使用方法\n1. 新建一个Laravel项目\n2. 在composer.json中添加如下字段\n\n    ```json\n    {\n    \"require\": {\n            \"datarangers/datarangers\": \"^1.0\"\n        }\n    }\n    ```\n\n3. 执行命令\n    ```shell script\n    composer require datarangers/datarangers\n    ```\n4. 首先加载配置项\n    ```php\n    # 私有化部署场景 logagent模式\n    CollectorConfig::init_datarangers_collector([\n            \"domain\" =\u003e \"http://domain\",\n            \"save\" =\u003e true,\n            \"headers\" =\u003e [\n                \"Content-Type\" =\u003e \"application/json\"\n            ],\n            \"http_timeout\"=\u003e 10000\n        ]);\n   \n   # 私有化部署场景 http 模式\n   CollectorConfig::init_datarangers_collector([\n    \"domain\" =\u003e \"https://xxxx\",\n    \"save\" =\u003e false,\n    \"headers\" =\u003e [\n        \"Content-Type\" =\u003e \"application/json\"\n    ],\n    \"http_timeout\"=\u003e 10000\n   ]);\n   \n    # saas 云上环境\n    CollectorConfig::init_datarangers_collector([\n        \"domain\" =\u003e \"https://xxxx\",\n        \"save\" =\u003e false,\n        \"headers\" =\u003e [\n            \"Content-Type\" =\u003e \"application/json\"\n        ],\n        \"app_keys\" =\u003e [\n            1001 =\u003e getenv(\"APP_KEY\")\n        ],\n        \"openapi\" =\u003e [\n            \"domain\" =\u003e \"https://xxxx\",\n            \"ak\" =\u003e getenv(\"OPENAPI_AK\"),\n            \"sk\" =\u003e getenv(\"OPENAPI_SK\")\n        ],\n        \"http_timeout\"=\u003e 10000\n    ]);\n   \n    ```\n   \n   domain 配置说明：\n   1. 私有化，请联系部署运维人员获取\n   2. saas，根据接入的环境配置不同的地址：\n      1. saas版本国内站：https://mcs.ctobsnssdk.com\n      2. SaaS版国际站: https://mcs.tobsnssdk.com\n   3. SAAS 上如果上报 item 和用户属性，需要设置openapi：\n      1. domain:\n         1. SaaS版国内站: https://analytics.volcengineapi.com\n         2. SaaS版国际站: https://analytics.byteplusapi.com\n      4. ak/sk 请联系客户经理获取\n\n5. 执行代码\n    ```php\n   $rc = new AppEventCollector();\n   $rc-\u003esendEvent(\"uuid16980\", 1001, null, [ProfileMethod::SET, \"php_event\"],\n        [[\"php_name\" =\u003e \"php\", \"php_version\" =\u003e \"5.6\"], [\"php_name\" =\u003e \"php\", \"php_version\" =\u003e \"5.6\"]]);\n    \n   $rc-\u003eprofileSet(\"uuid16980\", 1001,[\"php_name\" =\u003e \"php\", \"php_version\" =\u003e \"5.6\"]);\n   $rc-\u003eprofileSetOnce(\"uuid16980\", 1001,[\"php_name\" =\u003e \"php\", \"php_version\" =\u003e \"5.6\"]);\n   $rc-\u003eprofileIncrement(\"uuid16980\", 1001,[\"count\" =\u003e 6]);\n   $rc-\u003eprofileAppend(\"uuid16980\", 1001,[\"php_arr\" =\u003e [\"index1\",\"index2\"]]);  \n   \n   # set item properties\n   $rc-\u003eitemIdSet(getenv(\"APP_ID\"), \"book\", \"book3\", [\"author\" =\u003e \"吴承恩\", \"name\" =\u003e \"西游记\", \"price\" =\u003e 59.90, \"category\" =\u003e 1]);\n   $rc-\u003eitemIdSet(getenv(\"APP_ID\"), \"book\", \"book4\", [\"author\" =\u003e \"Guanzhong Luo\", \"name\" =\u003e \"SanGuoYanYi\", \"price\" =\u003e 69.90, \"category\" =\u003e 1]);\n\n   # 在事件中上报item\n   $rc-\u003esendEvent(\"test-uuidsdk1\", getenv(\"APP_ID\"), null, \"php_single_event_with_item\",\n        [\"php_name\" =\u003e \"php\", \"php_version\" =\u003e \"5.6\"],\n        [[\"item_name\" =\u003e \"book\", \"item_id\" =\u003e \"book3\"], [\"item_name\" =\u003e \"book\", \"item_id\" =\u003e \"book4\"]]\n   );\n    ```\n   \n## License\nCopyright 2020 Beijing Volcano Engine Technology Co., Ltd.\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. \nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Fdatarangers-sdk-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvolcengine%2Fdatarangers-sdk-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Fdatarangers-sdk-php/lists"}