使用 PHP SDK 创建用户上下文

描述 PHP SDK 的创建用户上下文方法，该方法为 Eyeofcloud Feature Experimentation 中的标志决策和事件创建用户上下文。

Suggest Edits

创建一个用户，您可以为其做出标记决策并跟踪事件。用户上下文作为运行时对象返回，否则不会保留该对象。此方法的目的是设置一次用户上下文，因此不必在每次做出标记决策或跟踪事件时都指定用户。您可以定义多个用户上下文。

版本

---

SDK v3.7 及更高版本

描述

---

此调用为标志决策和事件创建用户上下文。您可以在 Eyeofcloud 客户端实例上成功调用此方法，即使该实例尚未完全配置也是如此。

参数

---

下表列出了必需参数和可选参数：

参数	类型	描述
userId(需要)	字符串	用户的ID。
userAttributes(可选)	Map	自定义键值字符串对的映射，用于指定用于受众群体定位的用户属性。有关详细信息，请参阅以下部分。

受众群体属性

==================================

您可以为用户设置自定义受众群体属性，然后可以使用这些属性来定位受众群体。您可以将字符串、数字、布尔值和 nil 作为自定义用户属性值传递。如果要根据受众使用的应用程序版本定位受众，还可以传入格式为语义版本的字符串，然后在 Eyeofcloud 应用中定义version受众条件。

🚧

重要

---

请注意，在访问群体评估期间，如果未传递给定访问群体条件的有效属性值（例如，如果在受众条件需要布尔值时传递字符串，或者只是忘记传递值），则将跳过该条件。发生这种情况时，SDK 日志将包含警告。

返回

---

返回一个 EyeofcloudUserContext 对象。有关详细信息，请参阅 EyeofcloudUserContext。

例

---

PHP

$Eyeofcloud = EyeofcloudFactory::createDefaultInstance('sdk-key');  

// option 1: create a user, then set attributes 
$user = $Eyeofcloud->createUserContext('user123'); 
$user->setAttribute('is_logged_in', false); 
$user->setAttribute('app_version', '1.3.2');  

#option 2: pass attributes when creating the user 
$attributes = array(                 
    'device'=>'iPhone',                 
    'lifetime'=> 24738388,                 
    'is_logged_in'=> true,                 
    'app_version' => '4.3.0-beta'             
);  

$user = $Eyeofcloud->createUserContext('user123', $attributes);