安装环信 php server sdk

composer.json

@@ -32,7 +32,8 @@
         "topthink/think-queue": "2.*",
         "workerman/gatewayclient": "^3.0",
         "workerman/workerman": "^4.1",
-        "workerman/gateway-worker": "^3.0"
+        "workerman/gateway-worker": "^3.0",
+        "maniac/easemob-php": "^1.0"
     },
     "config": {
         "preferred-install": "dist"

composer.lock

@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "800fa8a593ae9871d0d1fa689423d115",
+    "content-hash": "19d61187e3a1aa557a2efe65f99d590e",
     "packages": [
         {
             "name": "easywechat-composer/easywechat-composer",
@@ -341,6 +341,56 @@
             "time": "2020-10-15T15:21:32+00:00"
         },
         {
+            "name": "maniac/easemob-php",
+            "version": "1.0.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/easemob/im-php-server-sdk.git",
+                "reference": "36b550328c9911957becde2fd62b9379ba45865c"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/easemob/im-php-server-sdk/zipball/36b550328c9911957becde2fd62b9379ba45865c",
+                "reference": "36b550328c9911957becde2fd62b9379ba45865c",
+                "shasum": "",
+                "mirrors": [
+                    {
+                        "url": "https://mirrors.aliyun.com/composer/dists/%package%/%reference%.%type%",
+                        "preferred": true
+                    }
+                ]
+            },
+            "require": {
+                "php": ">=5.3.3"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "src/functions.php"
+                ],
+                "psr-4": {
+                    "tests\\": "tests/",
+                    "Easemob\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "maniac",
+                    "email": "maniac.liu@easemob.com"
+                }
+            ],
+            "description": "PHP Server SDK for IM.",
+            "support": {
+                "issues": "https://github.com/easemob/im-php-server-sdk/issues",
+                "source": "https://github.com/easemob/im-php-server-sdk/tree/1.0.0"
+            },
+            "time": "2022-06-13T07:32:04+00:00"
+        },
+        {
             "name": "markbaker/complex",
             "version": "1.5.0",
             "source": {

vendor/composer/autoload_files.php

@@ -78,4 +78,5 @@ return array(
     '6747f579ad6817f318cc3a7e7a0abb93' => $vendorDir . '/overtrue/wechat/src/Kernel/Helpers.php',
     '1cfd2761b63b0a29ed23657ea394cb2d' => $vendorDir . '/topthink/think-captcha/src/helper.php',
     'cc56288302d9df745d97c934d6a6e5f0' => $vendorDir . '/topthink/think-queue/src/common.php',
+    '0f5bcb416d34db1c9ad4167f1809a53c' => $vendorDir . '/maniac/easemob-php/src/functions.php',
 );

vendor/composer/autoload_psr4.php

@@ -9,6 +9,7 @@ return array(
     'think\\composer\\' => array($vendorDir . '/topthink/think-installer/src'),
     'think\\captcha\\' => array($vendorDir . '/topthink/think-captcha/src'),
     'think\\' => array($vendorDir . '/karsonzhang/fastadmin-addons/src', $baseDir . '/thinkphp/library/think', $vendorDir . '/topthink/think-helper/src', $vendorDir . '/topthink/think-queue/src'),
+    'tests\\' => array($vendorDir . '/maniac/easemob-php/tests'),
     'Workerman\\' => array($vendorDir . '/workerman/workerman'),
     'Symfony\\Polyfill\\Php72\\' => array($vendorDir . '/symfony/polyfill-php72'),
     'Symfony\\Polyfill\\Mbstring\\' => array($vendorDir . '/symfony/polyfill-mbstring'),
@@ -44,5 +45,6 @@ return array(
     'GatewayClient\\' => array($vendorDir . '/workerman/gatewayclient'),
     'EasyWeChat\\' => array($vendorDir . '/overtrue/wechat/src'),
     'EasyWeChatComposer\\' => array($vendorDir . '/easywechat-composer/easywechat-composer/src'),
+    'Easemob\\' => array($vendorDir . '/maniac/easemob-php/src'),
     'Complex\\' => array($vendorDir . '/markbaker/complex/classes/src'),
 );

vendor/composer/autoload_static.php

@@ -79,6 +79,7 @@ class ComposerStaticInit4e0abace8ce63ca5f8dbb141e3081fc9
         '6747f579ad6817f318cc3a7e7a0abb93' => __DIR__ . '/..' . '/overtrue/wechat/src/Kernel/Helpers.php',
         '1cfd2761b63b0a29ed23657ea394cb2d' => __DIR__ . '/..' . '/topthink/think-captcha/src/helper.php',
         'cc56288302d9df745d97c934d6a6e5f0' => __DIR__ . '/..' . '/topthink/think-queue/src/common.php',
+        '0f5bcb416d34db1c9ad4167f1809a53c' => __DIR__ . '/..' . '/maniac/easemob-php/src/functions.php',
     );
 
     public static $prefixLengthsPsr4 = array (
@@ -87,6 +88,7 @@ class ComposerStaticInit4e0abace8ce63ca5f8dbb141e3081fc9
             'think\\composer\\' => 15,
             'think\\captcha\\' => 14,
             'think\\' => 6,
+            'tests\\' => 6,
         ),
         'W' => 
         array (
@@ -146,6 +148,7 @@ class ComposerStaticInit4e0abace8ce63ca5f8dbb141e3081fc9
         array (
             'EasyWeChat\\' => 11,
             'EasyWeChatComposer\\' => 19,
+            'Easemob\\' => 8,
         ),
         'C' => 
         array (
@@ -169,6 +172,10 @@ class ComposerStaticInit4e0abace8ce63ca5f8dbb141e3081fc9
             2 => __DIR__ . '/..' . '/topthink/think-helper/src',
             3 => __DIR__ . '/..' . '/topthink/think-queue/src',
         ),
+        'tests\\' => 
+        array (
+            0 => __DIR__ . '/..' . '/maniac/easemob-php/tests',
+        ),
         'Workerman\\' => 
         array (
             0 => __DIR__ . '/..' . '/workerman/workerman',
@@ -309,6 +316,10 @@ class ComposerStaticInit4e0abace8ce63ca5f8dbb141e3081fc9
         array (
             0 => __DIR__ . '/..' . '/easywechat-composer/easywechat-composer/src',
         ),
+        'Easemob\\' => 
+        array (
+            0 => __DIR__ . '/..' . '/maniac/easemob-php/src',
+        ),
         'Complex\\' => 
         array (
             0 => __DIR__ . '/..' . '/markbaker/complex/classes/src',

vendor/composer/installed.json

@@ -350,6 +350,59 @@
             "install-path": "../karsonzhang/fastadmin-addons"
         },
         {
+            "name": "maniac/easemob-php",
+            "version": "1.0.0",
+            "version_normalized": "1.0.0.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/easemob/im-php-server-sdk.git",
+                "reference": "36b550328c9911957becde2fd62b9379ba45865c"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/easemob/im-php-server-sdk/zipball/36b550328c9911957becde2fd62b9379ba45865c",
+                "reference": "36b550328c9911957becde2fd62b9379ba45865c",
+                "shasum": "",
+                "mirrors": [
+                    {
+                        "url": "https://mirrors.aliyun.com/composer/dists/%package%/%reference%.%type%",
+                        "preferred": true
+                    }
+                ]
+            },
+            "require": {
+                "php": ">=5.3.3"
+            },
+            "time": "2022-06-13T07:32:04+00:00",
+            "type": "library",
+            "installation-source": "dist",
+            "autoload": {
+                "files": [
+                    "src/functions.php"
+                ],
+                "psr-4": {
+                    "tests\\": "tests/",
+                    "Easemob\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "maniac",
+                    "email": "maniac.liu@easemob.com"
+                }
+            ],
+            "description": "PHP Server SDK for IM.",
+            "support": {
+                "issues": "https://github.com/easemob/im-php-server-sdk/issues",
+                "source": "https://github.com/easemob/im-php-server-sdk/tree/1.0.0"
+            },
+            "install-path": "../maniac/easemob-php"
+        },
+        {
             "name": "markbaker/complex",
             "version": "1.5.0",
             "version_normalized": "1.5.0.0",

vendor/composer/installed.php

@@ -5,7 +5,7 @@
         'type' => 'project',
         'install_path' => __DIR__ . '/../../',
         'aliases' => array(),
-        'reference' => '2925805bcb92d4c8fe5a1008262c44cdd8f4a191',
+        'reference' => '0d9b53b783bb4b9a32d9fa096a81614f63a6de5a',
         'name' => 'karsonzhang/fastadmin',
         'dev' => true,
     ),
@@ -52,7 +52,7 @@
             'type' => 'project',
             'install_path' => __DIR__ . '/../../',
             'aliases' => array(),
-            'reference' => '2925805bcb92d4c8fe5a1008262c44cdd8f4a191',
+            'reference' => '0d9b53b783bb4b9a32d9fa096a81614f63a6de5a',
             'dev_requirement' => false,
         ),
         'karsonzhang/fastadmin-addons' => array(
@@ -64,6 +64,15 @@
             'reference' => '44bab4cb1f328d5a1593628a6719eb8263b4c52f',
             'dev_requirement' => false,
         ),
+        'maniac/easemob-php' => array(
+            'pretty_version' => '1.0.0',
+            'version' => '1.0.0.0',
+            'type' => 'library',
+            'install_path' => __DIR__ . '/../maniac/easemob-php',
+            'aliases' => array(),
+            'reference' => '36b550328c9911957becde2fd62b9379ba45865c',
+            'dev_requirement' => false,
+        ),
         'markbaker/complex' => array(
             'pretty_version' => '1.5.0',
             'version' => '1.5.0.0',

vendor/maniac/easemob-php/.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+.phpdoc
+.phpunit.result.cache
+/vendor/
+/docs/
+/doxygen/
+deploy.sh

vendor/maniac/easemob-php/README.md

@@ -0,0 +1,135 @@
+## PHP SDK
+
+### 介绍
+PHP SDK 是对环信 IM [服务端 API](https://docs-im.easemob.com/im/server/ready/intro) 的封装，这样做是为了节省服务器端开发者对接环信 API 的时间，只需要配置自己的 appkey 相关信息即可使用。
+
+### 功能
+PHP SDK 提供了用户、消息、群组、聊天室等资源的操作管理能力。
+
+### 依赖
+- PHP 5.3+
+
+### 安装
+直接使用 [composer](https://www.phpcomposer.com/) 进行安装
+
+```
+composer require maniac/easemob-php
+```
+
+### 目录结构
+- examples 示例文件目录
+- runtime 临时文件、缓存文件目录
+- src 核心文件目录
+- tests 测试文件目录
+
+### 准备
+在使用 PHP SDK 之前，需要准备环信 appkey、Client ID、ClientSecret。
+
+如果你有环信管理后台账号并创建过应用，请先登录环信管理后台，点击 [这里](https://console.easemob.com/user/login)，然后到“应用列表” → 点击“查看”即可获取到 appkey、Client ID、ClientSecret。
+
+如果你没有环信管理后台账号，请先注册账号，点击 [这里](https://console.easemob.com/user/register)，注册成功后请登录，然后点击“添加应用”，添加成功后点击“查看”即可获取到 appkey、Client ID、ClientSecret。
+
+### 使用
+如果使用 Laravel、YII、ThinkPHP 之类的框架，composer 安装的库会自动加载，如果没有使用框架，需要手动引入 `vendor/autoload.php` 文件。
+
+使用所有的类之前，都要先初始化授权对象，然后再初始化其他类时，传入授权对象
+```php
+require 'vendor/autoload.php';
+
+use Easemob\Auth;
+use Easemob\User;
+
+$auth = new Auth("appKey", "Client ID", "ClientSecret");
+$user = new User($auth);
+```
+
+根据业务资源，API 分为：
+
+- Attachment 用于上传下载附件
+- Block 用于限制访问(将用户加入黑名单、群组/聊天室禁言等)
+- Contact 用于管理联系人(添加好友等)
+- Group 用于管理群组
+- Message 用于发送消息
+- User 用于管理用户
+- UserMetadata 用于管理用户属性
+- Push 用于管理用户推送(设置推送免打扰等)
+- Room 用于管理聊天室
+- WhiteList 用于管理白名单
+
+每个业务资源对应一个方法，例如，用户相关的 API，都可以在 User 类中找到。
+
+举个例子，我们要注册一个用户，就可以这样写：
+
+```php
+require 'vendor/autoload.php';
+
+use Easemob\Auth;
+use Easemob\User;
+
+$auth = new Auth("appKey", "Client ID", "ClientSecret");
+$user = new User($auth);
+
+// 注册单个用户
+$data = array(
+    'username' => 'user1',
+    'password' => 'user1',
+    'nickname' => 'user1',
+);
+$user->create($data);
+
+ 
+// 批量注册用户
+$data = array(
+    array(
+        'username' => 'user2',
+        'password' => 'user2',
+        'nickname' => 'user2',
+    ),
+    array(
+        'username' => 'user3',
+        'password' => 'user3',
+        'nickname' => 'user3',
+    ),
+);
+$user->create($data);
+```
+
+### 参考
+- PHP SDK 的 api 文档在 [这里](https://easemob.github.io/im-php-server-sdk/annotated.html)
+- PHP SDK 开源地址在 [这里](https://github.com/easemob/im-php-server-sdk)
+
+### 常见问题
+
+1.关于 PHP 低版本中文乱码问题
+
+在纯 PHP 页面中使用
+
+```php
+header("Content-Type:text/html;charset=utf-8");
+```
+
+在 HTML 和 PHP 混编的页面中使用
+
+```html
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+```
+
+2.关于 SDK 返回的错误码和错误描述
+
+PHP SDK 会直接返回 REST API 的错误码及错误描述，具体请参考 [服务器端 REST API 常见错误码](https://docs-im.easemob.com/im/other/errorcode/restapi)
+
+3.使用代理的情况
+
+在初始化授权对象 Auth 之后，可以设置代理：
+
+```php
+require 'vendor/autoload.php';
+
+use Easemob\Auth;
+use Easemob\Http\Http
+
+$easemob = $config['easemob'];
+$auth = new Auth("appKey", "Client ID", "ClientSecret");
+// 设置代理
+Http::setProxy("ip地址", 8080);
+```

vendor/maniac/easemob-php/autoload.php

@@ -0,0 +1,19 @@
+<?php
+/**
+ * @ignore 自动加载
+ */
+if ( file_exists(dirname(__FILE__).'/vendor/autoload.php') ) {
+    require_once dirname(__FILE__).'/vendor/autoload.php';
+}
+
+function class_loader($className)
+{
+    $file = __DIR__ . DIRECTORY_SEPARATOR . 'src' . DIRECTORY_SEPARATOR . str_replace("Easemob" . DIRECTORY_SEPARATOR, "", str_replace("\\", DIRECTORY_SEPARATOR, $className)) . '.php';
+    if (file_exists($file)) {
+        require_once $file;
+    }
+}
+
+spl_autoload_register('class_loader');
+
+require __DIR__ . DIRECTORY_SEPARATOR . 'src' . DIRECTORY_SEPARATOR . 'functions.php';

vendor/maniac/easemob-php/composer.json

@@ -0,0 +1,23 @@
+{
+    "name": "maniac/easemob-php",
+    "description": "PHP Server SDK for IM.",
+    "license": "MIT",
+    "authors": [
+      {
+          "name": "maniac",
+          "email": "maniac.liu@easemob.com"
+      }
+    ],
+    "require": {
+      "php": ">=5.3.3"
+    },
+    "autoload": {
+      "files": [
+        "src/functions.php"
+      ],
+      "psr-4": {
+          "Easemob\\": "src/", 
+          "tests\\": "tests/"
+      }
+    }
+}

vendor/maniac/easemob-php/examples/attachment.php

@@ -0,0 +1,63 @@
+<?php
+/*
+ * 上传下载附件示例
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\Attachment;
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+// 实例化对象
+$attachment = new Attachment($auth);
+
+echo '<pre>';
+
+
+/* 
+// 上传文件
+$data = $attachment->uploadFile('images/1.png');
+var_dump($data);
+// array(3) {
+//     ["uuid"]=>
+//     string(36) "a4364f90-b0d8-11ec-8cfe-b57d5aca4e63"
+//     ["type"]=>
+//     string(8) "chatfile"
+//     ["share-secret"]=>
+//     string(48) "pDZPmrDYEeyGTyPdhVc_kj_MzWvSzIfi3bg_fgkvpVjvQAo5"
+// }
+$data = $attachment->uploadFile('/usr/share/nginx/html/sdk.com/examples/images/1.png', true);
+var_dump($data);
+// array(3) {
+//     ["uuid"]=>
+//     string(36) "a4615730-b0d8-11ec-92b5-1fe1ed287b6a"
+//     ["type"]=>
+//     string(8) "chatfile"
+//     ["share-secret"]=>
+//     string(48) "pGF-QLDYEeyPS6lef7QYBPQMYwHMCVRt34DkF3KYLMETh4s0"
+// }
+ */
+
+
+/* 
+// 下载文件
+var_dump($attachment->downloadFile('images/11.png', 'a4364f90-b0d8-11ec-8cfe-b57d5aca4e63'));
+// 下载文件
+var_dump($attachment->downloadFile('images/111/22.png', 'a4615730-b0d8-11ec-92b5-1fe1ed287b6a', 'pGF-QLDYEeyPS6lef7QYBPQMYwHMCVRt34DkF3KYLMETh4s0'));
+ */
+
+
+/* 
+// 下载缩略图
+var_dump($attachment->downloadThumb('images/11_thumb.png', 'a4364f90-b0d8-11ec-8cfe-b57d5aca4e63'));
+var_dump($attachment->downloadThumb('images/111/11_thumb.png', 'a4615730-b0d8-11ec-92b5-1fe1ed287b6a', 'pGF-QLDYEeyPS6lef7QYBPQMYwHMCVRt34DkF3KYLMETh4s0'));
+ */

vendor/maniac/easemob-php/examples/auth.php

@@ -0,0 +1,58 @@
+<?php
+/*
+ * 用户示例
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\User;
+use Easemob\Agora\ServiceRtc;
+
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+
+/* 
+// 初始化授权对象，声网 token 初始化
+$agora = $config['agora'];
+$auth = new Auth($agora['app_key'], $agora['app_id'], $agora['app_certificate'], true, $agora['expire_time']);
+$auth->setApiUri('http://a41.easemob.com');
+ */
+
+
+echo '<pre>';
+
+
+/* 
+// 生成 Easemob userToken
+var_dump($auth->getUserToken('user4', 'user4'));
+ */
+
+
+/* 
+// 生成仅含 AgoraChat 权限的 Agora userToken
+var_dump($auth->getUserToken('bb46ab60-5c07-11ec-8cc6-b5d98ea414b4', null));
+ */
+
+
+/* 
+// 生成包含 AgoraChat 权限和 AgoraRTC (JOIN_CHANNEL) 权限的 Agora userToken
+
+// grant rtc privileges
+$serviceRtc = new ServiceRtc('7d72365eb983485397e3e3f9d460bdda', '2882341273');
+$serviceRtc->addPrivilege($serviceRtc::PRIVILEGE_JOIN_CHANNEL, 600);
+
+$configuration = array(
+    $serviceRtc,
+);
+
+var_dump($auth->getUserToken('bb46ab60-5c07-11ec-8cc6-b5d98ea414b4', null, 600, $configuration));
+ */

vendor/maniac/easemob-php/examples/block.php

@@ -0,0 +1,238 @@
+<?php
+/*
+ * 用于限制访问(将用户加入黑名单、群组/聊天室禁言等)
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\User;
+use Easemob\Block;
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+// 实例化对象
+$block = new Block($auth);
+$user = new User($auth);
+
+echo '<pre>';
+
+
+/* 
+// 获取用户黑名单
+var_dump($block->getUsersBlockedFromSendMsgToUser('user3'));
+ */
+
+
+/* 
+// 添加用户黑名单
+var_dump($block->getUsersBlockedFromSendMsgToUser('user1'));
+var_dump($block->blockUserSendMsgToUser('user1', array('user2', 'user3')));
+var_dump($block->getUsersBlockedFromSendMsgToUser('user1'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedFromSendMsgToUser('user1'));
+// 移除用户黑名单
+var_dump($block->unblockUserSendMsgToUser('user1', 'user3'));
+var_dump($block->getUsersBlockedFromSendMsgToUser('user1'));
+ */
+
+
+/* 
+var_dump($user->get('user1'));
+// 用户账号禁用
+var_dump($block->blockUserLogin('user1'));
+var_dump($user->get('user1'));
+// 用户账号解禁
+var_dump($block->unblockUserLogin('user1'));
+var_dump($user->get('user1'));
+ */
+
+
+/* 
+// 设置用户全局禁言
+var_dump($block->blockUserSendMsg('user3'));
+ */
+
+
+/* 
+// 取消用户全局禁言
+var_dump($block->unblockUserSendMsg('user3'));
+ */
+
+
+/* 
+// 查询单个帐号全局禁言
+var_dump($block->getUserBlocked('user3'));
+ */
+
+
+/* 
+// 查询APPKEY的用户禁言
+var_dump($block->getAppBlocked());
+ */
+
+
+// Group
+
+ /* 
+// 查询群组黑名单
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+// 添加单个用户至群组黑名单
+var_dump($block->blockUserJoinGroup('177627064238081', 'user4'));
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+// 批量添加用户至群组黑名单
+var_dump($block->blockUsersJoinGroup('177627064238081', array('user1', 'user3')));
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+// 从群组黑名单移除单个用户
+var_dump($block->unblockUserJoinGroup('177627064238081', 'user4'));
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+ */
+
+
+/* 
+// 批量从群组黑名单移除用户
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+var_dump($block->unblockUsersJoinGroup('177627064238081', array('user1', 'user3')));
+var_dump($block->getUsersBlockedJoinGroup('177627064238081'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedSendMsgToGroup('177627064238081'));
+// 添加群禁言
+var_dump($block->blockUserSendMsgToGroup('177627064238081', array('user4')));
+var_dump($block->getUsersBlockedSendMsgToGroup('177627064238081'));
+var_dump($block->blockUserSendMsgToGroup('177627064238081', array('user5', 'user6')));
+var_dump($block->getUsersBlockedSendMsgToGroup('177627064238081'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedSendMsgToGroup('177627064238081'));
+// 移除群禁言
+var_dump($block->unblockUserSendMsgToGroup('177627064238081', array('user4')));
+var_dump($block->getUsersBlockedSendMsgToGroup('177627064238081'));
+var_dump($block->unblockUserSendMsgToGroup('177627064238081', array('user5', 'user6')));
+var_dump($block->getUsersBlockedSendMsgToGroup('177627064238081'));
+ */
+
+ 
+/* 
+// 获取群禁言列表
+var_dump($block->getUsersBlockedSendMsgToGroup('177627064238081'));
+ */
+
+
+/* 
+// 禁言群组全体成员
+var_dump($block->blockAllUserSendMsgToGroup('177627064238081'));
+ */
+
+
+/* 
+// 解除群组全员禁言
+var_dump($block->unblockAllUserSendMsgToGroup('177627064238081'));
+ */
+
+
+// Room
+
+/*  
+// 查询聊天室黑名单
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+// 添加单个用户至聊天室黑名单
+var_dump($block->blockUserJoinRoom('177630845403137', 'user11'));
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+// 批量添加用户至聊天室黑名单
+var_dump($block->blockUsersJoinRoom('177630845403137', array('user12', 'user13')));
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+// 从聊天室黑名单移除单个用户
+var_dump($block->unblockUserJoinRoom('177630845403137', 'user11'));
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+ */
+
+
+/* 
+// 批量从聊天室黑名单移除用户
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+var_dump($block->unblockUsersJoinRoom('177630845403137', array('user12', 'user13')));
+var_dump($block->getUsersBlockedJoinRoom('177630845403137'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedSendMsgToRoom('177630783537155'));
+// 添加聊天室禁言
+var_dump($block->blockUserSendMsgToRoom('177630783537155', array('user4')));
+var_dump($block->getUsersBlockedSendMsgToRoom('177630783537155'));
+var_dump($block->blockUserSendMsgToRoom('177630783537155', array('user2', 'user3')));
+var_dump($block->getUsersBlockedSendMsgToRoom('177630783537155'));
+ */
+
+
+/* 
+var_dump($block->getUsersBlockedSendMsgToRoom('177630783537155'));
+// 移除聊天室禁言
+var_dump($block->unblockUserSendMsgToRoom('177630783537155', array('user4')));
+var_dump($block->getUsersBlockedSendMsgToRoom('177630783537155'));
+var_dump($block->unblockUserSendMsgToRoom('177630783537155', array('user2', 'user3')));
+var_dump($block->getUsersBlockedSendMsgToRoom('177630783537155'));
+ */
+
+ 
+/* 
+// 获取聊天室禁言列表
+var_dump($block->getUsersBlockedSendMsgToRoom('177630783537155'));
+ */
+
+
+/* 
+// 禁言聊天室全体成员
+var_dump($block->blockAllUserSendMsgToRoom('177630783537155'));
+ */
+
+
+/* 
+// 解除聊天室全员禁言
+var_dump($block->unblockAllUserSendMsgToRoom('177630783537155'));
+ */

vendor/maniac/easemob-php/examples/config.php

@@ -0,0 +1,15 @@
+<?php
+return array(
+    'easemob' => array(
+        'app_key' => 'appKey',
+        'client_id' => 'Client ID',
+        'client_secret' => 'ClientSecret',
+        'api_uri' => '',    // REST 域名
+    ),
+    'agora' => array(
+        'app_key' => 'appKey',
+        'app_id' => 'App ID',
+        'app_certificate' => 'App Certificate',
+        'expire_time' => 900,
+    ),
+);

vendor/maniac/easemob-php/examples/contact.php

@@ -0,0 +1,46 @@
+<?php
+/*
+ * 联系人示例
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\Contact;
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+// 实例化对象
+$contact = new Contact($auth);
+
+echo '<pre>';
+
+
+/* 
+var_dump($contact->get('user3'));
+// 添加联系人
+var_dump($contact->add('user3', 'user4'));
+var_dump($contact->add('user3', 'user5'));
+var_dump($contact->get('user3'));
+ */
+
+
+/* 
+// 获取联系人列表
+var_dump($contact->get('user1'));
+ */
+
+
+/* 
+var_dump($contact->get('user3'));
+// 移除联系人
+var_dump($contact->remove('user3', 'user4'));
+var_dump($contact->get('user3'));
+ */

vendor/maniac/easemob-php/examples/group.php

@@ -0,0 +1,251 @@
+<?php
+/*
+ * 群组管理示例
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\Group;
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+// 实例化对象
+$group = new Group($auth);
+
+echo '<pre>';
+
+
+/* 
+// 创建公开群
+var_dump($group->createPublicGroup('user1', 'public_group', 'public_group_desc', array('user2', 'user3')));
+// 177627064238081
+// 创建私有群
+var_dump($group->createPrivateGroup('user1', 'private_group', 'private_group_desc', array('user2', 'user3')));
+// 177627064238082
+ */
+
+
+/* 
+for ($i = 0; $i < 20; $i++) {
+    var_dump($group->createPublicGroup('user1', 'public_group_' . $i, 'public_group_desc_' . $i, array('user2', 'user3')));
+}
+// string(15) "177627101986819"
+// string(15) "177627103035393"
+// string(15) "177627103035394"
+// string(15) "177627103035396"
+// string(15) "177627103035397"
+// string(15) "177627104083969"
+// string(15) "177627104083970"
+// string(15) "177627104083971"
+// string(15) "177627104083973"
+// string(15) "177627104083974"
+// string(15) "177627105132545"
+// string(15) "177627105132546"
+// string(15) "177627105132547"
+// string(15) "177627105132548"
+// string(15) "177627105132549"
+// string(15) "177627106181121"
+// string(15) "177627106181122"
+// string(15) "177627106181123"
+// string(15) "177627106181124"
+// string(15) "177627106181125"
+// string(15) "177627106181126"
+// string(15) "177627107229697"
+ */
+
+
+/* 
+// 分页获取 App 中所有的群组
+var_dump($group->listGroups(2));
+var_dump($group->listGroups(2, 'ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Z3JvdXA6MTExNTIxMDkxNTE5MzI3NyNkZW1vOjI'));
+ */
+
+
+/*  
+// 获取 App 中所有的群组
+var_dump($group->listAllGroups());
+ */
+
+
+/* 
+// 分页获取单个用户加入的所有群组，第 1 页
+var_dump($group->listGroupsUserJoined('user1', 1, 1));
+// 分页获取单个用户加入的所有群组，第 2 页
+var_dump($group->listGroupsUserJoined('user1', 1, 2));
+ */
+
+
+/* 
+// 获取单个用户加入的所有群组
+var_dump($group->listAllGroupsUserJoined('user1'));
+ */
+
+
+/* 
+// 获取群组详情
+var_dump($group->getGroup('177627064238081'));
+var_dump($group->getGroup('177627064238081,177627064238082'));
+ */
+
+
+/* 
+var_dump($group->getGroup('177627064238081'));
+// 修改群组信息
+$data = array(
+    'group_id' => '177627064238081',
+    'groupname' => 'test group',
+    'description' => 'test description',
+    'maxusers' => 400,
+    'membersonly' => true,
+    'allowinvites' => true,
+    'custom' => 'test custom',
+);
+var_dump($group->updateGroup($data));
+var_dump($group->getGroup('177627064238081'));
+ */
+
+
+/* 
+// 删除群组
+var_dump($group->getGroup('177627107229697'));
+var_dump($group->destroyGroup('177627107229697'));
+var_dump($group->getGroup('177627107229697'));
+ */
+
+
+/* 
+// 获取群组公告
+var_dump($group->getGroupAnnouncement('177627064238081'));
+ */
+
+
+/* 
+var_dump($group->getGroupAnnouncement('177627064238081'));
+// 修改群组公告
+var_dump($group->updateGroupAnnouncement('177627064238081', 'test 公告内容xxx'));
+var_dump($group->getGroupAnnouncement('177627064238081'));
+ */
+
+
+/* 
+// 获取群组共享文件
+var_dump($group->getGroupShareFiles('177627064238081'));
+ */
+
+
+/* 
+// 上传群组共享文件
+var_dump($group->uploadGroupShareFile('177627064238081', './images/1.png'));
+array(6) {
+    ["file_url"]=>
+    string(120) "https://a1.easemob.com/1115210915193277/demo/chatgroups/177627064238081/share_files/59f53fc0-b18e-11ec-9abc-6766e56acf4e"
+    ["group_id"]=>
+    string(15) "177627064238081"
+    ["file_name"]=>
+    string(14) "./images/1.png"
+    ["created"]=>
+    int(1648798549436)
+    ["file_id"]=>
+    string(36) "59f53fc0-b18e-11ec-9abc-6766e56acf4e"
+    ["file_size"]=>
+    int(19161)
+}
+ */
+
+
+/* 
+// 下载群组共享文件
+var_dump($group->downloadGroupShareFile('llxx.png', '177627064238081', '59f53fc0-b18e-11ec-9abc-6766e56acf4e'));
+ */
+
+
+/* 
+var_dump($group->getGroupShareFiles('177627064238081'));
+// 删除群组共享文件
+var_dump($group->deleteGroupShareFile('177627064238081', '59f53fc0-b18e-11ec-9abc-6766e56acf4e'));
+var_dump($group->getGroupShareFiles('177627064238081'));
+ */
+
+
+/* 
+// 分页获取群组成员
+var_dump($group->listGroupMembers('177627064238081', 1));
+var_dump($group->listGroupMembers('177627064238081', 1, 2));
+ */
+
+
+/*  
+// 获取群组全部成员
+var_dump($group->listAllGroupMembers('177627101986819'));
+ */
+
+
+/* 
+// 添加单个群组成员
+var_dump($group->listAllGroupMembers('177627064238081'));
+var_dump($group->addGroupMember('177627064238081', 'user4'));
+var_dump($group->listAllGroupMembers('177627064238081'));
+ */
+
+
+/* 
+// 批量添加群组成员
+var_dump($group->listAllGroupMembers('177627101986819'));
+var_dump($group->addGroupMembers('177627101986819', array('user4', 'user5', 'user6', 'user7')));
+var_dump($group->listAllGroupMembers('177627101986819'));
+ */
+
+
+/* 
+var_dump($group->listAllGroupMembers('177627064238081'));
+// 移除单个群组成员
+var_dump($group->removeGroupMember('177627064238081', 'user7'));
+var_dump($group->listAllGroupMembers('177627064238081'));
+ */
+
+
+/* 
+var_dump($group->listAllGroupMembers('177627064238081'));
+// 批量移除群组成员
+var_dump($group->removeGroupMembers('177627064238081', array('user5', 'user6')));
+var_dump($group->listAllGroupMembers('177627064238081'));
+ */
+
+
+/* 
+// 获取群管理员列表
+var_dump($group->listGroupAdmins('177627064238081'));
+ */
+
+
+/* 
+var_dump($group->listGroupAdmins('177627064238081'));
+// 添加群管理员
+var_dump($group->addGroupAdmin('177627064238081', 'user4'));
+var_dump($group->addGroupAdmin('177627064238081', 'user3'));
+var_dump($group->listGroupAdmins('177627064238081'));
+ */
+
+
+/* 
+var_dump($group->listGroupAdmins('177627064238081'));
+// 移除群管理员
+var_dump($group->removeGroupAdmin('177627064238081', 'user4'));
+var_dump($group->listGroupAdmins('177627064238081'));
+ */
+
+
+/* 
+var_dump($group->getGroup('177627064238081'));
+// 转让群组
+var_dump($group->updateGroupOwner('177627064238081', 'user2'));
+var_dump($group->getGroup('177627064238081'));
+ */

vendor/maniac/easemob-php/examples/message.php

@@ -0,0 +1,281 @@
+<?php
+/*
+ * 发送消息示例
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\Message;
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+// 实例化对象
+$message = new Message($auth);
+
+echo '<pre>';
+
+
+/* 
+// 获取用户离线消息数
+var_dump($message->countMissedMessages('user1'));
+ */
+
+
+/* 
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+// 发送文本消息
+$msg = array(
+    'msg' => 'testmessage',
+    // 扩展，可以没有这个字段，但是如果有，值不能是 “ext:null” 这种形式，否则出错。
+    'ext' => array(
+        'ext1' => 'val1',
+        'ext2' => 'val2',
+    ),
+);
+var_dump($message->text('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992810797698646052"
+//     ["user4"]=>
+//     string(18) "992810797698650148"
+// }
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+ */
+
+
+/* 
+// 发送文本消息（仅发送给在线用户，消息同步给发送发）
+$msg = array(
+    'msg' => 'testmessage',
+    // 扩展，可以没有这个字段，但是如果有，值不能是 “ext:null” 这种形式，否则出错。
+    'ext' => array(
+        'ext1' => 'val1',
+        'ext2' => 'val2',
+    ),
+);
+var_dump($message->text('users', array('user4', 'user5'), $msg, 'user3', true, true));
+ */
+
+
+/* 
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+// 发送图片消息
+$msg = array(
+    'filename' => '1.png',   // 图片名称
+    'uuid' => 'a4364f90-b0d8-11ec-8cfe-b57d5aca4e63',   // 成功上传文件返回的UUID
+    'secret' => 'pDZPmrDYEeyGTyPdhVc_kj_MzWvSzIfi3bg_fgkvpVjvQAo5', // 成功上传文件后返回的secret
+    'size' => array(    // 图片尺寸；height：高度，width：宽
+        'width' => 36,
+        'height' => 36,
+    ),
+);
+var_dump($message->image('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992037625382568852"
+//     ["user4"]=>
+//     string(18) "992037625382572948"
+// }
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+ */
+
+
+/* 
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+// 发送语音消息
+$msg = array(
+    'filename' => '1.aud.silk',   // 语音名称
+    'uuid' => 'a4364f90-b0d8-11ec-8cfe-b57d5aca4e63',   // 成功上传文件返回的UUID
+    'secret' => 'pDZPmrDYEeyGTyPdhVc_kj_MzWvSzIfi3bg_fgkvpVjvQAo5', // 成功上传文件后返回的secret
+    'length' => 10, // 语音时间（单位：秒）
+);
+var_dump($message->audio('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992037819046167688"
+//     ["user4"]=>
+//     string(18) "992037819046171784"
+// }
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+ */
+
+
+/* 
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+// 发送视频消息
+$msg = array(
+    'filename' => 'movie.mp4',  // 视频文件名称
+    'uuid' => 'a4364f90-b0d8-11ec-8cfe-b57d5aca4e63',   // 成功上传文件返回的UUID
+    'secret' => 'pDZPmrDYEeyGTyPdhVc_kj_MzWvSzIfi3bg_fgkvpVjvQAo5', // 成功上传文件后返回的secret
+    'thumb_uuid' => 'a4364f90-b0d8-11ec-8cfe-b57d5aca4e63',  // 成功上传视频缩略图返回的 UUID
+    'thumb_secret' => 'pDZPmrDYEeyGTyPdhVc_kj_MzWvSzIfi3bg_fgkvpVjvQAo5',   // 成功上传视频缩略图后返回的secret
+    'length' => 13, // 视频播放长度
+    'file_length' => 318465,    // 视频文件大小（单位：字节）
+);
+var_dump($message->video('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992038184839807128"
+//     ["user4"]=>
+//     string(18) "992038184839811224"
+// }
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+ */
+
+
+/* 
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+// 发送文件消息
+$msg = array(
+    'filename' => '1.txt',  // 文件名称
+    'uuid' => 'a4364f90-b0d8-11ec-8cfe-b57d5aca4e63',   // 成功上传文件返回的UUID
+    'secret' => 'pDZPmrDYEeyGTyPdhVc_kj_MzWvSzIfi3bg_fgkvpVjvQAo5', // 成功上传文件后返回的secret
+);
+var_dump($message->file('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992038408064860188"
+//     ["user4"]=>
+//     string(18) "992038408064864284"
+// }
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+ */
+
+
+/* 
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+// 发送位置消息
+$msg = array(
+    'lat' => '39.966',  // 纬度
+    'lng' => '116.322',   // 经度
+    'addr' => '中国北京市海淀区中关村', // 地址
+);
+var_dump($message->location('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992038552529272984"
+//     ["user4"]=>
+//     string(18) "992038552529277080"
+// }
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+ */
+
+
+/* 
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+// 发送透传消息
+$msg = array(
+    'event' => 'notification',  // 自定义键值
+);
+var_dump($message->cmd('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992038709236860040"
+//     ["user4"]=>
+//     string(18) "992038709236864136"
+// }
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+ */
+
+
+/* 
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+// 发送自定义消息
+$msg = array(
+    'customEvent' => 'xxx',  // 用户自定义的事件类型，必须是string，值必须满足正则表达式 [a-zA-Z0-9-_/\.]{1,32}，最短1个字符 最长32个字符
+    'customExts' => array(   // 用户自定义的事件属性，类型必须是Map<String,String>，最多可以包含16个元素。customExts 是可选的，不需要可以不传
+        'asd' => '123',
+    ),
+    'ext' => array(
+        'test' => 'test111',
+    ),
+);
+var_dump($message->custom('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992038835590266892"
+//     ["user4"]=>
+//     string(18) "992038835590270988"
+// }
+var_dump($message->countMissedMessages('user4'));
+var_dump($message->countMissedMessages('user5'));
+ */
+
+
+/* 
+// 获取某条离线消息状态
+var_dump($message->isMessageDeliveredToUser('user4', '992810797698650148'));
+var_dump($message->isMessageDeliveredToUser('user5', '992810797698646052'));
+ */
+
+
+/* 
+date_default_timezone_set('PRC');
+// 获取历史消息文件
+var_dump($message->getHistoryAsUri(2022032916));
+ */
+
+
+/* 
+// 下载消息历史文件到本地
+$message->getHistoryAsLocalFile(2022032916, '111.gz');
+ */
+
+
+/* 
+$msg = array(
+    'msg' => 'testmessage',
+    // 扩展，可以没有这个字段，但是如果有，值不能是 “ext:null” 这种形式，否则出错。
+    'ext' => array(
+        'ext1' => 'val1',
+        'ext2' => 'val2',
+    ),
+);
+var_dump($message->text('users', array('user4', 'user5'), $msg, 'user3'));
+// array(2) {
+//     ["user5"]=>
+//     string(18) "992813372330214544"
+//     ["user4"]=>
+//     string(18) "992813372330218640"
+// }
+ */
+
+
+/* 
+// 撤回消息
+$msg = array(
+    'msg_id' => '992813372330218640',
+    'chat_type' => 'chat',
+    'force' => true
+);
+var_dump($message->withdraw($msg));
+ */
+
+
+/* 
+// 服务端单向删除会话
+var_dump($message->deleteSession('user3', '992813372330218640', 'chat'));
+ */

vendor/maniac/easemob-php/examples/push.php

@@ -0,0 +1,55 @@
+<?php
+/*
+ * 推送 API
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\User;
+use Easemob\Push;
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+// 实例化对象
+$user = new User($auth);
+$push = new Push($auth);
+
+echo '<pre>';
+
+
+/* 
+var_dump($user->get('user3'));
+// 设置用户推送昵称
+var_dump($push->updateUserNickname('user3', 'userthree'));
+var_dump($user->get('user3'));
+ */
+
+
+/* 
+// 设置推送消息展示方式
+var_dump($user->get('user3'));
+var_dump($push->setNotificationDisplayStyle('user3', 0));
+var_dump($user->get('user3'));
+var_dump($push->setNotificationDisplayStyle('user3'));
+var_dump($user->get('user3'));
+ */
+
+
+/* 
+// 设置免打扰
+var_dump($user->get('user3'));
+// 开启免打扰，设置免打扰时间
+var_dump($push->openNotificationNoDisturbing('user3', 10, 19));
+var_dump($user->get('user3'));
+// 取消免打扰
+var_dump($push->closeNotificationNoDisturbing('user3'));
+var_dump($user->get('user3'));
+ */

vendor/maniac/easemob-php/examples/room.php

@@ -0,0 +1,217 @@
+<?php
+/*
+ * 聊天室管理示例
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\Room;
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+// 实例化对象
+$room = new Room($auth);
+
+echo '<pre>';
+
+
+/* 
+// 获取 APP 中所有的聊天室（分页）
+var_dump($room->listRooms());
+var_dump($room->listRooms(10, 'ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206MTExNTIxMDkxNTE5MzI3NyNkZW1vOjI'));
+ */
+
+
+/* 
+// 获取 APP 中所有的聊天室
+var_dump($room->listAllRooms());
+ */
+
+
+/*  
+// 获取用户加入的聊天室（分页）
+var_dump($room->listRoomsUserJoined('user1'));
+var_dump($room->listRoomsUserJoined('user1', 10, 2));
+ */
+
+
+/* 
+// 获取用户加入的聊天室
+var_dump($room->listAllRoomsUserJoined('user1'));
+ */
+
+
+/* 
+// 创建聊天室
+var_dump($room->createRoom('测试聊天室1', '测试聊天室描述1', 'user1', array('user2', 'user3')));
+// 177630783537155
+ */
+
+
+/* 
+for ($i = 0; $i < 20; $i++) {
+    var_dump($room->createRoom('测试聊天室' . $i, '测试聊天室描述' . $i, 'user1', array('user2', 'user3')));
+}
+// string(15) "177630845403137"
+// string(15) "177630845403138"
+// string(15) "177630846451713"
+// string(15) "177630846451714"
+// string(15) "177630846451716"
+// string(15) "177630846451717"
+// string(15) "177630846451719"
+// string(15) "177630846451720"
+// string(15) "177630847500289"
+// string(15) "177630847500290"
+// string(15) "177630847500292"
+// string(15) "177630847500293"
+// string(15) "177630847500294"
+// string(15) "177630848548865"
+// string(15) "177630848548866"
+// string(15) "177630848548867"
+// string(15) "177630848548868"
+// string(15) "177630849597441"
+// string(15) "177630849597442"
+// string(15) "177630849597443"
+ */
+
+
+/* 
+// 获取聊天室详情
+var_dump($room->getRoom('177630845403137'));
+var_dump($room->getRoom('177630783537155,177630845403137'));
+ */
+
+
+/* 
+var_dump($room->getRoom('177630783537155'));
+// 修改聊天室信息
+$data = array(
+    'room_id' => '177630783537155',
+    'name' => '测试聊天室1x',
+    'description' => '测试聊天室描述1x',
+    'maxusers' => 500,
+);
+var_dump($room->updateRoom($data));
+var_dump($room->getRoom('177630783537155'));
+ */
+
+
+/* 
+// 删除聊天室
+var_dump($room->getRoom('177630849597443'));
+var_dump($room->destroyRoom('177630849597443'));
+var_dump($room->getRoom('177630849597443'));
+ */
+
+
+/* 
+// 获取聊天室公告
+var_dump($room->getRoomAnnouncement('177630783537155'));
+ */
+
+
+/* 
+var_dump($room->getRoomAnnouncement('177630783537155'));
+// 修改聊天室公告
+var_dump($room->updateRoomAnnouncement('177630783537155', '聊天室测试公告'));
+var_dump($room->getRoomAnnouncement('177630783537155'));
+ */
+
+
+/* 
+// 分页获取聊天室成员
+var_dump($room->listRoomMembers('177630783537155', 1));    // 默认第一页 10 条
+var_dump($room->listRoomMembers('177630783537155', 1, 2)); // 第二页 10 条
+ */
+
+
+/* 
+// 获取聊天室所有成员
+var_dump($room->listRoomMembersAll('177630783537155'));
+ */
+
+
+/* 
+var_dump($room->listRoomMembersAll('177630783537155'));
+// 添加单个聊天室成员
+var_dump($room->addRoomMember('177630783537155', 'user10'));
+var_dump($room->listRoomMembersAll('177630783537155'));
+ */
+
+
+/* 
+var_dump($room->listRoomMembersAll('177630783537155'));
+// 批量添加聊天室成员
+var_dump($room->addRoomMembers('177630783537155', array('user5', 'user6', 'user7')));
+var_dump($room->listRoomMembersAll('177630783537155'));
+ */
+
+
+/* 
+var_dump($room->listRoomMembersAll('177630783537155'));
+// 删除单个聊天室成员
+var_dump($room->removeRoomMember('177630783537155', 'user10'));
+var_dump($room->listRoomMembersAll('177630783537155'));
+ */
+
+
+/* 
+// 批量删除聊天室成员
+var_dump($room->listRoomMembersAll('177630783537155'));
+var_dump($room->removeRoomMembers('177630783537155', array('user11', 'user12', 'user13')));
+var_dump($room->listRoomMembersAll('177630783537155'));
+ */
+
+
+/* 
+// 获取聊天室管理员列表
+var_dump($room->listRoomAdminsAll('174712753815556'));
+ */
+
+
+/* 
+var_dump($room->listRoomAdminsAll('177630783537155'));
+// 添加聊天室管理员
+var_dump($room->promoteRoomAdmin('177630783537155', 'user4'));
+var_dump($room->listRoomAdminsAll('177630783537155'));
+ */
+
+
+/* 
+var_dump($room->listRoomAdminsAll('177630783537155'));
+// 移除聊天室管理员
+var_dump($room->demoteRoomAdmin('177630783537155', 'user4'));
+var_dump($room->listRoomAdminsAll('177630783537155'));
+ */
+
+
+/* 
+// 分页获取聊天室超级管理员列表
+var_dump($room->listRoomSuperAdmins(2));
+var_dump($room->listRoomSuperAdmins(2, 2));
+var_dump($room->listRoomSuperAdmins(2, 3));
+ */
+
+
+/* 
+var_dump($room->listRoomSuperAdminsAll());
+// 添加超级管理员
+var_dump($room->promoteRoomSuperAdmin('user3'));
+var_dump($room->listRoomSuperAdminsAll());
+ */
+
+
+/* 
+// 移除超级管理员
+var_dump($room->listRoomSuperAdmins());
+var_dump($room->demoteRoomSuperAdmin('user3'));
+var_dump($room->listRoomSuperAdmins());
+ */

vendor/maniac/easemob-php/examples/user.php

@@ -0,0 +1,98 @@
+<?php
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\User;
+
+// 初始化授权对象
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+$user = new User($auth);
+
+echo '<pre>';
+
+
+/* 
+// 注册单个用户
+$data = array(
+    'username' => 'user1',
+    'password' => 'user1',
+);
+var_dump($user->create($data));
+ */
+
+
+/* 
+// 批量注册用户
+$data = array();
+for ($i = 2; $i< 21; $i++) {
+    $data[] = array(
+        'username' => 'user' . $i,
+        'password' => 'user' . $i
+    );
+}
+var_dump($user->create($data));
+ */
+
+
+/* 
+// 获取单个用户
+var_dump($user->get('user1'));
+ */
+
+
+/* 
+// 批量获取用户
+$data = $user->listUsers(2);
+var_dump($data);
+$data = $user->listUsers(2, 'ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06dXNlcjoxMTE1MjEwOTE1MTkzMjc3I2RlbW86OTU5MDkzMjc2ODMxNTc0MjMz');
+var_dump($data);
+// 批量获取被封禁的用户
+$data = $user->listUsers(2, '', false);
+var_dump($data);
+ */
+
+
+/* 
+// 删除单个用户
+var_dump($user->delete('user18'));
+ */
+
+
+/* 
+// 批量删除用户
+var_dump($user->batchDelete(2));
+ */
+
+
+/* 
+// 修改用户密码
+var_dump($user->updateUserPassword('user1', 'userOne'));
+ */
+
+
+/* 
+// 获取用户在线状态
+// true: 在线；false: 离线；
+var_dump($user->isUserOnline('user1'));
+ */
+
+
+/* 
+// 批量获取用户在线状态
+// true: 在线；false: 离线；
+var_dump($user->isUsersOnline(array('user1', 'user2')));
+ */
+
+
+/* 
+// 强制下线
+var_dump($user->forceLogoutAllDevices('user1'));
+ */

vendor/maniac/easemob-php/examples/user_metadata.php

@@ -0,0 +1,58 @@
+<?php
+/*
+ * 用户属性示例
+ */
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\UserMetadata;
+
+// 初始化授权对象，环信 token 初始化
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+// 实例化对象
+$metadata = new UserMetadata($auth);
+
+echo '<pre>';
+
+
+/* 
+// 获取用户属性
+var_dump($metadata->getMetadataFromUser('user3'));
+ */
+
+
+/* 
+// 设置用户属性
+var_dump($metadata->setMetadataToUser('user3', array('avatar' => 'http://www.easemob.com/avatar2.png', 'nickname' => 'userthree')));
+var_dump($metadata->setMetadataToUser('user3', array('userasd' => 'sdf', 'userdfg' => 'fgh')));
+var_dump($metadata->setMetadataToUser('user4', array('avatar' => 'http://www.easemob.com/avatar4.png', 'nickname' => 'userfour')));
+var_dump($metadata->setMetadataToUser('user4', array('nickname' => 'userfive', 'age' => 20)));
+ */
+
+
+/* 
+// 批量获取用户属性
+var_dump($metadata->batchGetMetadataFromUser(array('user3', 'user4'), array('avatar', 'nickname', 'age', 'sex', 'asd')));
+ */
+
+
+/* 
+// 获取用户属性总量大小
+var_dump($metadata->getUsage());
+ */
+
+ 
+/* 
+// 删除用户属性
+var_dump($metadata->getMetadataFromUser('user3'));
+var_dump($metadata->deleteMetadataFromUser('user3'));
+var_dump($metadata->getMetadataFromUser('user3'));
+ */

vendor/maniac/easemob-php/examples/whiteList.php

@@ -0,0 +1,85 @@
+<?php
+require_once __DIR__ . '/../autoload.php';
+$config = require_once 'config.php';
+
+use Easemob\Auth;
+use Easemob\WhiteList;
+
+// 初始化授权对象
+$easemob = $config['easemob'];
+$auth = new Auth($easemob['app_key'], $easemob['client_id'], $easemob['client_secret']);
+
+// 设置 REST 域名，沙箱环境使用，不是沙箱环境会自动获取
+if (isset($easemob['api_uri']) && $easemob['api_uri']) {
+    $auth->setApiUri($easemob['api_uri']);
+}
+
+$whiteList = new WhiteList($auth);
+
+echo '<pre>';
+
+
+/* 
+// 查询群组白名单
+var_dump($whiteList->getGroupWhiteList('177627101986819'));
+ */
+
+
+/* 
+var_dump($whiteList->getGroupWhiteList('177627101986819'));
+// 添加单个用户至群组白名单
+var_dump($whiteList->addUserToGroupWhiteList('177627101986819', 'user3'));
+var_dump($whiteList->getGroupWhiteList('177627101986819'));
+ */
+
+
+/* 
+var_dump($whiteList->getGroupWhiteList('177627101986819'));
+// 批量添加用户至群组白名单
+var_dump($whiteList->addUsersToGroupWhiteList('177627101986819', array('user4', 'user5')));
+var_dump($whiteList->getGroupWhiteList('177627101986819'));
+ */
+
+
+/* 
+var_dump($whiteList->getGroupWhiteList('177627101986819'));
+// 将用户移除群组白名单
+var_dump($whiteList->removeUsersFromGroupWhiteList('177627101986819', 'user3'));
+var_dump($whiteList->getGroupWhiteList('177627101986819'));
+// 将用户移除群组白名单
+var_dump($whiteList->removeUsersFromGroupWhiteList('177627101986819', 'user4,user5'));
+var_dump($whiteList->getGroupWhiteList('177627101986819'));
+ */
+
+
+/* 
+// 查询聊天室白名单
+var_dump($whiteList->getRoomWhiteList('177630783537155'));
+ */
+
+
+/* 
+var_dump($whiteList->getRoomWhiteList('177630783537155'));
+// 添加单个用户至聊天室白名单
+var_dump($whiteList->addUserToRoomWhiteList('177630783537155', 'user2'));
+var_dump($whiteList->getRoomWhiteList('177630783537155'));
+ */
+
+
+/* 
+var_dump($whiteList->getRoomWhiteList('177630783537155'));
+// 批量添加用户至聊天室白名单
+var_dump($whiteList->addUsersToRoomWhiteList('177630783537155', array('user3', 'user4')));
+var_dump($whiteList->getRoomWhiteList('177630783537155'));
+ */
+
+
+/* 
+var_dump($whiteList->getRoomWhiteList('177630783537155'));
+// 将用户移除聊天室白名单
+var_dump($whiteList->removeUsersFromRoomWhiteList('177630783537155', 'user4'));
+var_dump($whiteList->getRoomWhiteList('177630783537155'));
+// 将用户移除聊天室白名单
+var_dump($whiteList->removeUsersFromRoomWhiteList('177630783537155', 'user2,user3'));
+var_dump($whiteList->getRoomWhiteList('177630783537155'));
+ */

vendor/maniac/easemob-php/phpunit.xml

@@ -0,0 +1,12 @@
+<phpunit bootstrap="./tests/bootstrap.php">
+  <testsuites>
+    <testsuite name="money">
+      <directory>tests</directory>
+    </testsuite>
+  </testsuites>
+  <logging>
+    <junit outputFile="tests/logs/junit.xml"/>
+    <testdoxHtml outputFile="tests/logs/testdox.html"/>
+    <testdoxXml outputFile="tests/logs/testdox.xml"/>
+  </logging>
+</phpunit>

vendor/maniac/easemob-php/src/Agora/AccessToken2.php

@@ -0,0 +1,102 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ * @final
+ */
+final class AccessToken2
+{
+    const VERSION = "007";
+    const VERSION_LENGTH = 3;
+    public $appCert;
+    public $appId;
+    public $expire;
+    public $issueTs;
+    public $salt;
+    public $services = [];
+
+    public function __construct($appId = "", $appCert = "", $expire = 900)
+    {
+        $this->appId = $appId;
+        $this->appCert = $appCert;
+        $this->expire = $expire;
+        $this->issueTs = time();
+        $this->salt = rand(1, 99999999);
+    }
+
+    public function addService($service)
+    {
+        $this->services[$service->getServiceType()] = $service;
+    }
+
+    public function build()
+    {
+        if (!self::isUUid($this->appId) || !self::isUUid($this->appCert)) {
+            return "";
+        }
+
+        $signing = $this->getSign();
+        $data = Util::packString($this->appId) . Util::packUint32($this->issueTs) . Util::packUint32($this->expire)
+            . Util::packUint32($this->salt) . Util::packUint16(count($this->services));
+
+        foreach ($this->services as $key => $service) {
+            $data .= $service->pack();
+        }
+
+        $signature = hash_hmac("sha256", $data, $signing, true);
+
+        return self::getVersion() . base64_encode(zlib_encode(Util::packString($signature) . $data, ZLIB_ENCODING_DEFLATE));
+    }
+
+    public function getSign()
+    {
+        $hh = hash_hmac("sha256", $this->appCert, Util::packUint32($this->issueTs), true);
+        return hash_hmac("sha256", $hh, Util::packUint32($this->salt), true);
+    }
+
+    public static function getVersion()
+    {
+        return self::VERSION;
+    }
+
+    public static function isUUid($str)
+    {
+        if (strlen($str) != 32) {
+            return false;
+        }
+        return ctype_xdigit($str);
+    }
+
+    public function parse($token)
+    {
+        if (substr($token, 0, self::VERSION_LENGTH) != self::getVersion()) {
+            return false;
+        }
+
+        $data = zlib_decode(base64_decode(substr($token, self::VERSION_LENGTH)));
+        $signature = Util::unpackString($data);
+        $this->appId = Util::unpackString($data);
+        $this->issueTs = Util::unpackUint32($data);
+        $this->expire = Util::unpackUint32($data);
+        $this->salt = Util::unpackUint32($data);
+        $serviceNum = Util::unpackUint16($data);
+
+        $servicesObj = [
+            ServiceRtc::SERVICE_TYPE => new ServiceRtc(),
+            ServiceRtm::SERVICE_TYPE => new ServiceRtm(),
+            ServiceStreaming::SERVICE_TYPE => new ServiceStreaming(),
+            ServiceChat::SERVICE_TYPE => new ServiceChat()
+        ];
+        for ($i = 0; $i < $serviceNum; $i++) {
+            $serviceTye = Util::unpackUint16($data);
+            $service = $servicesObj[$serviceTye];
+            if ($service == null) {
+                return false;
+            }
+            $service->unpack($data);
+            $this->services[$serviceTye] = $service;
+        }
+        return true;
+    }
+}

vendor/maniac/easemob-php/src/Agora/ChatTokenBuilder2.php

@@ -0,0 +1,53 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ */
+class ChatTokenBuilder2
+{
+    /**
+     * Build the CHAT token.
+     *
+     * @param $appId :          The App ID issued to you by Agora. Apply for a new App ID from
+     *                          Agora Dashboard if it is missing from your kit. See Get an App ID.
+     * @param $appCertificate : Certificate of the application that you registered in
+     *                          the Agora Dashboard. See Get an App Certificate.
+     * @param $userId :         The user's unique id.
+     * @param $expire :         represented by the number of seconds elapsed since now. If, for example, you want to access the
+     *                          Agora Service within 10 minutes after the token is generated, set expireTimestamp as 600(seconds).
+     * @return The CHAT token.
+     */
+    public static function buildUserToken($appId, $appCertificate, $userId, $expire)
+    {
+        $accessToken = new AccessToken2($appId, $appCertificate, $expire);
+        $serviceChat = new ServiceChat($userId);
+
+        $serviceChat->addPrivilege($serviceChat::PRIVILEGE_USER, $expire);
+        $accessToken->addService($serviceChat);
+
+        return $accessToken->build();
+    }
+
+    /**
+     * Build the CHAT token.
+     *
+     * @param $appId :          The App ID issued to you by Agora. Apply for a new App ID from
+     *                          Agora Dashboard if it is missing from your kit. See Get an App ID.
+     * @param $appCertificate : Certificate of the application that you registered in
+     *                          the Agora Dashboard. See Get an App Certificate.
+     * @param $expire :         represented by the number of seconds elapsed since now. If, for example, you want to access the
+     *                          Agora Service within 10 minutes after the token is generated, set expireTimestamp as 600(seconds).
+     * @return The CHAT token.
+     */
+    public static function buildAppToken($appId, $appCertificate, $expire)
+    {
+        $accessToken = new AccessToken2($appId, $appCertificate, $expire);
+        $serviceChat = new ServiceChat();
+
+        $serviceChat->addPrivilege($serviceChat::PRIVILEGE_APP, $expire);
+        $accessToken->addService($serviceChat);
+
+        return $accessToken->build();
+    }
+}

vendor/maniac/easemob-php/src/Agora/Service.php

@@ -0,0 +1,36 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ */
+class Service
+{
+    public $type;
+    public $privileges;
+
+    public function __construct($serviceType)
+    {
+        $this->type = $serviceType;
+    }
+
+    public function addPrivilege($privilege, $expire)
+    {
+        $this->privileges[$privilege] = $expire;
+    }
+
+    public function getServiceType()
+    {
+        return $this->type;
+    }
+
+    public function pack()
+    {
+        return Util::packUint16($this->type) . Util::packMapUint32($this->privileges);
+    }
+
+    public function unpack(&$data)
+    {
+        $this->privileges = Util::unpackMapUint32($data);
+    }
+}

vendor/maniac/easemob-php/src/Agora/ServiceChat.php

@@ -0,0 +1,30 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ */
+class ServiceChat extends Service
+{
+    const SERVICE_TYPE = 5;
+    const PRIVILEGE_USER = 1;
+    const PRIVILEGE_APP = 2;
+    public $userId;
+
+    public function __construct($userId = "")
+    {
+        parent::__construct(self::SERVICE_TYPE);
+        $this->userId = $userId;
+    }
+
+    public function pack()
+    {
+        return parent::pack() . Util::packString($this->userId);
+    }
+
+    public function unpack(&$data)
+    {
+        parent::unpack($data);
+        $this->userId = Util::unpackString($data);
+    }
+}

vendor/maniac/easemob-php/src/Agora/ServiceFpa.php

@@ -0,0 +1,26 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ */
+class ServiceFpa extends Service
+{
+    const SERVICE_TYPE = 4;
+    const PRIVILEGE_LOGIN = 1;
+
+    public function __construct()
+    {
+        parent::__construct(self::SERVICE_TYPE);
+    }
+
+    public function pack()
+    {
+        return parent::pack();
+    }
+
+    public function unpack(&$data)
+    {
+        parent::unpack($data);
+    }
+}

vendor/maniac/easemob-php/src/Agora/ServiceRtc.php

@@ -0,0 +1,35 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ */
+class ServiceRtc extends Service
+{
+    const SERVICE_TYPE = 1;
+    const PRIVILEGE_JOIN_CHANNEL = 1;
+    const PRIVILEGE_PUBLISH_AUDIO_STREAM = 2;
+    const PRIVILEGE_PUBLISH_VIDEO_STREAM = 3;
+    const PRIVILEGE_PUBLISH_DATA_STREAM = 4;
+    public $channelName;
+    public $uid;
+
+    public function __construct($channelName = "", $uid = "")
+    {
+        parent::__construct(self::SERVICE_TYPE);
+        $this->channelName = $channelName;
+        $this->uid = $uid;
+    }
+
+    public function pack()
+    {
+        return parent::pack() . Util::packString($this->channelName) . Util::packString($this->uid);
+    }
+
+    public function unpack(&$data)
+    {
+        parent::unpack($data);
+        $this->channelName = Util::unpackString($data);
+        $this->uid = Util::unpackString($data);
+    }
+}

vendor/maniac/easemob-php/src/Agora/ServiceRtm.php

@@ -0,0 +1,29 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ */
+class ServiceRtm extends Service
+{
+    const SERVICE_TYPE = 2;
+    const PRIVILEGE_LOGIN = 1;
+    public $userId;
+
+    public function __construct($userId = "")
+    {
+        parent::__construct(self::SERVICE_TYPE);
+        $this->userId = $userId;
+    }
+
+    public function pack()
+    {
+        return parent::pack() . Util::packString($this->userId);
+    }
+
+    public function unpack(&$data)
+    {
+        parent::unpack($data);
+        $this->userId = Util::unpackString($data);
+    }
+}

vendor/maniac/easemob-php/src/Agora/ServiceStreaming.php

@@ -0,0 +1,33 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ */
+class ServiceStreaming extends Service
+{
+    const SERVICE_TYPE = 3;
+    const PRIVILEGE_PUBLISH_MIX_STREAM = 1;
+    const PRIVILEGE_PUBLISH_RAW_STREAM = 2;
+    public $channelName;
+    public $uid;
+
+    public function __construct($channelName = "", $uid = "")
+    {
+        parent::__construct(self::SERVICE_TYPE);
+        $this->channelName = $channelName;
+        $this->uid = $uid;
+    }
+
+    public function pack()
+    {
+        return parent::pack() . Util::packString($this->channelName) . Util::packString($this->uid);
+    }
+
+    public function unpack(&$data)
+    {
+        parent::unpack($data);
+        $this->channelName = Util::unpackString($data);
+        $this->uid = Util::unpackString($data);
+    }
+}

vendor/maniac/easemob-php/src/Agora/Util.php

@@ -0,0 +1,77 @@
+<?php
+namespace Easemob\Agora;
+
+/**
+ * @ignore
+ * @final
+ */
+final class Util
+{
+    public static function assertEqual($expected, $actual)
+    {
+        $debug = debug_backtrace();
+        $info = "\n- File:" . basename($debug[1]["file"]) . ", Func:" . $debug[1]["function"] . ", Line:" . $debug[1]["line"];
+        if ($expected != $actual) {
+            echo $info . "\n  Assert failed" . "\n    Expected :" . $expected . "\n    Actual   :" . $actual;
+        } else {
+            echo $info . "\n  Assert ok";
+        }
+    }
+
+    public static function packUint16($x)
+    {
+        return pack("v", $x);
+    }
+
+    public static function unpackUint16(&$data)
+    {
+        $up = unpack("v", substr($data, 0, 2));
+        $data = substr($data, 2);
+        return $up[1];
+    }
+
+    public static function packUint32($x)
+    {
+        return pack("V", $x);
+    }
+
+    public static function unpackUint32(&$data)
+    {
+        $up = unpack("V", substr($data, 0, 4));
+        $data = substr($data, 4);
+        return $up[1];
+    }
+
+    public static function packString($str)
+    {
+        return self::packUint16(strlen($str)) . $str;
+    }
+
+    public static function unpackString(&$data)
+    {
+        $len = self::unpackUint16($data);
+        $up = unpack("C*", substr($data, 0, $len));
+        $data = substr($data, $len);
+        return implode(array_map("chr", $up));
+    }
+
+    public static function packMapUint32($arr)
+    {
+        ksort($arr);
+        $kv = "";
+        foreach ($arr as $key => $val) {
+            $kv .= self::packUint16($key) . self::packUint32($val);
+        }
+        return self::packUint16(count($arr)) . $kv;
+    }
+
+    public static function unpackMapUint32(&$data)
+    {
+        $len = self::unpackUint16($data);
+        $arr = [];
+        for ($i = 0; $i < $len; $i++) {
+            $arr[self::unpackUint16($data)] = self::unpackUint32($data);
+        }
+        return $arr;
+    }
+}

vendor/maniac/easemob-php/src/Attachment.php

@@ -0,0 +1,176 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * Attachment 用来上传下载附件
+ * 
+ * \~english
+ * The `Attachment` is used to upload and download attachments
+ */
+final class Attachment
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */    
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 文件上传
+     * 
+     * \details 
+     * - 上传文件的大小不能超过 10 M，超过会上传失败。
+     * - 在上传文件的时候可以选择是否限制访问权限，如果选择限制的话，会在上传请求完成后返回一个 secret，只有知道这个 secret，并且是 app 的注册用户，才能够下载文件。如果选择不限制的话，则只要是 app 的注册用户就能够下载。
+     * - 如选择加 secret 限制的话，消息回调（包含发送前回调和发送后回调）、历史消息这些功能中涉及下载文件时，都需要在下载 url 中拼接 secret，才能正常下载文件；
+     * - 拼接规则如下：url?share-secret=secret
+     * 
+     * @param  string  $fileName       上传的附件
+     * @param  boolean $restrictAccess 控制文件是否可以被任何人获取，这个值为 true，返回结果中会添加一个 share-secret 值。再次访问文件需要用到这个值。默认值：false
+     * @return array                   上传文件信息或者错误
+     * 
+     * \~english
+     * \brief
+     * File upload
+     * 
+     * \details
+     * - The size of the uploaded file cannot exceed 10m. If it exceeds 10m, the upload will fail.
+     * - When uploading files, you can choose whether to restrict access rights. If you choose to restrict, a secret will be returned after the upload request is completed. Only those who know the secret and are registered users of the app can download files. If you choose not to limit, you can download as long as you are a registered user of the app.
+     * - If you choose to add the secret limit, the message callback (including the callback before sending and the callback after sending) and the historical message, which involve downloading files, need to splice the secret in the download URL to download files normally;
+     * - The splicing rules are as follows: url?share-secret=secret
+     * 
+     * @param  string  $fileName       Uploaded attachments
+     * @param  boolean $restrictAccess Controls whether the file can be obtained by anyone. This value is true. A share secret value will be added to the returned result. This value is required to access the file again. Default: false
+     * @return array                   Upload file information or error
+     */
+    public function uploadFile($fileName, $restrictAccess = false)
+    {
+        if (!trim($fileName)) {
+            \Easemob\exception('Please pass in the attachment name');
+        }
+        
+        $file = fopen($fileName, 'rb');
+        if ($file === false) {
+            \Easemob\exception('The attachment cannot be read');
+        }
+
+        $restrictAccess = (bool)$restrictAccess;
+        $headers = $this->auth->headers();
+        if ($restrictAccess) {
+            $headers['restrict-access'] = $restrictAccess;
+        }
+        
+        $stat = fstat($file);
+        $size = $stat['size'];
+        $data = fread($file, $size);
+        fclose($file);
+        $mimeType = mime_content_type($fileName) ? mime_content_type($fileName) : null;
+        $uri = $this->auth->getBaseUri() . '/chatfiles';
+        $resp = Http::multipartPost($uri, $fileName, $data, $mimeType, $headers);
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['entities'][0];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 下载附件
+     * 
+     * \details
+     * 这里需要注意的就是，如果上传文件时候选择了文件不共享，需要在请求头中带上上面返回的 share-secret 和当前登录用户的 token 才能够下载。
+     * 
+     * @param  string  $fileName    下载的文件名
+     * @param  string  $uuid        文件唯一 ID，文件上传成功后会返回
+     * @param  string  $shareSecret share-secret，文件上传成功后会返回
+     * @return int|array            下载文件的大小或者错误
+     * 
+     * \~english
+     * \brief
+     * Download attachments
+     * 
+     * \details
+     * It should be noted here that if you choose not to share the file when uploading the file, you need to bring the share secret returned above and the token of the currently logged in user in the request header to download it.
+     * 
+     * @param  string  $fileName    Downloaded file name
+     * @param  string  $uuid        Unique ID of the file, which will be returned after the file is uploaded successfully
+     * @param  string  $shareSecret share-secret，it will return after the file is uploaded successfully
+     * @return int|array            Download file size or error
+     */
+    public function downloadFile($fileName, $uuid, $shareSecret = '')
+    {
+        return $this->download($fileName, $uuid, $shareSecret);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 下载缩略图
+     * 
+     * \details
+     * 在服务器端支持自动的创建图片的缩略图。可以先下载缩略图，当用户有需求的时候，再下载大图。 这里和下载大图唯一不同的就是 header 中多了一个“thumbnail: true”，当服务器看到过来的请求的 header 中包括这个的时候，就会返回缩略图，否则返回原始大图。
+     * 
+     * @param  string $fileName    下载缩略图的文件名
+     * @param  string $uuid        文件唯一 ID，文件上传成功后会返回
+     * @param  string $shareSecret share-secret，文件上传成功后会返回
+     * @return int|array           下载缩略图的大小或者错误
+     * 
+     * \~english
+     * \brief
+     * Download thumbnails
+     * 
+     * \details
+     * The server side supports the automatic creation of thumbnails of pictures. You can download thumbnails first, and then download large images when users need them. The only difference between this and downloading the big picture is that there is an "thumbnail: true" in the header. When the server sees that this is included in the header of the request, it will return the thumbnail, otherwise it will return the original big picture.
+     * 
+     * @param  string $fileName    Download thumbnail file name
+     * @param  string $uuid        Unique ID of the file, which will be returned after the file is uploaded successfully
+     * @param  string $shareSecret share-secret，it will return after the file is uploaded successfully
+     * @return int|array           Download file size or error
+     */
+    public function downloadThumb($fileName, $uuid, $shareSecret = '')
+    {
+        return $this->download($fileName, $uuid, $shareSecret, true);
+    }
+
+    /**
+     * @ignore 下载附件
+     * @param  string  $fileName    下载的文件名
+     * @param  string  $uuid        文件唯一 ID，文件上传成功后会返回
+     * @param  string  $shareSecret share-secret，文件上传成功后会返回
+     * @param  boolean $thumb       下载缩略图标识
+     * @return int|array            下载文件的大小或者错误
+     */
+    private function download($fileName, $uuid, $shareSecret = '', $thumb = false)
+    {
+        $uri = $this->auth->getBaseUri() . '/chatfiles/' . $uuid;
+        $headers = $this->auth->headers();
+        if ($shareSecret) {
+            $headers['share-secret'] = $shareSecret;
+        }
+        if ($thumb) {
+            $headers['thumbnail'] = true;
+        }
+        $resp = Http::get($uri, $headers);
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $dir = dirname($fileName);
+        if (!file_exists($dir)) {
+            mkdir($dir, 0755, true);
+        }
+        return file_put_contents($fileName, $resp->body);
+    }
+}

vendor/maniac/easemob-php/src/Auth.php

@@ -0,0 +1,429 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+use Easemob\Cache\Cache;
+use Easemob\Agora\ChatTokenBuilder2;
+use Easemob\Agora\AccessToken2;
+
+/**
+ * 授权类
+ * @final
+ */
+final class Auth
+{
+    private static $DNS_URL = 'https://rs.easemob.com';
+
+    /**
+     * @ignore
+     * @var string $apiUri rest 域名
+     */
+    private $apiUri;
+
+    /**
+     * @ignore
+     * @var string $orgName 企业唯一标识 org_name
+     */
+    private $orgName;
+
+    /**
+     * @ignore
+     * @var string $appName 企业下 APP 唯一标识 app_name
+     */
+    private $appName;
+
+    /**
+     * @ignore
+     * @var string $appKey APP 的唯一标识，规则是 ${org_name}#${app_name}
+     */
+    private $appKey;
+
+    /**
+     * @ignore
+     * @var string $clientId App 的 client_id
+     */
+    private $clientId;
+
+    /**
+     * @ignore
+     * @var string $clientSecret App 的 client_secret
+     */
+    private $clientSecret;
+
+    /**
+     * @ignore
+     * @var string $easemobToken 环信 token
+     */
+    private $easemobToken;
+
+    /**
+     * @ignore
+     * @var boolean $isAgora 是否以声网 token 初始化标识
+     */
+    private $isAgora;
+
+    /**
+     * @ignore
+     * @var string $appID 声网 App ID
+     */
+    private $appID;
+
+    /**
+     * @ignore
+     * @var string $appCertificate 声网 App 证书
+     */
+    private $appCertificate;
+
+    /**
+     * @ignore
+     * @var int $expireTimeInSeconds 声网 token 有效期，单位（秒）
+     */
+    private $expireTimeInSeconds;
+
+    /**
+     * @ignore
+     * @var string $uuid 环信用户 uuid
+     */
+    private $uuid;
+
+    /**
+     * @ignore
+     * @var string $agoraToken2easemobToken 声网 token 置换的环信 token
+     */
+    private $agoraToken2easemobToken;
+
+    /**
+     * \~chinese
+     * \brief 构造方法
+     * 
+     * @param string  $appKey                       APP 的唯一标识，规则是 ${org_name}#${app_name}
+     * @param string  $clientIdOrAppID              环信 App 的 client_id 或者声网 App ID，由 boolean $isAgora 决定
+     * @param string  $clientSecretOrAppCertificate 环信 App 的 client_secret 或者 声网 App 证书，由 boolean $isAgora 决定
+     * @param int     $expireTimeInSeconds          token 有效期，单位（秒）
+     * @param mixed   $proxy                        代理信息
+     * @param boolean $isAgora                      是否使用声网 token 初始化
+     * @param string  $uuid                         环信用户 uuid
+     * 
+     * \~english
+     * \brief 构造方法
+     * 
+     * @param string  $appKey                       The unique identification of app. The rule is ${org_name}#${app_name}
+     * @param string  $clientIdOrAppID              easemob client_id or Agora App ID，Determined by $isagora
+     * @param string  $clientSecretOrAppCertificate easemob client_secret or Agora AppCertificate，Determined by $isagora
+     * @param int     $expireTimeInSeconds          Token validity, in seconds
+     * @param mixed   $proxy                        Agent information
+     * @param boolean $isAgora                      Whether to use Agora token initialization
+     * @param string  $uuid                         easemob username
+     */
+    public function __construct(
+        $appKey,
+        $clientIdOrAppID,
+        $clientSecretOrAppCertificate,
+        $expireTimeInSeconds = 2592000,
+        $isAgora = false,
+        $uuid = ''
+        )
+    {
+        if (strpos($appKey, '#') === false) {
+            throw new \Exception('appKey 数据结构有误');
+        }
+
+        $temp = explode('#', $appKey);
+        $this->orgName = $temp[0];
+        $this->appName = $temp[1];
+        $this->appKey = $appKey;
+        $this->expireTimeInSeconds = (int)$expireTimeInSeconds > 0 ? (int)$expireTimeInSeconds : 2592000;
+        $this->isAgora = $isAgora;
+        $this->uuid = $uuid;
+
+        // $this->getApiUri();
+        
+        if ($isAgora) {
+            $this->appID = $clientIdOrAppID;
+            $this->appCertificate = $clientSecretOrAppCertificate;
+            // $this->getAgoraToken2easemobToken();
+        } else {
+            $this->clientId = $clientIdOrAppID;
+            $this->clientSecret = $clientSecretOrAppCertificate;
+            // $this->getEasemobToken();
+        }
+    }
+
+    /// @cond
+    /**
+     * @ignore getter & setter
+     */
+    public function getBaseUri()
+    {
+        return $this->getApiUri() . '/' . $this->orgName . '/' . $this->appName;
+    }
+
+    /**
+     * @ignore getter & setter
+     */
+    public function getOrgName()
+    {
+        return $this->orgName;
+    }
+
+    /**
+     * @ignore getter & setter
+     */
+    public function getAppName()
+    {
+        return $this->appName;
+    }
+
+    /**
+     * @ignore getter & setter
+     */
+    public function getAppKey()
+    {
+        return $this->appKey;
+    }
+
+    /**
+     * @ignore getter & setter
+     */
+    public function getClientId()
+    {
+        return $this->clientId;
+    }
+
+    /**
+     * @ignore getter & setter
+     */
+    public function getClientSecret()
+    {
+        return $this->clientSecret;
+    }
+
+    /**
+     * @ignore getter & setter
+     */
+    public function getApiUri()
+    {
+        return $this->apiUri ? $this->apiUri : $this->getRemoteApiUri();
+    }
+
+    /**
+     * @ignore getter & setter
+     */
+    public function setApiUri($apiUri)
+    {
+        $this->apiUri = $apiUri;
+    }
+
+    /**
+     * @ignore 获取环信 token
+     * @return string 环信 token
+     * @example
+     * <pre>
+     * $auth->getEasemobToken();
+     * </pre>
+     */
+    public function getEasemobToken()
+    {
+        $this->easemobToken = Cache::get($this->appKey . '_easemob_token');
+        return $this->easemobToken ? $this->easemobToken : $this->getEasemobAccessToken();
+    }
+
+    /**
+     * @ignore 获取声网 token
+     * @param  string 环信用户 uuid
+     * @param  int    token 有效期
+     * @return string 声网 token
+     * @example
+     * <pre>
+     * $auth->getAgoraToken();
+     * </pre>
+     */
+    public function getAgoraToken()
+    {
+        if ($this->isAgora) {
+            $this->agoraToken = Cache::get($this->appKey . '_agora_token');
+            if (!$this->agoraToken) {
+                if ($this->uuid) {
+                    $this->agoraToken = ChatTokenBuilder2::buildUserToken($this->appID, $this->appCertificate, $this->uuid, $this->expireTimeInSeconds);
+                } else {
+                    $this->agoraToken = ChatTokenBuilder2::buildAppToken($this->appID, $this->appCertificate, $this->expireTimeInSeconds);
+                }
+                Cache::set($this->appKey . '_agora_token', $this->agoraToken, $this->expireTimeInSeconds);
+            }
+            return $this->agoraToken;
+        }
+        return '';
+    }
+
+    /**
+     * @ignore 获取声网 token 置换的环信 token
+     * @return string 声网 token 置换的环信 token
+     * @example
+     * <pre>
+     * $auth->getAgoraToken2easemobToken();
+     * </pre>
+     */
+    public function getAgoraToken2easemobToken()
+    {
+        if ($this->isAgora) {
+            $this->agoraToken2easemobToken = Cache::get($this->appKey . '_agora_2_easemob_token');
+            if (!$this->agoraToken2easemobToken) {
+                $agoraToken = $this->getAgoraToken();
+                $this->agoraToken2easemobToken();
+            }
+            return $this->agoraToken2easemobToken;
+        }
+        return '';
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取用户 token
+     * 
+     * @param  string $username        环信 IM 用户名，或者 uuid
+     * @param  string $password        环信用户密码，传递时获取 Easemob userToken 否则获取 Agora userToken
+     * @param  int    $expireInSeconds token 过期时间，单位：s
+     * @param  array  $configuration   privileges
+     * @return array                   用户 token 信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get user token
+     * 
+     * @param  string $username        easemob user name or uuid
+     * @param  string $password        easemob user login password, obtain easemob usertoken when passing, otherwise obtain Agora usertoken
+     * @param  int    $expireInSeconds Expiration time of token, unit: S
+     * @param  array  $configuration   privileges
+     * @return array                   User token information or error
+     */
+    public function getUserToken($username, $password = null, $expireInSeconds = 3600, $configuration = null)
+    {
+        if ($password) {
+            $body = array(
+                'grant_type' => 'password',
+                'username' => $username,
+                'password' => $password,
+            );
+            if ($expireInSeconds) {
+                $expireInSeconds = (int)$expireInSeconds;
+                if ($expireInSeconds) {
+                    $body['ttl'] = $expireInSeconds;
+                }
+            }
+            $uri = $this->getBaseUri() . '/token';
+            $resp = Http::post($uri, $body);
+            if (!$resp->ok()) {
+                return \Easemob\error($resp);
+            }
+            $data = $resp->data();
+            return array(
+                'access_token' => $data['access_token'],
+                'expires_in' => $data['expires_in'],
+            );
+        } elseif ($this->isAgora) {
+            if ($configuration) {
+                $accessToken = new AccessToken2($this->appID, $this->appCertificate, $expireInSeconds);
+                foreach ($configuration as $item) {
+                    $accessToken->addService($item);
+                }
+                $userToken = $accessToken->build();
+            } else {
+                $userToken = ChatTokenBuilder2::buildUserToken($this->appID, $this->appCertificate, $username, $expireInSeconds);
+            }
+            return array(
+                'access_token' => $userToken,
+                'expires_in' => $expireInSeconds ? $expireInSeconds : $this->expireTimeInSeconds,
+            );
+        }
+    }
+
+    /// @cond
+    /**
+     * @ignore 获取请求头
+     * @return array 请求头
+     */
+    public function headers()
+    {
+        $res = $this->isAgora ? $this->getAgoraToken2easemobToken() : $this->getEasemobToken();
+        if (!isset($res['code']) && is_string($res)) {
+            return array(
+                'Authorization' => 'Bearer ' . $res,
+            );
+        }
+    }
+    /// @endcond
+
+    /**
+     * @ignore 获取 REST API 域名
+     * @return string REST API 域名
+     */
+    private function getRemoteApiUri()
+    {
+        $uri = self::$DNS_URL . '/easemob/server.json?app_key=' . $this->appKey;
+        $resp = Http::get($uri);
+        if ($resp->ok()) {
+            $data = $resp->data();
+            $restDomains = array_values(array_filter($data['rest']['hosts'], function($item) {
+                return $item['protocol'] === 'https';
+            }));
+            $this->apiUri = $restDomains[0]['protocol'] . '://' . $restDomains[0]['domain'];
+            return $this->apiUri;
+        }
+        return '';
+    }
+
+    /**
+     * @ignore 获取环信 token
+     * @return string 环信 token
+     */
+    private function getEasemobAccessToken()
+    {
+        // 环信 token
+        $uri = $this->getBaseUri() . '/token';
+        $body = array(
+            'grant_type' => 'client_credentials',
+            'client_id' => $this->clientId,
+            'client_secret' => $this->clientSecret,
+            'ttl' => $this->expireTimeInSeconds,
+        );
+        $resp = Http::post($uri, $body);
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        if ($data['access_token']) {
+            Cache::set($this->appKey . '_easemob_token', $data['access_token'], $data['expires_in']/2);
+            return $data['access_token'];
+        }
+        return '';
+    }
+
+    /**
+     * @ignore 声网 token 置换环信 token
+     * @param string 环信用户 uuid
+     * @param int    token 有效期
+     */
+    private function agoraToken2easemobToken()
+    {
+        $uri = 'http://a41.easemob.com/' . $this->orgName . '/' . $this->appName . '/token';
+
+        $body = array(
+            'grant_type' => 'agora',
+        );
+        $headers = array(
+            'Authorization' => 'Bearer ' . $this->agoraToken,
+        );
+        $resp = Http::post($uri, $body, $headers);
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        
+        if ($data['access_token']) {
+            $this->agoraToken2easemobToken = $data['access_token'];
+            Cache::set($this->appKey . '_agora_2_easemob_token', $data['access_token'], 2592000);
+        }
+    }
+}

vendor/maniac/easemob-php/src/Block.php

@@ -0,0 +1,1172 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * Block 用于限制访问(将用户加入黑名单、群组/聊天室禁言等)
+ * 
+ * \~english
+ * The `Block` is used to restrict access (add users to blacklists, group / chat room prohibitions, etc.)
+ */
+final class Block
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取用户黑名单
+     * 
+     * @param  string $username 要获取黑名单的用户
+     * @return array            黑名单用户名列表或者错误
+     * 
+     * \~english
+     * \brief
+     * Get user blacklist
+     * 
+     * @param  string $username User name
+     * @return array            Blacklist user name list or error
+     */
+    public function getUsersBlockedFromSendMsgToUser($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/blocks/users';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加用户黑名单
+     * 
+     * \details
+     * 向用户的黑名单列表中添加一个或者多个用户，黑名单中的用户无法给该用户发送消息，每个用户的黑名单人数上限为 500。
+     * 
+     * @param  string  $username  要添加黑名单的用户名
+     * @param  array   $usernames 需要加入到黑名单中的用户名，以数组方式提交
+     * @return boolean|array      成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add user blacklist
+     * 
+     * \details
+     * Add one or more users to the user's blacklist. Users in the blacklist cannot send messages to the user. The maximum number of blacklists for each user is 500.
+     * 
+     * @param  string  $username  User name
+     * @param  array   $usernames The user names that need to be added to the blacklist shall be submitted in the form of array
+     * @return boolean|array      Success or error
+     */
+    public function blockUserSendMsgToUser($username, $usernames = array())
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+        if (!is_array($usernames)) {
+            \Easemob\exception('Please pass in the user array to be blacklisted');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/blocks/users';
+        $body = compact('usernames');
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 移除用户黑名单
+     * 
+     * \details
+     * 从用户的黑名单中移除用户。将用户从黑名单移除后，恢复到好友，或者未添加好友的用户关系。可以正常的进行消息收发。
+     * 
+     * @param  string  $username        要移除黑名单的用户名
+     * @param  string  $friend_username 好友用户名
+     * @return boolean|array            成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove user blacklist
+     * 
+     * \details
+     * Remove the user from the user's blacklist. After the user is removed from the blacklist, it can be restored to friends, or the user relationship without adding friends. Can send and receive messages normally.
+     * 
+     * @param  string  $username        User name
+     * @param  string  $friend_username Friends user name
+     * @return boolean|array            Success or error
+     */
+    public function unblockUserSendMsgToUser($username, $blocked_username)
+    {
+        if (!trim($username) || !trim($blocked_username)) {
+            \Easemob\exception('Please enter the user name and the user name to remove the blacklist');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/blocks/users/' . $blocked_username;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 账号封禁
+     * 
+     * \details
+     * 用户若被禁用将立即下线并无法登录，直到被解禁后才能恢复登录。常用在对异常用户的即时处理场景使用。
+     * 
+     * @param  string  $username 要封禁的用户名
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Account number ban
+     * 
+     * \details
+     * If the user is disabled, he will be offline immediately and cannot log in until he is lifted. It is often used in the immediate processing of abnormal users.
+     * 
+     * @param  string  $username User name
+     * @return boolean|array     Success or error
+     */
+    public function blockUserLogin($username)
+    {
+        return $this->activate($username, 0);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 账号解禁
+     * 
+     * \details
+     * 用户若被禁用将立即下线并无法登录，直到被解禁后才能恢复登录。常用在对异常用户的即时处理场景使用。
+     * 
+     * @param  string  $username 要解禁的用户名
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Account lifting
+     * 
+     * \details
+     * If the user is disabled, he will be offline immediately and cannot log in until he is lifted. It is often used in the immediate processing of abnormal users.
+     * 
+     * @param  string  $username User name
+     * @return boolean|array     Success or error
+     */
+    public function unblockUserLogin($username)
+    {
+        return $this->activate($username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 设置用户全局禁言
+     * 
+     * \details
+     * 设置单个用户 ID 的单聊、群组、聊天室消息全局禁言。
+     * 
+     * @param  string $username              用户名
+     * @param  int    $chatMuteDuration      单聊消息禁言时间，单位为秒，非负整数，最大值为 2147483647，`0` 表示取消该帐号的单聊消息禁言，`-1` 表示该帐号被设置永久禁言，其它值表示该帐号的具体禁言时间，负值为非法值。
+     * @param  int    $groupchatMuteDuration 群组消息禁言时间，单位为秒，规则同上。
+     * @param  int    $chatroomMuteDuration  聊天室消息禁言时间，单位为秒，规则同上。
+     * @return boolean|array                 成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Set user global prohibitions
+     * 
+     * \details
+     * Set the global prohibition of single chat, group and chat room messages of a single user ID.
+     * 
+     * @param  string $username              User name
+     * @param  int    $chatMuteDuration      Single chat message forbidden time, in seconds, is a non negative integer. The maximum value is 2147483647, ` 0 'means to cancel the forbidden time of single chat messages of the account, ` - 1' means that the account is set with permanent forbidden time, other values mean the specific forbidden time of the account, and negative values are illegal values.
+     * @param  int    $groupchatMuteDuration Group message forbidden time, in seconds, and the rules are the same as above.
+     * @param  int    $chatroomMuteDuration  Chat room message forbidden time, in seconds, and the rules are the same as above.
+     * @return boolean|array                 Success or error
+     */
+    public function blockUserSendMsg($username, $chatMuteDuration = -1, $groupchatMuteDuration = -1, $chatroomMuteDuration = -1)
+    {
+        return $this->blockUserSendMsgGlobal($username, $chatMuteDuration, $groupchatMuteDuration, $chatroomMuteDuration);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 解除用户全局禁言
+     * 
+     * @param  string $username 解除禁言的用户名
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Lifting the user's global prohibition
+     * 
+     * @param  string $username User name
+     * @return boolean|array    Success or error
+     */
+    public function unblockUserSendMsg($username)
+    {
+        return $this->blockUserSendMsgGlobal($username, 0, 0, 0);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 查询单个用户 ID 全局禁言
+     * 
+     * \details
+     * 查询单个用户的单聊/群聊/聊天室消息禁言。
+     * 
+     * @param  string $username 查询禁言信息的用户名
+     * @return array            用户全局禁言信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Query single user ID global prohibitions
+     * 
+     * \details
+     * Query the forbidden words of single chat / group chat / chat room messages of a single user.
+     * 
+     * @param  string $username User name
+     * @return array            User global forbidden information or error
+     */
+    public function getUserBlocked($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/mutes/' . $username;
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 查询APPKEY的用户禁言
+     * 
+     * \details
+     * 查询 App Key 下的用户禁言剩余时间的集合。
+     * 
+     * @param  int   $pageSize 请求查询每页显示的禁言用户的数量，默认取 10 条
+     * @param  int   $pageNum  请求查询的页码，默认取第 1 页
+     * @return array           用户禁言信息或者错误
+     * 
+     * \~english
+     * \brief
+     * User prohibitions for querying appkey
+     * 
+     * \details
+     * Query the collection of the remaining time of the user's forbidden words under the app key.
+     * 
+     * @param  int   $pageSize Request to query the number of forbidden users displayed on each page. The default is 10
+     * @param  int   $pageNum  The page number requested for query is page 1 by default
+     * @return array           User forbidden information or error
+     */
+    public function getAppBlocked($pageSize = 10, $pageNum = 1)
+    {
+        $pageSize = (int)$pageSize > 0 ? (int)$pageSize : 10;
+        $pageNum = (int)$pageNum > 0 ? (int)$pageNum : 1;
+        
+        $uri = $this->auth->getBaseUri() . '/mutes';
+        $uri .= $pageSize ? ('?pagesize=' . $pageSize . '&pagenum=' . $pageNum) : '';
+
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return isset($data['data']) ? $data['data'] : $data;
+    }
+
+    // Group
+    /**
+     * \~chinese
+     * \brief
+     * 查询群组黑名单
+     * 
+     * \details
+     * 查询一个群组黑名单中的用户列表。位于黑名单中的用户查看不到该群组的信息，也无法收到该群组的消息。
+     * 
+     * @param  string $groupId 群组 ID
+     * @return array           群组黑名单信息或者错误
+     * 
+     * 
+     * \~english
+     * \brief
+     * Query group blacklist
+     * 
+     * \details
+     * Query the list of users in a group blacklist. Users in the blacklist cannot view the information of the group or receive the message of the group.
+     * 
+     * @param  string $groupId Group ID
+     * @return array           Group blacklist information or error
+     */
+    public function getUsersBlockedJoinGroup($groupId)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/blocks/users';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加单个用户至群组黑名单
+     * 
+     * \details
+     * 添加一个用户进入一个群组的黑名单。群主无法被加入群组的黑名单。
+     * 
+     * 用户进入群组黑名单后，会收到消息：You are kicked out of the group xxx。之后，该用户查看不到该群组的信息，也收不到该群组的消息。
+     * 
+     * @param  string $groupId  群组 ID
+     * @param  string $username 要添加的 IM 用户名
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add a single user to the group blacklist
+     * 
+     * \details
+     * Add a user to the blacklist of a group. The group leader cannot be added to the blacklist of the group.
+     * 
+     * After entering the group blacklist, the user will receive a message: you are kicked out of the group XXX. After that, the user cannot view the information of the group or receive the message of the group.
+     * 
+     * @param  string $groupId  Group ID
+     * @param  string $username User name
+     * @return boolean|array    Success or error
+     */
+    public function blockUserJoinGroup($groupId, $username)
+    {
+        return $this->addGroupBlocks($groupId, $username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量添加用户至群组黑名单
+     * 
+     * \details
+     * 将多个用户添加一个群组的黑名单。你一次最多可以添加 60 个用户至群组黑名单。群主无法被加入群组的黑名单。
+     * 
+     * 用户进入群组黑名单后，会收到消息：You are kicked out of the group xxx。之后，该用户查看不到该群组的信息，也收不到该群组的消息。
+     *
+     * @param  string $groupId   群组 ID
+     * @param  array  $usernames 要添加的 IM 用户名数组
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch add users to group blacklist
+     * 
+     * \details
+     * Add multiple users to the blacklist of a group. You can add up to 60 users to the group blacklist at a time. The group leader cannot be added to the blacklist of the group.
+     * 
+     * After entering the group blacklist, the user will receive a message: you are kicked out of the group XXX. After that, the user cannot view the information of the group or receive the message of the group.
+     * 
+     * @param  string $groupId   Group ID
+     * @param  array  $usernames User name array
+     * @return boolean|array     Success or error
+     */
+    public function blockUsersJoinGroup($groupId, $usernames)
+    {
+        return $this->addGroupBlocks($groupId, $usernames);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 从群组黑名单移除单个用户
+     * 
+     * \details
+     * 将指定用户移出群组黑名单。对于群组黑名单中的用户，如果需要将其再次加入群组，需要先将其从群组黑名单中移除。
+     * 
+     * @param  string $groupId  群组 ID
+     * @param  string $username 要移除的用户名
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove a single user from the group blacklist
+     * 
+     * \details
+     * Remove the specified user from the group blacklist. For users in the group blacklist, if they need to join the group again, they need to be removed from the group blacklist first.
+     * 
+     * @param  string $groupId  Group ID
+     * @param  string $username User name
+     * @return boolean|array    Success or error
+     */
+    public function unblockUserJoinGroup($groupId, $username)
+    {
+        return $this->removeGroupBlocks($groupId, $username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 从群组黑名单批量移除用户
+     * 
+     * \details
+     * 将多名指定用户从群组黑名单中移除。对于群组黑名单中的用户，如果需要将其再次加入群组，需要先将其从群组黑名单中移除。
+     * 
+     * @param  string $groupId   群组 ID
+     * @param  array  $usernames 要添加的 IM 用户名数组
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch remove users from group blacklist
+     * 
+     * \details
+     * Remove multiple designated users from the group blacklist. For users in the group blacklist, if they need to join the group again, they need to be removed from the group blacklist first.
+     * 
+     * @param  string $groupId   Group ID
+     * @param  array  $usernames User name array
+     * @return boolean|array     Success or error
+     */
+    public function unblockUsersJoinGroup($groupId, $usernames)
+    {
+        return $this->removeGroupBlocks($groupId, $usernames);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加群组禁言
+     * 
+     * \details
+     * 对指定群成员禁言。群成员被禁言后，将无法在群中发送消息。
+     * 
+     * @param  string  $groupId       群组 ID
+     * @param  array   $usernames     要被添加禁言的用户 ID 数组
+     * @param  int     $mute_duration 禁言时长，单位为毫秒。
+     * @return boolean|array          成功或者错误
+     * 
+     * 
+     * \~english
+     * \brief
+     * Add group forbidden words
+     * 
+     * \details
+     * No speaking to designated group members. After group members are banned, they will not be able to send messages in the group.
+     * 
+     * @param  string  $groupId       Group ID
+     * @param  array   $usernames     User name array
+     * @param  int     $mute_duration Forbidden speech duration, in milliseconds.
+     * @return boolean|array          Success or error
+     */
+    public function blockUserSendMsgToGroup($groupId, $usernames, $mute_duration = -1)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if (!is_array($usernames) || empty($usernames)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $mute_duration = (int)$mute_duration > 0 ? (int)$mute_duration : -1;
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/mute';
+        $resp = Http::post($uri, compact('usernames', 'mute_duration'), $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 解除群组成员禁言
+     * 
+     * \details
+     * 将一个或多个群成员移除禁言列表。移除后，群成员可以在群组中正常发送消息。
+     * 
+     * @param  string  $groupId   群组 ID
+     * @param  array   $usernames 要移除禁言的用户 ID 数组
+     * @return boolean|array      成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Release group members from prohibition
+     * 
+     * \details
+     * Remove one or more group members from the forbidden list. After removal, group members can send messages normally in the group.
+     * 
+     * @param  string  $groupId   Group ID
+     * @param  array   $usernames User name array
+     * @return boolean|array      Success or error
+     */
+    public function unblockUserSendMsgToGroup($groupId, $usernames)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if (!is_array($usernames) || empty($usernames)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/mute/' . implode(',', $usernames);
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取禁言列表
+     * 
+     * \details
+     * 获取当前群组的禁言用户列表。
+     * 
+     * @param  string $groupId 群组 ID
+     * @return array           禁言列表信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get forbidden list
+     * 
+     * \details
+     * Get the list of forbidden users in the current group.
+     * 
+     * @param  string $groupId Group ID
+     * @return array           Forbidden list information or error
+     */
+    public function getUsersBlockedSendMsgToGroup($groupId)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/mute';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 禁言群组全体成员
+     * 
+     * \details
+     * 对所有群组成员一键禁言，即将群组的所有成员均加入禁言列表。设置群组全员禁言后，仅群组白名单中的用户可在群组内发消息
+     * 
+     * @param  string  $groupId       群组 ID
+     * @param  int     $mute_duration 禁言时长，单位为毫秒。
+     * @return boolean|array          成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Forbidden all members of the group
+     * 
+     * \details
+     * One click prohibition for all group members, that is, all members of the group will be added to the prohibition list. After setting the prohibition of all members of the group, only users in the group white list can send messages in the group
+     * 
+     * @param  string  $groupId       Group ID
+     * @param  int     $mute_duration Forbidden speech duration, in milliseconds.
+     * @return boolean|array          Success or error
+     */
+    public function blockAllUserSendMsgToGroup($groupId, $mute_duration = -1)
+    {
+
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        $mute_duration = (int)$mute_duration > 0 ? (int)$mute_duration : -1;
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/ban';
+        $resp = Http::post($uri, compact('mute_duration'), $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 解除群组全员禁言
+     * 
+     * \details
+     * 一键取消对群组全体成员的禁言。移除后，群成员可以在群组中正常发送消息。
+     * 
+     * @param  string  $groupId 群组 ID
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Lifting the ban on all members of the group
+     * 
+     * \details
+     * One click to cancel the ban on all members of the group. After removal, group members can send messages normally in the group.
+     * 
+     * @param  string  $groupId Group ID
+     * @return boolean|array    Success or error
+     */
+    public function unblockAllUserSendMsgToGroup($groupId)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/ban';
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+
+    // Room
+    /**
+     * \~chinese
+     * \brief
+     * 查询聊天室黑名单
+     * 
+     * \details
+     * 查询一个聊天室黑名单中的用户列表。黑名单中的用户无法查看或收到该聊天室的信息。
+     * 
+     * @param  string $roomId 聊天室 ID
+     * @return array          聊天室黑名单信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Query chat room blacklist
+     * 
+     * \details
+     * Query the list of users in a chat room blacklist. Users in the blacklist cannot view or receive information from this chat room.
+     * 
+     * @param  string $roomId Chat room ID
+     * @return array          Chat room blacklist information or error
+     */
+    public function getUsersBlockedJoinRoom($roomId)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/blocks/users';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加单个用户至聊天室黑名单
+     * 
+     * \details
+     * 添加一个用户进入一个聊天室的黑名单。聊天室所有者无法被加入聊天室的黑名单。
+     * 
+     * 用户进入聊天室黑名单后，会收到消息：“You are kicked out of the chatroom xxx”。之后，该用户无法查看和收发该聊天室的信息。
+     * 
+     * @param  string $roomId   聊天室 ID
+     * @param  string $username 要添加的 IM 用户名
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add a single user to the chat room blacklist
+     * 
+     * \details
+     * Add a user to the blacklist of a chat room. Chat room owners cannot be blacklisted.
+     * 
+     * After entering the chat room blacklist, users will receive a message: "you are kicked out of the chat room XXX". After that, the user cannot view and send the information of the chat room.
+     * 
+     * @param  string $roomId   Chat room ID
+     * @param  string $username User name
+     * @return boolean|array    Success or error
+     */
+    public function blockUserJoinRoom($roomId, $username)
+    {
+        return $this->addRoomBlocks($roomId, $username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量添加用户至聊天室黑名单
+     * 
+     * \details
+     * 将多个用户加入一个聊天室的黑名单。你一次最多可以添加 60 个用户至聊天室黑名单。聊天室所有者无法被加入聊天室的黑名单。
+     * 
+     * 用户进入聊天室黑名单后，会收到消息：“You are kicked out of the chatroom xxx”。之后，这些用户无法查看和收发该聊天室的信息。
+     * 
+     * @param  string $roomId    聊天室 ID
+     * @param  array  $usernames 要添加的 IM 用户名数组
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch add users to chat room blacklist
+     * 
+     * \details
+     * Add multiple users to the blacklist of a chat room. You can add up to 60 users to the chat room blacklist at a time. Chat room owners cannot be blacklisted.
+     * 
+     * After entering the chat room blacklist, users will receive a message: "you are kicked out of the chat room XXX". After that, these users cannot view and send the information of the chat room.
+     * 
+     * @param  string $roomId    Chat room ID
+     * @param  array  $usernames User name array
+     * @return boolean|array     Success or error
+     */
+    public function blockUsersJoinRoom($roomId, $usernames)
+    {
+        return $this->addRoomBlocks($roomId, $usernames);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 从聊天室黑名单移除单个用户
+     * 
+     * \details
+     * 将指定用户移出聊天室黑名单。对于聊天室黑名单中的用户，如果需要将其再次加入聊天室，需要先将其从聊天室黑名单中移除。
+     * 
+     * @param  string $roomId   聊天室 ID
+     * @param  string $username 要添加的 IM 用户名
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove a single user from the chat room blacklist
+     * 
+     * \details
+     * Remove the specified user from the chat room blacklist. For users in the chat room blacklist, if they need to join the chat room again, they need to be removed from the chat room blacklist first.
+     * 
+     * @param  string $roomId   Chat room ID
+     * @param  string $username User name
+     * @return boolean|array    Success or error
+     */
+    public function unblockUserJoinRoom($roomId, $username)
+    {
+        return $this->removeRoomBlocks($roomId, $username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 从聊天室黑名单批量移除用户
+     * 
+     * \details
+     * 将多名指定用户从聊天室黑名单中移除。你每次最多可移除 60 个用户。对于聊天室黑名单中的用户，如果需要将其再次加入聊天室，需要先将其从聊天室黑名单中移除。
+     * 
+     * @param  string $roomId    聊天室 ID
+     * @param  array  $usernames 要添加的 IM 用户名数组
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch remove users from chat room blacklist
+     * 
+     * \details
+     * Remove multiple designated users from the chat room blacklist. You can remove up to 60 users at a time. For users in the chat room blacklist, if they need to join the chat room again, they need to be removed from the chat room blacklist first.
+     * 
+     * @param  string $roomId    Chat room ID
+     * @param  array  $usernames User name array
+     * @return boolean|array     Success or error
+     */
+    public function unblockUsersJoinRoom($roomId, $usernames)
+    {
+        return $this->removeRoomBlocks($roomId, $usernames);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 禁言聊天室成员
+     * 
+     * \details
+     * 将用户禁言。用户被禁言后，将无法在聊天室中发送消息。
+     * 
+     * @param  string  $roomId        聊天室 ID
+     * @param  array   $usernames     要被添加禁言的用户 ID 数组
+     * @param  int     $mute_duration 禁言的时间，单位毫秒，如果是“-1”代表永久（实际的到期时间为固定时间戳4638873600000，即2117-01-01 00:00:00）
+     * @return boolean|array          成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Forbidden chat room members
+     * 
+     * \details
+     * Forbid users from speaking. After being banned, users will not be able to send messages in the chat room.
+     * 
+     * @param  string  $roomId        Chat room ID
+     * @param  array   $usernames     User name array
+     * @param  int     $mute_duration Forbidden time, in milliseconds. If "- 1" means permanent (the actual expiration time is the fixed timestamp 4638873600000, i.e. 2117-01-01 00:00:00)
+     * @return boolean|array          Success or error
+     */
+    public function blockUserSendMsgToRoom($roomId, $usernames, $mute_duration = -1)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if (!is_array($usernames) || empty($usernames)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $mute_duration = (int)$mute_duration > 0 ? (int)$mute_duration : -1;
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/mute';
+        $resp = Http::post($uri, compact('usernames', 'mute_duration'), $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 解除聊天室禁言成员
+     * 
+     * \details
+     * 将用户从禁言列表中移除，可以移除多个 member。移除后，用户可以正常在聊天室中发送消息。
+     * 
+     * @param  string  $roomId    聊天室 ID
+     * @param  array   $usernames 要移除禁言的用户 ID 数组
+     * @return boolean|array      成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Unblock chat room members
+     * 
+     * \details
+     * You can remove multiple members by removing users from the forbidden list. After removal, users can send messages in the chat room normally.
+     * 
+     * @param  string  $roomId    Chat room ID
+     * @param  array   $usernames User name array
+     * @return boolean|array      Success or error
+     */
+    public function unblockUserSendMsgToRoom($roomId, $usernames)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if (!is_array($usernames) || empty($usernames)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/mute/' . implode(',', $usernames);
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取聊天室禁言列表
+     * 
+     * @param  string $roomId  聊天室 ID
+     * @return array           禁言列表信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get chat room forbidden list
+     * 
+     * @param  string $roomId  Chat room ID
+     * @return array           Forbidden list information or error
+     */
+    public function getUsersBlockedSendMsgToRoom($roomId)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/mute';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return isset($data['data']) ? $data['data'] : $data;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 禁言聊天室全体成员
+     * 
+     * \details
+     * 对所有聊天室成员一键禁言，即将聊天室的所有成员均加入禁言列表。设置聊天室全员禁言后，仅聊天室白名单中的用户可在聊天室内发消息。
+     * @param  string  $roomId        聊天室 ID
+     * @param  int     $mute_duration 禁言时长，单位为毫秒。
+     * @return boolean|array          成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Forbidden all members of the room
+     * 
+     * \details
+     * One click prohibition for all members of the chat room, that is, all members of the chat room will be added to the prohibition list. After setting the prohibition of all members in the chat room, only users in the chat room white list can send messages in the chat room.
+     * 
+     * @param  string  $roomId        Chat room ID
+     * @param  int     $mute_duration Forbidden speech duration, in milliseconds.
+     * @return boolean|array          Success or error
+     */
+    public function blockAllUserSendMsgToRoom($roomId, $mute_duration = -1)
+    {
+
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $mute_duration = (int)$mute_duration > 0 ? (int)$mute_duration : -1;
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/ban';
+        $resp = Http::post($uri, compact('mute_duration'), $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 解除聊天室全员禁言
+     * 
+     * \details
+     * 一键取消对聊天室全体成员的禁言。移除后，聊天室成员可以在聊天室中正常发送消息。
+     * 
+     * @param  string  $roomId  聊天室 ID
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Lifting the ban on all members of the chat room
+     * 
+     * \details
+     * One click to cancel the ban on all members of the chat room. After removal, chat room members can send messages normally in the chat room.
+     * 
+     * @param  string  $roomId  Chat room ID
+     * @return boolean|array    Success or error
+     */
+    public function unblockAllUserSendMsgToRoom($roomId)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/ban';
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore 设置用户全局禁言
+     * @param  string $username              用户名
+     * @param  int    $chatMuteDuration      单聊消息禁言时间，单位为秒，非负整数，最大值为 2147483647，`0` 表示取消该帐号的单聊消息禁言，`-1` 表示该帐号被设置永久禁言，其它值表示该帐号的具体禁言时间，负值为非法值。
+     * @param  int    $groupchatMuteDuration 群组消息禁言时间，单位为秒，规则同上。
+     * @param  int    $chatroomMuteDuration  聊天室消息禁言时间，单位为秒，规则同上。
+     * @return boolean|array                 成功或者错误
+     */
+    private function blockUserSendMsgGlobal($username, $chatMuteDuration = -1, $groupchatMuteDuration = -1, $chatroomMuteDuration = -1)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+
+        $chatMuteDuration = (int)$chatMuteDuration >= 0 ? (int)$chatMuteDuration : -1;
+        $groupchatMuteDuration = (int)$groupchatMuteDuration >= 0 ? (int)$groupchatMuteDuration : -1;
+        $chatroomMuteDuration = (int)$chatroomMuteDuration >= 0 ? (int)$chatroomMuteDuration : -1;
+
+        $data = array(
+            'username' => $username,
+            'chat' => $chatMuteDuration,
+            'groupchat' => $groupchatMuteDuration,
+            'chatroom' => $chatroomMuteDuration,
+        );
+
+        $uri = $this->auth->getBaseUri() . '/mutes';
+        $resp = Http::post($uri, $data, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        $data = $data['data'];
+        if (isset($data['result']) && $data['result'] == 'ok') {
+            return true;
+        }
+        return false;
+    }
+
+    /**
+     * @ignore 账号封禁与解禁
+     * @param  string  $username 要操作用户的用户名
+     * @param  int     $status   0：禁用；1：解禁
+     * @return boolean|array     成功或者错误
+     */
+    private function activate($username, $status = 1)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter your username');
+        }
+        $status = (int)$status ? 1 : 0;
+        $uri = $this->auth->getBaseUri() . '/users/' . $username;
+        $uri .= $status ? '/activate' : '/deactivate';
+        $resp = Http::post($uri, array(), $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore 添加用户至群组黑名单
+     * @param  string       $groupId   群组 ID
+     * @param  array|string $usernames 要添加的 IM 用户名，string: 添加单个用户；array: 批量添加
+     * @return boolean|array           成功或者错误
+     */
+    private function addGroupBlocks($groupId, $usernames)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if ((is_array($usernames) && empty($usernames)) || (is_string($usernames) && !trim($usernames))) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/blocks/users';
+        $uri .= is_string($usernames) ? ('/' . $usernames) : '';
+        $body = is_array($usernames) ? compact('usernames') : null;
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore 从群组黑名单移除用户
+     * @param  string       $groupId   群组 ID
+     * @param  array|string $usernames 要移除的 IM 用户名，string: 移除单个用户；array: 批量移除
+     * @return boolean|array           成功或者错误
+     */
+    private function removeGroupBlocks($groupId, $usernames)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if ((is_array($usernames) && empty($usernames)) || (is_string($usernames) && !trim($usernames))) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/blocks/users/';
+        $uri .= is_array($usernames) ? implode(',', $usernames) : $usernames;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore 添加用户至聊天室黑名单
+     * @param  string       $roomId   聊天室 ID
+     * @param  array|string $usernames 要添加的 IM 用户名，string: 添加单个用户；array: 批量添加
+     * @return boolean|array           成功或者错误
+     */
+    private function addRoomBlocks($roomId, $usernames)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if ((is_array($usernames) && empty($usernames)) || (is_string($usernames) && !trim($usernames))) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/blocks/users';
+        $uri .= is_string($usernames) ? ('/' . $usernames) : '';
+        $body = is_array($usernames) ? compact('usernames') : null;
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore 从聊天室黑名单移除用户
+     * @param  string       $roomId   聊天室 ID
+     * @param  array|string $usernames 要移除的 IM 用户名，string: 移除单个用户；array: 批量移除
+     * @return boolean|array           成功或者错误
+     */
+    private function removeRoomBlocks($roomId, $usernames)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if ((is_array($usernames) && empty($usernames)) || (is_string($usernames) && !trim($usernames))) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/blocks/users/';
+        $uri .= is_array($usernames) ? implode(',', $usernames) : $usernames;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+}

vendor/maniac/easemob-php/src/Cache/Cache.php

@@ -0,0 +1,64 @@
+<?php
+namespace Easemob\Cache;
+
+/**
+ * @ignore 文件缓存类
+ * @final
+ */
+final class Cache
+{
+    /**
+     * 获取缓存 key
+     * @param  string $name 缓存名称
+     * @return string       缓存 key
+     */
+    public static function getCacheKey($name)
+    {
+        return md5($name) . '.php';
+    }
+
+    /**
+     * 获取缓存值
+     * @param  string $name 缓存名称
+     * @return mixed        缓存值
+     */
+    public static function get($name)
+    {
+        $path = __DIR__ . '/../../runtime/cache';
+        $filename = $path . '/' . self::getCacheKey($name);
+        if (!file_exists($filename)) {
+            return null;
+        }
+
+        $content = file_get_contents($filename);
+        $data = json_decode($content, true);
+        return $data['expire'] <= time() ? null : $data['value'];
+    }
+
+    /**
+     * 设置缓存值
+     * @param  string $name   缓存名称
+     * @param  mixed  $value  缓存值
+     * @param  int    $expire 过期时间
+     * @return boolean        是否设置成功
+     */
+    public static function set($name, $value, $expire = 3600)
+    {
+        $path = __DIR__ . '/../../runtime/cache';
+        if (!is_dir($path)) {
+            mkdir($path, 0755, true);
+        }
+
+        $filename = self::getCacheKey($name);
+        $data = array(
+            'value'  => $value,
+            'expire' => time() + $expire,
+        );
+        
+        $result = file_put_contents($path . '/' . $filename, json_encode($data));
+        if ($result === false) {
+            \Easemob\exception($path . " 目录无写入权限");
+        }
+        return true;
+    }
+}

vendor/maniac/easemob-php/src/Contact.php

@@ -0,0 +1,128 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * Contact 用来管理联系人（添加好友等）
+ * 
+ * \~english
+ * The `Contact` is used to manage contacts (add friends, etc.)
+ */
+final class Contact
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加好友
+     * 
+     * \details
+     * 好友必须是和自己在一个 App Key 下的用户。免费版 App Key 下的每个用户的好友数量上限为 1000，不同版本 App Key 上限不同，具体可参考：<a href="https://www.easemob.com/pricing/im" target="_blank">版本功能介绍</a>。
+     * 
+     * @param  string  $username 要添加好友的用户名
+     * @param  string  $contact  好友用户名
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add friends
+     * 
+     * \details
+     * Friends must be users under the same app key with themselves. The maximum number of friends of each user under the free version of APP key is 1000. The maximum number of friends of different versions of APP key is different. For details, please refer to:<a href="https://www.easemob.com/pricing/im" target="_blank">version function introduction</a>.
+     * 
+     * @param  string  $username User name
+     * @param  string  $contact  Friend user name
+     * @return boolean|array     Success or error
+     */
+    public function add($username, $contact)
+    {
+        if (!trim($username) || !trim($contact)) {
+            \Easemob\exception('Please enter username and friend username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/contacts/users/' . $contact;
+        $resp = Http::post($uri, array(), $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 移除好友
+     * 
+     * \details
+     * 从用户的好友列表中移除一个用户。
+     * 
+     * @param  string  $username 要移除好友的用户名
+     * @param  string  $contact  好友用户名
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove friends
+     * 
+     * \details
+     * Removes a user from the user's friends list.
+     * 
+     * @param  string  $username User name
+     * @param  string  $contact  Friend user name
+     * @return boolean|array     Success or error
+     */
+    public function remove($username, $contact)
+    {
+        if (!trim($username) || !trim($contact)) {
+            \Easemob\exception('Please enter username and friend username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/contacts/users/' . $contact;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取好友列表
+     * 
+     * @param  string $username 要获取好友列表的用户名
+     * @return array            好友列表或者错误
+     * 
+     * \~english
+     * \brief
+     * Get friends list
+     * 
+     * @param  string $username User name
+     * @return array            Friends list or error
+     */
+    public function get($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/contacts/users';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+}

vendor/maniac/easemob-php/src/Group.php

@@ -0,0 +1,1082 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * Group 用来管理群组
+ * 
+ * \~english
+ * The `Group` is used to manage group
+ */
+final class Group
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /**
+     * @ignore
+     * @var array $modifiedAllowedField 修改群组信息时，请求体中允许的属性，5.6 版本前不能声明类常量数组，改为静态变量代替
+     */
+    private static $modifiedAllowedField = array(
+        'groupname',
+        'description',
+        'maxusers',
+        'membersonly',
+        'allowinvites',
+        'custom',
+    );
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取 App 中所有的群组（可分页）
+     * 
+     * @param  int    $limit  一次获取的群组数量，默认获取 10 条。
+     * @param  string $cursor 分页使用，传入游标后便从游标起始的地方进行查询，类似于数据库 limit 1,5 中 1 的作用，可以理解为页码。
+     * @return array          群组列表信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get all groups in the app (pagable)
+     * 
+     * @param  int    $limit  Number of groups obtained at one time, get 10 by default.
+     * @param  string $cursor Paging is used. After the cursor is passed in, it will be queried from the beginning of the cursor, which is similar to the function of 1 in database limit 1,5. It can be understood as page number.
+     * @return array          Group list information or error
+     */
+    public function listGroups($limit = 10, $cursor = '')
+    {
+        $limit = (int)$limit < 0 ? 1 : (int)$limit;
+        $uri = $this->auth->getBaseUri() . '/chatgroups';
+        $uri .= $limit ? '?limit=' . $limit : '';
+        $uri .= ($limit && $cursor) ? '&cursor='.$cursor : '';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        
+        $data = $resp->data();
+        return array(
+            'cursor' => isset($data['cursor']) ? $data['cursor'] : '',
+            'data' => $data['data'],
+        );
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取 App 中所有的群组
+     * 
+     * @return array 群组列表信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get all groups in the app
+     * 
+     * @return array Group list information or error
+     */
+    public function listAllGroups()
+    {
+        $data = $this->listGroups(0);
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 分页获取单个用户加入的所有群组
+     * 
+     * @param  string $username 用户名
+     * @param  int    $pageSize 每页获取的群组数量。该参数仅适用于分页获取方法。默认取 10 条。
+     * @param  int    $pageNum  当前页码。该参数仅适用于分页获取方法。
+     * @return array            群组信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Paged access to all groups joined by a single user
+     * 
+     * @param  string $username User name
+     * @param  int    $pageSize Number of groups obtained per page. This parameter is only applicable to the paging get method. 10 by default.
+     * @param  int    $pageNum  Current page number. This parameter is only applicable to the paging get method.
+     * @return array            Group information or error
+     */
+    public function listGroupsUserJoined($username, $pageSize = 10, $pageNum = 1)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please pass the user name');
+        }
+        $pageSize = (int)$pageSize > 0 ? (int)$pageSize : 0;
+        $pageNum = (int)$pageNum > 0 ? (int)$pageNum : 1;
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/joined_chatgroups';
+        $uri .= $pageSize ? ('?pagesize='.$pageSize.'&pagenum='.$pageNum) : '';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * brief
+     * 获取单个用户加入的所有群组
+     * 
+     * @param  string $username 用户名
+     * @return array            群组信息或者错误
+     * 
+     * \~english
+     * brief
+     * Get all groups joined by a single user
+     * 
+     * @param  string $username User name
+     * @return array            Group information or error
+     */
+    public function listAllGroupsUserJoined($username)
+    {
+        return $this->listGroupsUserJoined($username, 0);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取群组详情
+     * 
+     * \details
+     * 可以获取一个或多个群组的详情。当获取多个群组的详情时，返回所有存在的群组的详情；对于不存在的群组，返回 “group id doesn’t exist”。
+     * 
+     * @param  string $groupId 群组 ID，可以以逗号分割，同时传递多个群组 ID
+     * @return array           群组信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get group details
+     * 
+     * \details
+     * You can get the details of one or more groups. When the details of multiple groups are obtained, the details of all existing groups are returned; For group ID 'exist', return 'EST'.
+     * 
+     * @param  string $groupId Group ID, which can be separated by commas, and multiple group IDs can be passed at the same time
+     * @return array           Group information or error
+     */
+    public function getGroup($groupId)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/'. $groupId;
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return count($data['data']) > 1 ? $data['data'] : $data['data'][0];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 创建公开群
+     * 
+     * \details
+     * 创建一个公开的群组，并设置群主、群组名称、群组描述、群成员、群成员最大人数（包括群主）、加入群是否需要批准、群组扩展信息。
+     * 
+     * @param  string  $owner        群组管理员的用户名
+     * @param  string  $groupname    群组名称，最大长度为 128 字符。
+     * @param  string  $desc         群组描述，最大长度为 512 字符。
+     * @param  array   $members      群组成员，此属性为非必需，但是如果加此项，数组元素至少一个，不能超过 100 个。（注：群主 user1 不需要写入到 members 里面）
+     * @param  int     $maxusers     群组最大成员数（包括群主），值为数值类型，默认值 200，具体上限请参考 <a href="https://console.easemob.com/user/login" target="_blank">环信即时通讯云控制台</a>。
+     * @param  boolean $members_only 用户申请入群是否需要群主或者群管理员审批，默认是 false。true：是；false：否。
+     * @param  string  $custom       群组扩展信息，例如可以给群组添加业务相关的标记，不要超过 1024 字符。
+     * @return string|array          群组 id 或者错误
+     * 
+     * \~english
+     * \brief
+     * Create public group
+     * 
+     * \details
+     * Create a public group, and set the group owner, group name, group description, group members, the maximum number of group members (including group owners), whether to join the group requires approval, and group extension information.
+     * 
+     * @param  string  $owner        User name of the group administrator
+     * @param  string  $groupname    Group name, with a maximum length of 128 characters.
+     * @param  string  $desc         Group description, with a maximum length of 512 characters.
+     * @param  array   $members      This attribute is not required for group members, but if this item is added, there must be at least one array element, not more than 100. (Note: group leader user1 does not need to be written into members)
+     * @param  int     $maxusers     The maximum number of group members (including group owners), the value is numerical type, the default value is 200, please refer to the specific upper limit <a href="https://console.easemob.com/user/login" target="_blank">easemob console</a>。
+     * @param  boolean $members_only Whether the user's application to join the group needs the approval of the group owner or group administrator. The default is false. True: Yes; False: No.
+     * @param  string  $custom       Group extension information, for example, you can add business-related tags to the group, which should not exceed 1024 characters.
+     * @return string|array          Group ID or error
+     */
+    public function createPublicGroup($owner, $groupname, $desc, $members = array(), $maxusers = 200, $members_only = true, $custom = '')
+    {
+        // 公开群
+        $public = true;
+        // 公开群（public 为 true），则不允许群成员邀请别人加入此群
+        $allowinvites = false;
+        $data = compact('owner', 'groupname', 'desc', 'public', 'maxusers', 'allowinvites', 'members_only', 'members', 'custom');
+        return $this->create($data);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 创建私有群
+     * 
+     * \details
+     * 创建一个私有的群组，并设置群主、群组名称、群组描述、群成员、群成员最大人数（包括群主）、是否允许群成员邀请别人加入此群、群组扩展信息。
+     * 
+     * @param  string  $owner        群组管理员的用户名
+     * @param  string  $groupname    群组名称，最大长度为 128 字符。
+     * @param  string  $desc         群组描述，最大长度为 512 字符。
+     * @param  array   $members      群组成员，此属性为非必需，但是如果加此项，数组元素至少一个，不能超过 100 个。（注：群主 user1 不需要写入到 members 里面）
+     * @param  int     $maxusers     群组最大成员数（包括群主），值为数值类型，默认值 200，具体上限请参考 <a href="https://console.easemob.com/user/login" target="_blank">环信即时通讯云控制台</a>。
+     * @param  boolean $allowinvites 是否允许群成员邀请别人加入此群：true：允许群成员邀请人加入此群；false：只有群主或者管理员才可以往群里加人。
+     * @param  string  $custom       群组扩展信息，例如可以给群组添加业务相关的标记，不要超过 1024 字符。
+     * @return string|array          群组 id 或者错误
+     * 
+     * \~english
+     * \brief
+     * Create private group
+     * 
+     * \details
+     * Create a private group, and set the group owner, group name, group description, group members, maximum number of group members (including group owner), whether to allow group members to invite others to join the group, and group extension information.
+     * 
+     * @param  string  $owner        User name of the group administrator
+     * @param  string  $groupname    Group name, with a maximum length of 128 characters.
+     * @param  string  $desc         Group description, with a maximum length of 512 characters.
+     * @param  array   $members      This attribute is not required for group members, but if this item is added, there must be at least one array element, not more than 100. (Note: group leader user1 does not need to be written into members)
+     * @param  int     $maxusers     The maximum number of group members (including group owners), the value is numerical type, the default value is 200, please refer to the specific upper limit <a href="https://console.easemob.com/user/login" target="_blank">easemob console</a>。
+     * @param  boolean $allowinvites Allow group members to invite others to join the group: true: allow group members to invite people to join the group; False: only the group leader or administrator can add people to the group.
+     * @param  string  $custom       Group extension information, for example, you can add business-related tags to the group, which should not exceed 1024 characters.
+     * @return string|array          Group ID or error
+     */
+    public function createPrivateGroup($owner, $groupname, $desc, $members = array(), $maxusers = 200, $allowinvites = false, $custom = '')
+    {
+        // 私有群
+        $public = false;
+        // 如果允许了群成员邀请用户进群（allowinvites 为 true），那么就不需要群主或群管理员审批了
+        $members_only = $allowinvites ? false : true;
+        $data = compact('owner', 'groupname', 'desc', 'public', 'maxusers', 'allowinvites', 'members_only', 'members', 'custom');
+        return $this->create($data);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 修改群组信息
+     * 
+     * \details
+     * 修改成功的数据行会返回 true，失败为 false。请求 body 只接收 groupname、description、maxusers、membersonly、allowinvites、custom 六个属性，传不存在的字段，或者不能修改的字段会抛异常。
+     * 
+     * @param  array   $data 群组信息
+     *     - `groupname` string 类型，群组名称，修改时值不能包含斜杠（“/”），最大长度为 128 字符。
+     *     - `description` string 类型，群组描述，修改时值不能包含斜杠（“/”），最大长度为 512 字符。
+     *     - `maxusers` int 类型，群组成员最大数（包括群主），值为数值类型。
+     *     - `membersonly` string 类型，加入群组是否需要群主或者群管理员审批：true：是；false：否。
+     *     - `allowinvites` string 类型，是否允许群成员邀请别人加入此群：true：允许群成员邀请人加入此群；false：只有群主才可以往群里加人。
+     *     - `custom` string 类型，群组扩展信息，例如可以给群组添加业务相关的标记，不要超过 1,024 字符。
+     * @return boolean|array 成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Modify group information
+     * 
+     * \details
+     * The modified data row will return true, and the failure will be false. The request body only receives six attributes: groupname, description, maxusers, members only, allowinvites and custom. If it passes non-existent fields or fields that cannot be modified, exceptions will be thrown.
+     * 
+     * @param  array   $data Group information
+     *     - `groupname` string type. Group name. When modified, the value cannot contain slash ("/"), and the maximum length is 128 characters.
+     *     - `description` string type. Group description. When modifying, the value cannot contain slash ("/"), and the maximum length is 512 characters.
+     *     - `maxusers` int type. The maximum number of group members (including group owners) is the numerical value type.
+     *     - `membersonly` string type. Whether to join the group requires the approval of the group owner or group administrator: true: Yes; False: No.
+     *     - `allowinvites` string type. Allow group members to invite others to join the group: true: allow group members to invite people to join the group; False: only the group leader can add people to the group.
+     *     - `custom` string type. Group extension information, for example, you can add business-related tags to the group, which should not exceed 1024 characters.
+     * @return boolean|array Success or error
+     */
+    public function updateGroup($data)
+    {
+        $data['group_id'] = isset($data['group_id']) ? trim($data['group_id']) : '';
+        $groupId = $data['group_id'];
+        if (!$groupId) {
+            \Easemob\exception('Please pass the group ID');
+        }
+        unset($data['group_id']);
+        foreach ($data as $field => $value) {
+            if (!in_array($field, self::$modifiedAllowedField)) {
+                \Easemob\exception('Only groupname, description, maxusers, members only, allowinvites and custom are allowed at most');
+            }
+        }
+
+        if (isset($data['groupname'])) {
+            $data['groupname'] = trim($data['groupname']);
+            if (!$data['groupname']) {
+                \Easemob\exception('Group name cannot be empty');
+            } elseif (preg_match('/\//', $data['groupname'])) {
+                \Easemob\exception('The group name cannot contain a diagonal bar ("/)');
+            } elseif (mb_strlen($data['groupname']) > 128) {
+                \Easemob\exception('The maximum length of the group name is 128 characters');
+            }
+        }
+
+        if (isset($data['description'])) {
+            $data['description'] = trim($data['description']);
+            if (!$data['description']) {
+                \Easemob\exception('Group description cannot be empty');
+            } elseif (preg_match('/\//', $data['description'])) {
+                \Easemob\exception('The group description cannot contain diagonal bars ("/")');
+            } elseif (mb_strlen($data['description']) > 512) {
+                \Easemob\exception('The maximum length of the group description is 512 characters');
+            }
+        }
+
+        // 获取原始群组信息
+        $info = $this->getGroup($groupId);
+
+        if (isset($data['maxusers'])) {
+            $data['maxusers'] = (int)$data['maxusers'];
+        }
+
+        // 如果是公开群（public为true），则不允许群成员邀请别人加入此群
+        if ($info['public'] && isset($data['allowinvites'])) {
+            $data['allowinvites'] = false;
+        }
+
+        if (isset($data['membersonly'])) {
+            // 如果允许了群成员邀请用户进群（allowinvites为true），那么就不需要群主或群管理员审批了
+            $data['membersonly'] = $info['allowinvites'] ? false : (boolean)$data['membersonly'];
+        }
+        
+        if (isset($data['allowinvites'])) {
+            $data['allowinvites'] = (boolean)$data['allowinvites'];
+
+            if (isset($data['membersonly'])) {
+                // 如果允许了群成员邀请用户进群（allowinvites为true），那么就不需要群主或群管理员审批了
+                $data['membersonly'] = $data['allowinvites'] ? false : (boolean)$data['membersonly'];
+            }
+        }
+
+        if (isset($data['custom'])) {
+            $data['custom'] = trim($data['custom']);
+            if ($data['custom'] && mb_strlen($data['custom']) > 1024) {
+                \Easemob\exception('The maximum length of group extension information is 1024 characters');
+            }
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId;
+        $resp = Http::put($uri, $data, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 删除群组
+     * 
+     * @param  string  $groupId 群组 id
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Delete Group
+     * 
+     * @param  string  $groupId Group ID
+     * @return boolean|array    Success or error
+     */
+    public function destroyGroup($groupId)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取群组公告
+     * 
+     * \details
+     * 获取指定群组 ID 的群组公告。
+     * 
+     * @param  string $groupId 群组 id
+     * @return array           公告信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get group announcements
+     * 
+     * \details
+     * Gets the group announcement of the specified group ID.
+     * 
+     * @param  string $groupId Group ID
+     * @return array           Announcement information or error
+     */
+    public function getGroupAnnouncement($groupId)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please enter group ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/'. $groupId . '/announcement';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 修改群组公告
+     * 
+     * \details
+     * 修改指定群组 ID 的群组公告，注意群组公告的内容不能超过 512 个字符。
+     * 
+     * @param  string  $groupId      群组 ID
+     * @param  string  $announcement 群组公告内容
+     * @return boolean|array         成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Modify group announcement
+     * 
+     * \details
+     * Modify the group announcement of the specified group ID. note that the content of the group announcement cannot exceed 512 characters.
+     * 
+     * @param  string  $groupId      Group ID
+     * @param  string  $announcement Group announcement content
+     * @return boolean|array         Success or error
+     */
+    public function updateGroupAnnouncement($groupId, $announcement)
+    {
+        if (!trim($groupId) || !trim($announcement)) {
+            \Easemob\exception('Please enter the group ID and announcement content');
+        }
+
+        if (mb_strlen($announcement) > 512) {
+            \Easemob\exception('The content of the group announcement cannot exceed 512 characters');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/announcement';
+        $body = compact('announcement');
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data']['result'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取群组共享文件
+     * 
+     * \details
+     * 分页获取指定群组 ID 的群组共享文件，之后可以根据 response 中返回的 file_id，file_id 是群组共享文件的唯一标识，调用 {@link #downloadGroupShareFile($fileName, $groupId, $fileId)} 下载文件，或调用 {@link #deleteGroupShareFile($groupId, $fileId)} 删除文件。
+     * 
+     * @param  string $groupId  群组 ID
+     * @param  int    $pageSize 每页获取的群组数量。该参数仅适用于分页获取方法。默认取 10 条。
+     * @param  int    $pageNum  当前页码。该参数仅适用于分页获取方法。
+     * @return array            群组文件信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get group shared files
+     * 
+     * \details
+     * Get the group shared file of the specified group ID by paging, and then according to the file returned in the response_ id，file_ ID is the unique identification of the group shared file, call {@link #downloadGroupShareFile($fileName, $groupId, $fileId)} download files, or call {@link #deleteGroupShareFile($groupId, $fileId)} delete file.
+     * 
+     * @param  string $groupId  Group ID
+     * @param  int    $pageSize Number of groups obtained per page. This parameter is only applicable to the paging get method. 10 by default.
+     * @param  int    $pageNum  Current page number. This parameter is only applicable to the paging get method.
+     * @return array            Group file information or error
+     */
+    public function getGroupShareFiles($groupId, $pageSize = 10, $pageNum = 1)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please enter the group ID');
+        }
+
+        $pageSize = (int)$pageSize > 0 ? (int)$pageSize : 0;
+        $pageNum = (int)$pageNum > 0 ? (int)$pageNum : 1;
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/share_files';
+        $uri .= $pageSize ? ('?pagesize='.$pageSize.'&pagenum='.$pageNum) : '';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 上传群组共享文件
+     * 
+     * \details
+     * 上传指定群组 ID 的群组共享文件。注意上传的文件大小不能超过 10 MB。
+     * 
+     * @param  string $groupId  群组 ID
+     * @param  string $fileName 上传的文件路径
+     * @return array            上传的文件信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Upload group shared files
+     * 
+     * \details
+     * Upload the group shared file with the specified group ID. Note that the uploaded file size cannot exceed 10 Mb.
+     * 
+     * @param  string $groupId  Group ID
+     * @param  string $fileName Uploaded file path
+     * @return array            Uploaded file information or error
+     */
+    public function uploadGroupShareFile($groupId, $fileName)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please enter the group ID');
+        }
+
+        if (!trim($fileName)) {
+            \Easemob\exception('Please pass in the attachment name');
+        }
+        
+        $file = fopen($fileName, 'rb');
+        if ($file === false) {
+            \Easemob\exception('The attachment cannot be read');
+        }
+
+        $stat = fstat($file);
+        $size = $stat['size'];
+        $data = fread($file, $size);
+        fclose($file);
+        $mimeType = mime_content_type($fileName) ? mime_content_type($fileName) : null;
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/share_files';
+        $resp = Http::multipartPost($uri, $fileName, $data, $mimeType, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 下载群组共享文件
+     * 
+     * \details
+     * 根据指定的群组 ID 与 file_id 下载群组共享文件，file_id 通过 {@link #getGroupShareFiles($groupId, $pageSize = 10, $pageNum = 1)} 获取。
+     * 
+     * @param  string  $fileName 要下载的文件路径
+     * @param  string  $groupId  群组 ID
+     * @param  string  $fileId   群组共享文件 id
+     * @return int|array         文件大小或者错误
+     * 
+     * \~english
+     * \brief
+     * Download group shared files
+     * 
+     * \details
+     * According to the specified group ID and file_id download group shared file, file_id is obtained through {@link #getGroupShareFiles($groupId, $pageSize = 10, $pageNum = 1)}.
+     * 
+     * @param  string  $fileName File path to download
+     * @param  string  $groupId  Group ID
+     * @param  string  $fileId   file_id
+     * @return int|array         File size or error
+     */
+    public function downloadGroupShareFile($fileName, $groupId, $fileId)
+    {
+        if (!trim($fileName) || !trim($fileId) || !trim($fileId)) {
+            \Easemob\exception('Please enter the file path, group ID and group shared file ID to download');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/share_files/' . $fileId;
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $dir = dirname($fileName);
+        if (!file_exists($dir)) {
+            mkdir($dir, 0755, true);
+        }
+        return file_put_contents($fileName, $resp->body);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 删除群组共享文件
+     * 
+     * \details
+     * 根据指定的群组 ID 与 file_id 删除群组共享文件，file_id 通过 {@link #getGroupShareFiles($groupId, $pageSize = 10, $pageNum = 1)} 获取。
+     * 
+     * @param  string  $groupId 群组 ID
+     * @param  string  $fileId  群组共享文件 id
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Delete group shared files
+     * 
+     * \details
+     * According to the specified group ID and file_id delete group shared file, file_id is obtained through {@link #getGroupShareFiles($groupId, $pageSize = 10, $pageNum = 1)}。
+     * 
+     * @param  string  $groupId Group ID
+     * @param  string  $fileId  file_id
+     * @return boolean|array    Success or error
+     */
+    public function deleteGroupShareFile($groupId, $fileId)
+    {
+        if (!trim($groupId) || !trim($fileId)) {
+            \Easemob\exception('Please pass in the group ID and the group shared file ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/share_files/' . $fileId;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data']['result'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 分页获取群组成员
+     * 
+     * @param  string $groupId  群组 ID
+     * @param  int    $pageSize 每页成员数量，默认值为 10，最大为 100。
+     * @param  int    $pageNum  当前页码。默认值为 1。
+     * @return array            群组成员信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Paging get group members
+     * 
+     * @param  string $groupId  Group ID
+     * @param  int    $pageSize Number of members per page. The default value is 10 and the maximum value is 100.
+     * @param  int    $pageNum  Current page number. The default value is 1.
+     * @return array            Group member information or error
+     */
+    public function listGroupMembers($groupId, $pageSize = 10, $pageNum = 1)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please enter the group ID');
+        }
+
+        $pageSize = (int)$pageSize > 0 ? (int)$pageSize : 0;
+        $pageNum = (int)$pageNum > 0 ? (int)$pageNum : 1;
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/users';
+        $uri .= $pageSize ? ('?pagesize='.$pageSize.'&pagenum='.$pageNum) : '';
+
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取群组所有成员
+     * 
+     * @param  string $groupId 群组 ID
+     * @return array           群组成员信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get all members of the group
+     * 
+     * @param  string $groupId Group ID
+     * @return array           Group member information or error
+     */
+    public function listAllGroupMembers($groupId)
+    {
+        return $this->listGroupMembers($groupId, 0);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加单个群组成员
+     * 
+     * \details
+     * 一次给群添加一个成员，不能重复添加同一个成员。如果用户已经是群成员，将添加失败，并返回错误。
+     * 
+     * @param  string  $groupId  群组 ID
+     * @param  string  $username 环信用户 ID
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add individual group members
+     * 
+     * \details
+     * Add one member to the group at a time. You cannot add the same member repeatedly. If the user is already a member of the group, the addition fails with an error.
+     * 
+     * @param  string  $groupId  Group ID
+     * @param  string  $username User name
+     * @return boolean|array     Success or error
+     */
+    public function addGroupMember($groupId, $username)
+    {
+        return $this->addUsers($groupId, $username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量添加群组成员
+     * 
+     * \details
+     * 为群组添加多个成员，一次最多可以添加 60 位成员。如果所有用户均已是群成员，将添加失败，并返回错误。
+     * 
+     * @param  string  $groupId   群组 ID
+     * @param  array   $usernames 环信用户 ID 数组
+     * @return boolean|array      成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch add group members
+     * 
+     * \details
+     * Add multiple members to the group. You can add up to 60 members at a time. If all users are already members of the group, the addition fails with an error.
+     * 
+     * @param  string  $groupId   Group ID
+     * @param  array   $usernames User name
+     * @return boolean|array      Success or error
+     */
+    public function addGroupMembers($groupId, $usernames)
+    {
+        return $this->addUsers($groupId, $usernames);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 移除单个群组成员
+     * 
+     * \details
+     * 从群中移除某个成员。如果被移除用户不是群成员，将移除失败，并返回错误。
+     * 
+     * @param  string  $groupId   群组 ID
+     * @param  string  $username  环信用户 ID
+     * @return boolean|array      成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove individual group members
+     * 
+     * \details
+     * Remove a member from the group. If the removed user is not a member of the group, the removal fails with an error.
+     * 
+     * @param  string  $groupId   Group ID
+     * @param  string  $username  User name
+     * @return boolean|array      Success or error
+     */
+    public function removeGroupMember($groupId, $username)
+    {
+        return $this->removeUsers($groupId, $username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量移除群组成员
+     * 
+     * \details
+     * 移除群成员，用户名之间用英文逗号分隔。建议一次最多移除 60 个群成员。如果所有被移除用户均不是群成员，将移除失败，并返回错误。
+     * 
+     * @param  string  $groupId   群组 ID
+     * @param  array   $username  环信用户 ID 数组
+     * @return boolean|array      成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch remove group members
+     * 
+     * \details
+     * Remove group members and separate user names with English commas. It is recommended to remove up to 60 group members at a time. If all the removed users are not members of the group, the removal fails with an error.
+     * 
+     * @param  string  $groupId   Group ID
+     * @param  array   $username  User name array
+     * @return boolean|array      Success or error
+     */
+    public function removeGroupMembers($groupId, $usernames)
+    {
+        return $this->removeUsers($groupId, $usernames);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取群管理员列表
+     * 
+     * @param  string $groupId 群组 ID
+     * @return array           群管理员信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the list of group administrators
+     * 
+     * @param  string $groupId Group ID
+     * @return array           Group administrator information or error
+     */
+    public function listGroupAdmins($groupId)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please enter the group ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/admin';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加群管理员
+     * 
+     * \details
+     * 将一个群成员角色权限提升为群管理员。
+     * 
+     * @param  string  $groupId  群组 ID
+     * @param  string  $newadmin 添加的新管理员用户 ID
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add group administrator
+     * 
+     * \details
+     * Promote the role permission of a group member to group administrator.
+     * 
+     * @param  string  $groupId  Group ID
+     * @param  string  $newadmin User name
+     * @return boolean|array     Success or error
+     */
+    public function addGroupAdmin($groupId, $newadmin)
+    {
+        if (!trim($groupId) || !trim($newadmin)) {
+            \Easemob\exception('Please pass in the group ID and the new administrator user ID to be added');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/admin';
+        $body = compact('newadmin');
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 移除群管理员
+     * 
+     * \details
+     * 将用户的角色从群管理员降为群普通成员。
+     * 
+     * @param  string  $groupId  群组 ID
+     * @param  string  $oldadmin 移除的管理员用户 ID
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove group administrator
+     * 
+     * \details
+     * Reduce the user's role from group administrator to ordinary member of the group.
+     * 
+     * @param  string  $groupId  Group ID
+     * @param  string  $oldadmin User name
+     * @return boolean|array     Success or error
+     */
+    public function removeGroupAdmin($groupId, $oldadmin)
+    {
+        if (!trim($groupId) || !trim($oldadmin)) {
+            \Easemob\exception('Please pass in the group ID and the administrator user ID to be removed');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/admin/' . $oldadmin;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data']['result'] === 'success' ? true : false;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 转让群组
+     * 
+     * \details
+     * 修改群主为同一群组中的其他成员。
+     * 
+     * @param  string  $groupId  群组 ID
+     * @param  string  $newowner 群组的新管理员用户 ID
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Transfer group
+     * 
+     * \details
+     * Modify the group owner to other members in the same group.
+     * 
+     * @param  string  $groupId  Group ID
+     * @param  string  $newowner User name
+     * @return boolean|array     Success or error
+     */
+    public function updateGroupOwner($groupId, $newowner)
+    {
+        if (!trim($groupId) || !trim($newowner)) {
+            \Easemob\exception('Please pass in the group ID and the new administrator user ID of the group');
+        }
+
+        $uri = $this->auth->getBaseUri(). '/chatgroups/' . $groupId;
+        $body = compact('newowner');
+        $resp = Http::put($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore 创建群组
+     * @param  array $data  群组信息
+     * @return string|array 群组 id 或者错误
+     */
+    private function create($data)
+    {
+        $data['groupname'] = trim($data['groupname']);
+        $data['desc'] = trim($data['desc']);
+        $data['owner'] = trim($data['owner']);
+
+        if (!isset($data['groupname']) || !$data['groupname']) {
+            \Easemob\exception('Please pass the group name');
+        }
+
+        if (!isset($data['desc']) || !$data['desc']) {
+            \Easemob\exception('Please pass the group description');
+        }
+
+        if (!isset($data['owner']) || !$data['owner']) {
+            \Easemob\exception('Please pass the administrator of the group');
+        }
+
+        if (isset($data['members'])) {
+            if (!is_array($data['members']) || empty($data['members'])) {
+                \Easemob\exception('Please pass in group members. Group members must be arrays');
+            } elseif (count($data['members']) > 100) {
+                \Easemob\exception('Group members cannot exceed 100');
+            } elseif (in_array($data['owner'], $data['members'])) {
+                \Easemob\exception('The group leader does not need to be included in the group members');
+            }
+        }
+
+        $data['public'] = (boolean)$data['public'];
+        $data['maxusers'] = isset($data['maxusers']) && (int)$data['maxusers'] ? (int)$data['maxusers'] : 200;
+        // 如果是公开群（public 为 true），则不允许群成员邀请别人加入此群
+        $data['allowinvites'] = (boolean)$data['allowinvites'];
+        // 如果允许了群成员邀请用户进群（allowinvites为true），那么就不需要群主或群管理员审批了
+        $data['members_only'] = (boolean)$data['members_only'];
+        $data['custom'] = trim($data['custom']);
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups';
+        $resp = Http::post($uri, $data, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return isset($data['data']['groupid']) ? $data['data']['groupid'] : $data['data'];
+    }
+
+    /**
+     * @ignore （批量）添加群组成员
+     * @param  string       $groupId   群组 ID
+     * @param  string|array $usernames 环信用户 ID，string: 添加单个群组成员；array: 批量添加群组成员
+     * @return boolean|array           成功或者错误
+     */
+    private function addUsers($groupId, $usernames)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if ((is_array($usernames) && empty($usernames)) || (is_string($usernames) && !trim($usernames))) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/users';
+        $uri .= is_array($usernames) ? '' : ('/' . $usernames);
+        $body = is_array($usernames) ? compact('usernames') : null;
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore（批量）移除群组成员
+     * @param  string       $groupId   群组 ID
+     * @param  string|array $usernames 环信用户 ID，string: 移除单个群组成员；array: 批量移除群组成员
+     * @return boolean|array           成功或者错误
+     */
+    private function removeUsers($groupId, $usernames)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if ((is_array($usernames) && empty($usernames)) || (is_string($usernames) && !trim($usernames))) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/users/';
+        $uri .= is_array($usernames) ? implode(',', $usernames) : $usernames;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+}

vendor/maniac/easemob-php/src/Http/Http.php

@@ -0,0 +1,234 @@
+<?php
+namespace Easemob\Http;
+
+/**
+ * Http 请求类
+ * @final
+ */
+final class Http
+{
+    /**
+     * @var string $proxyIp 代理 ip
+     */
+    public static $proxyIp;
+
+    /**
+     * @var string $proxyPort 代理端口
+     */
+    public static $proxyPort;
+
+    /**
+     * @var string $proxyUser 代理用户名
+     */
+    public static $proxyUser;
+
+    /**
+     * @var string $proxyUser 代理密码
+     */
+    public static $proxyPass;
+
+    /**
+     * 设置代理信息
+     * @param string $proxyIp   代理 ip
+     * @param int    $proxyPort 代理端口
+     * @param string $proxyUser 代理用户名
+     * @param string $proxyPass 代理密码
+     * @example
+     * <pre>
+     * \Easemob\Http\Http::setProxy("ip", 8080);
+     * </pre>
+     */
+    public static function setProxy($proxyIp, $proxyPort = 80, $proxyUser = '', $proxyPass = '')
+    {
+        self::$proxyIp = $proxyIp;
+        self::$proxyPort = $proxyPort;
+        self::$proxyUser = $proxyUser;
+        self::$proxyPass = $proxyPass;
+    }
+
+    /**
+     * @ignore 发送 get 请求
+     * @param  string   $uri     请求 uri
+     * @param  mixed    $headers 请求头
+     * @return Response          响应对象
+     */
+    public static function get($uri, $headers = null)
+    {
+        return self::send(new Request('GET', $uri, $headers));
+    }
+
+    /**
+     * @ignore 发送 post 请求
+     * @param  string   $uri     请求 uri
+     * @param  mixed    $body    请求体
+     * @param  mixed    $headers 请求头
+     * @return Response          响应对象
+     */
+    public static function post($uri, $body, $headers = null)
+    {
+        return self::send(new Request('POST', $uri, $headers, $body));
+    }
+
+    /**
+     * @ignore 发送 put 请求
+     * @param  string   $uri     请求 uri
+     * @param  mixed    $body    请求体
+     * @param  mixed    $headers 请求头
+     * @return Response          响应对象
+     */
+    public static function put($uri, $body, $headers = null)
+    {
+        return self::send(new Request('PUT', $uri, $headers, $body));
+    }
+
+    /**
+     * @ignore 发送 delete 请求
+     * @param  string   $uri     请求 uri
+     * @param  mixed    $headers 请求头
+     * @return Response          响应对象
+     */
+    public static function delete($uri, $body, $headers = null)
+    {
+        return self::send(new Request('DELETE', $uri, $headers, $body));
+    }
+
+    /**
+     * @ignore 发送 http 请求
+     * @param  Request $request 请求信息
+     * @return Response         响应对象
+     */
+    public static function send($request)
+    {
+        $startTime = microtime(true);
+        $ch = curl_init();
+        $options = array(
+            CURLOPT_RETURNTRANSFER => true,     // 将 curl_exec() 获取的信息以字符串返回，而不是直接输出。
+            CURLOPT_SSL_VERIFYPEER => false,    // 禁止 cURL 验证证书
+            CURLOPT_SSL_VERIFYHOST => false,    // 不检查服务器SSL证书名称
+            CURLOPT_HEADER => true,             // 将头文件的信息作为数据流输出
+            CURLOPT_NOBODY => false,            // true 时将不输出 BODY 部分。同时 Mehtod 变成了 HEAD。修改为 false 时不会变成 GET。
+            CURLOPT_CUSTOMREQUEST => $request->method,  // 请求方法
+            CURLOPT_URL => $request->uri,   // 请求地址
+            CURLOPT_USERAGENT => 'EasemobServerSDK-PHP/' . PHP_VERSION,
+        );
+
+        if (!empty($request->headers)) {
+            if (!isset($request->headers['Content-Type']) || !$request->headers['Content-Type']) {
+                $request->headers['Content-Type'] = (!$request->body || is_array($request->body)) ? 'application/json' : 'application/x-www-form-urlencoded';
+            }
+            $options[CURLOPT_HTTPHEADER] = self::buildHeaders($request->headers);
+        }
+
+        if (!empty($request->body)) {
+            $request->body = is_array($request->body) ? json_encode($request->body) : $request->body;
+            $options[CURLOPT_POSTFIELDS] = $request->body;
+        }
+
+        if (self::$proxyIp && self::$proxyPort) {
+            $options[CURLOPT_PROXY] = self::$proxyIp;
+            $options[CURLOPT_PROXYPORT] = self::$proxyPort;
+            if (self::$proxyUser && self::$proxyPass) {
+                $options[CURLOPT_PROXYUSERPWD] = self::$proxyUser .':'. self::$proxyPass;
+            }
+        }
+
+        curl_setopt_array($ch, $options);
+        $result = curl_exec($ch);
+        $endTime = microtime(true);
+        $duration = $endTime - $startTime;
+        $code = curl_errno($ch);
+        if ($code !== 0) {
+            $response = new Response(-1, $duration, null, null, curl_error($ch));
+            curl_close($ch);
+            return $response;
+        }
+
+        $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+        $headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
+        $headers = self::parseHeaders(substr($result, 0, $headerSize));
+        $body = substr($result, $headerSize);
+        curl_close($ch);
+        return new Response($code, $duration, $headers, $body, null);
+    }
+
+    /**
+     * @ignore 发送上传附件请求
+     * @param  string   $uri      请求 uri
+     * @param  string   $fileName 附件名
+     * @param  array    $fileBody 附件信息
+     * @param  mixed    $mimeType 附件 mime 类型
+     * @param  array    $headers  请求头
+     * @return Response           响应对象
+     */
+    public static function multipartPost(
+        $uri,
+        $fileName,
+        $fileBody,
+        $mimeType = null,
+        $headers = array()
+    ) {
+        $data = array();
+        $mimeBoundary = md5(microtime());
+        array_push($data, '--' . $mimeBoundary);
+        $finalMimeType = empty($mimeType) ? 'application/octet-stream' : $mimeType;
+        $finalFileName = self::escapeQuotes($fileName);
+        array_push($data, "Content-Disposition: form-data; name=\"file\"; filename=\"$finalFileName\"");
+        array_push($data, "Content-Type: $finalMimeType");
+        array_push($data, '');
+        array_push($data, $fileBody);
+
+        array_push($data, '--' . $mimeBoundary . '--');
+        array_push($data, '');
+
+        $body = implode("\r\n", $data);
+        $contentType = 'multipart/form-data; boundary=' . $mimeBoundary;
+        $headers['Content-Type'] = $contentType;
+        $headers['restrict-access'] = true;
+
+        return self::send(new Request('POST', $uri, $headers, $body));
+    }
+
+    /**
+     * @ignore 构造请求头信息
+     * @param  array $headers 请求头信息
+     * @return array          请求头信息
+     */
+    private static function buildHeaders($headers)
+    {
+        $headersArr = array();
+        foreach ($headers as $key => $value) {
+            array_push($headersArr, "{$key}: {$value}");
+        }
+        return $headersArr;
+    }
+
+    /**
+     * @ignore 解析请求头信息
+     * @param  string $headersRaw 请求头原始字符串
+     * @return array              请求头信息
+     */
+    private static function parseHeaders($headersRaw)
+    {
+        $headers = array();
+        $lines = explode("\r\n", $headersRaw);
+        foreach ($lines as $line) {
+            $item = explode(':', $line);
+            if (trim($item[0])) {
+                $headers[$item[0]] = isset($item[1]) ? trim($item[1]) : '';
+            }
+        }
+        return $headers;
+    }
+
+    /**
+     * @ignore 替换引号
+     * @param  string $str 原始字符串
+     * @return string      替换之后的字符串
+     */
+    private static function escapeQuotes($str)
+    {
+        $find = array("\\", "\"");
+        $replace = array("\\\\", "\\\"");
+        return str_replace($find, $replace, $str);
+    }
+}

vendor/maniac/easemob-php/src/Http/Request.php

@@ -0,0 +1,44 @@
+<?php
+namespace Easemob\Http;
+
+/**
+ * @ignore 请求体类
+ * @final
+ */
+final class Request
+{
+    /**
+     * @var string $uri 请求 uri
+     */    
+    public $uri;
+    
+    /**
+     * @var string $method 请求方法
+     */  
+    public $method;
+    
+    /**
+     * @var mixed $headers 请求头
+     */  
+    public $headers;
+    
+    /**
+     * @var mixed $headers 请求体
+     */  
+    public $body;
+
+    /**
+     * 构造方法
+     * @param string $method  请求方法
+     * @param string $uri     请求 uri
+     * @param mixed  $headers 请求头
+     * @param mixed  $body    请求体
+     */
+    public function __construct($method, $uri, $headers = null, $body = null)
+    {
+        $this->method = strtoupper($method);
+        $this->uri = $uri;
+        $this->headers = $headers;
+        $this->body = $body;
+    }
+}

vendor/maniac/easemob-php/src/Http/Response.php

@@ -0,0 +1,108 @@
+<?php
+namespace Easemob\Http;
+
+/**
+ * @ignore 响应体类
+ * @final
+ */
+final class Response
+{
+    /**
+     * @var int $httpCode http 状态码
+     */
+    public $httpCode;
+    
+    /**
+     * @var number $duration 响应时长
+     */
+    public $duration;
+    
+    /**
+     * @var mixed $headers 响应头
+     */
+    public $headers;
+    
+    /**
+     * @var mixed $body 响应体
+     */
+    public $body;
+    
+    /**
+     * @var mixed $error 错误信息
+     */
+    public $error;
+    
+    /**
+     * @var mixed $data 响应数据
+     */
+    private $data;
+    
+    /**
+     * @var array $statusText 状态码对应信息
+     */
+    private static $statusText = array(
+        400 => 'Bad Request',
+        401 => 'Unauthorized',
+        403 => 'Forbidden',
+        404 => 'Not Found',
+        405 => 'Method Not Allowed',
+        408 => 'Request Timeout',
+        413 => 'Request Entity Too Large',
+        415 => 'Unsupported Media Type',
+        429 => 'Too Many Requests',
+        500 => 'Internal Server Error',
+        501 => 'Not Implemented',
+        502 => 'Bad Gateway',
+        503 => 'Service Unavailable',
+        504 => 'Gateway Timeout',
+    );
+
+    /**
+     * 构造方法
+     * @param int    $httpCode 状态码
+     * @param double $duration 执行时间
+     * @param mixed  $headers  响应头
+     * @param mixed  $body     响应体
+     * @param mixed  $error    错误信息
+     */
+    public function __construct($httpCode, $duration, $headers = null, $body = null, $error = null)
+    {
+        $this->httpCode = $httpCode;
+        $this->duration = $duration;
+        $this->headers = $headers;
+        $this->body = $body;
+
+        if ($error !== null) {
+            return;
+        }
+
+        if ($body !== null) {
+            $this->data = json_decode($body, true);
+            $error = isset($this->data['error']) && $this->data['error'] ? $this->data['error'] : $error;
+        }
+
+        if ($error === null) {
+            $error = isset(self::$statusText[$httpCode]) ? self::$statusText[$httpCode] : $error;
+        }
+        
+        $this->error = $error;
+    }
+
+    /**
+     * 查看请求是否成功
+     * @return boolean 请求是否成功
+     */
+    public function ok()
+    {
+        return $this->httpCode >= 200 && $this->httpCode < 300 && $this->error == null;
+    }
+
+    /**
+     * 获取响应数据
+     * @return array 响应数据
+     */
+    public function data()
+    {
+        return $this->data;
+    }
+}

vendor/maniac/easemob-php/src/Message.php

@@ -0,0 +1,630 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * Message 用来发送消息
+ * 
+ * \~english
+ * The `Message` is used to send message
+ */
+final class Message
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 发送文本消息
+     * 
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 [‘u1’]；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  array   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     * 
+     * \~english
+     * \brief
+     * Send text message
+     * 
+     * @param  string  $target_type Type of target to send; Users: send messages to users, chatgroups: send messages to groups, chatrooms: send messages to chat rooms
+     * @param  array   $target      Target of transmission; Note that you need to use the array here. The maximum number of users added in the array is 600 by default. Even if there is only one user, you should also use the array ['u1 ']; When sending to the user, the array element is the user name. When sending to the group, the array element is the groupid.
+     * @param  array   $message     Message content
+     * @param  string  $from        Indicates the sender of the message; Without this field, the server will default to "from": "admin". When there is a from field but the value is an empty string (""), the request fails
+     * @param  string  $sync_device Whether to synchronize the message to the sender after the message is sent successfully. True: Yes; False (default): No.
+     * @param  boolean $isOnline    When the parameter value is true, the value representing routetype is "route_online", which means that the message is delivered only when the receiver is online. If the receiver is offline, it will not receive this message.
+     * @return array                The array or error of the target and corresponding message ID sent to
+     */
+    public function text($target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        return $this->send('txt', $target_type, $target, $message, $from, $sync_device, $isOnline);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 发送图片消息
+     * 
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 [‘u1’]；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  array   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     * 
+     * \~english
+     * \brief
+     * Send picture message
+     * 
+     * @param  string  $target_type Type of target to send; Users: send messages to users, chatgroups: send messages to groups, chatrooms: send messages to chat rooms
+     * @param  array   $target      Target of transmission; Note that you need to use the array here. The maximum number of users added in the array is 600 by default. Even if there is only one user, you should also use the array ['u1 ']; When sending to the user, the array element is the user name. When sending to the group, the array element is the groupid.
+     * @param  array   $message     Message content
+     * @param  string  $from        Indicates the sender of the message; Without this field, the server will default to "from": "admin". When there is a from field but the value is an empty string (""), the request fails
+     * @param  string  $sync_device Whether to synchronize the message to the sender after the message is sent successfully. True: Yes; False (default): No.
+     * @param  boolean $isOnline    When the parameter value is true, the value representing routetype is "route_online", which means that the message is delivered only when the receiver is online. If the receiver is offline, it will not receive this message.
+     * @return array                The array or error of the target and corresponding message ID sent to
+     */
+    public function image($target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        return $this->send('img', $target_type, $target, $message, $from, $sync_device, $isOnline);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 发送语音消息
+     * 
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 [‘u1’]；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  array   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     * 
+     * \~english
+     * \brief
+     * Send voice message
+     * 
+     * @param  string  $target_type Type of target to send; Users: send messages to users, chatgroups: send messages to groups, chatrooms: send messages to chat rooms
+     * @param  array   $target      Target of transmission; Note that you need to use the array here. The maximum number of users added in the array is 600 by default. Even if there is only one user, you should also use the array ['u1 ']; When sending to the user, the array element is the user name. When sending to the group, the array element is the groupid.
+     * @param  array   $message     Message content
+     * @param  string  $from        Indicates the sender of the message; Without this field, the server will default to "from": "admin". When there is a from field but the value is an empty string (""), the request fails
+     * @param  string  $sync_device Whether to synchronize the message to the sender after the message is sent successfully. True: Yes; False (default): No.
+     * @param  boolean $isOnline    When the parameter value is true, the value representing routetype is "route_online", which means that the message is delivered only when the receiver is online. If the receiver is offline, it will not receive this message.
+     * @return array                The array or error of the target and corresponding message ID sent to
+     */
+    public function audio($target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        return $this->send('audio', $target_type, $target, $message, $from, $sync_device, $isOnline);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 发送视频消息
+     * 
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 [‘u1’]；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  array   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     * 
+     * \~english
+     * \brief
+     * Send video message
+     * 
+     * @param  string  $target_type Type of target to send; Users: send messages to users, chatgroups: send messages to groups, chatrooms: send messages to chat rooms
+     * @param  array   $target      Target of transmission; Note that you need to use the array here. The maximum number of users added in the array is 600 by default. Even if there is only one user, you should also use the array ['u1 ']; When sending to the user, the array element is the user name. When sending to the group, the array element is the groupid.
+     * @param  array   $message     Message content
+     * @param  string  $from        Indicates the sender of the message; Without this field, the server will default to "from": "admin". When there is a from field but the value is an empty string (""), the request fails
+     * @param  string  $sync_device Whether to synchronize the message to the sender after the message is sent successfully. True: Yes; False (default): No.
+     * @param  boolean $isOnline    When the parameter value is true, the value representing routetype is "route_online", which means that the message is delivered only when the receiver is online. If the receiver is offline, it will not receive this message.
+     * @return array                The array or error of the target and corresponding message ID sent to
+     */
+    public function video($target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        return $this->send('video', $target_type, $target, $message, $from, $sync_device, $isOnline);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 发送文件消息
+     * 
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 [‘u1’]；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  array   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     * 
+     * \~english
+     * \brief
+     * Send file message
+     * 
+     * @param  string  $target_type Type of target to send; Users: send messages to users, chatgroups: send messages to groups, chatrooms: send messages to chat rooms
+     * @param  array   $target      Target of transmission; Note that you need to use the array here. The maximum number of users added in the array is 600 by default. Even if there is only one user, you should also use the array ['u1 ']; When sending to the user, the array element is the user name. When sending to the group, the array element is the groupid.
+     * @param  array   $message     Message content
+     * @param  string  $from        Indicates the sender of the message; Without this field, the server will default to "from": "admin". When there is a from field but the value is an empty string (""), the request fails
+     * @param  string  $sync_device Whether to synchronize the message to the sender after the message is sent successfully. True: Yes; False (default): No.
+     * @param  boolean $isOnline    When the parameter value is true, the value representing routetype is "route_online", which means that the message is delivered only when the receiver is online. If the receiver is offline, it will not receive this message.
+     * @return array                The array or error of the target and corresponding message ID sent to
+     */
+    public function file($target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        return $this->send('file', $target_type, $target, $message, $from, $sync_device, $isOnline);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 发送位置消息
+     * 
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 [‘u1’]；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  array   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     * 
+     * \~english
+     * \brief
+     * Send location message
+     * 
+     * @param  string  $target_type Type of target to send; Users: send messages to users, chatgroups: send messages to groups, chatrooms: send messages to chat rooms
+     * @param  array   $target      Target of transmission; Note that you need to use the array here. The maximum number of users added in the array is 600 by default. Even if there is only one user, you should also use the array ['u1 ']; When sending to the user, the array element is the user name. When sending to the group, the array element is the groupid.
+     * @param  array   $message     Message content
+     * @param  string  $from        Indicates the sender of the message; Without this field, the server will default to "from": "admin". When there is a from field but the value is an empty string (""), the request fails
+     * @param  string  $sync_device Whether to synchronize the message to the sender after the message is sent successfully. True: Yes; False (default): No.
+     * @param  boolean $isOnline    When the parameter value is true, the value representing routetype is "route_online", which means that the message is delivered only when the receiver is online. If the receiver is offline, it will not receive this message.
+     * @return array                The array or error of the target and corresponding message ID sent to
+     */
+    public function location($target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        return $this->send('loc', $target_type, $target, $message, $from, $sync_device, $isOnline);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 发送透传消息
+     * 
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 [‘u1’]；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  array   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     * 
+     * \~english
+     * \brief
+     * Send transparent message
+     * 
+     * @param  string  $target_type Type of target to send; Users: send messages to users, chatgroups: send messages to groups, chatrooms: send messages to chat rooms
+     * @param  array   $target      Target of transmission; Note that you need to use the array here. The maximum number of users added in the array is 600 by default. Even if there is only one user, you should also use the array ['u1 ']; When sending to the user, the array element is the user name. When sending to the group, the array element is the groupid.
+     * @param  array   $message     Message content
+     * @param  string  $from        Indicates the sender of the message; Without this field, the server will default to "from": "admin". When there is a from field but the value is an empty string (""), the request fails
+     * @param  string  $sync_device Whether to synchronize the message to the sender after the message is sent successfully. True: Yes; False (default): No.
+     * @param  boolean $isOnline    When the parameter value is true, the value representing routetype is "route_online", which means that the message is delivered only when the receiver is online. If the receiver is offline, it will not receive this message.
+     * @return array                The array or error of the target and corresponding message ID sent to
+     */
+    public function cmd($target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        return $this->send('cmd', $target_type, $target, $message, $from, $sync_device, $isOnline);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 发送自定义消息
+     * 
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 [‘u1’]；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  array   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     * 
+     * \~english
+     * \brief
+     * Send custom message
+     * 
+     * @param  string  $target_type Type of target to send; Users: send messages to users, chatgroups: send messages to groups, chatrooms: send messages to chat rooms
+     * @param  array   $target      Target of transmission; Note that you need to use the array here. The maximum number of users added in the array is 600 by default. Even if there is only one user, you should also use the array ['u1 ']; When sending to the user, the array element is the user name. When sending to the group, the array element is the groupid.
+     * @param  array   $message     Message content
+     * @param  string  $from        Indicates the sender of the message; Without this field, the server will default to "from": "admin". When there is a from field but the value is an empty string (""), the request fails
+     * @param  string  $sync_device Whether to synchronize the message to the sender after the message is sent successfully. True: Yes; False (default): No.
+     * @param  boolean $isOnline    When the parameter value is true, the value representing routetype is "route_online", which means that the message is delivered only when the receiver is online. If the receiver is offline, it will not receive this message.
+     * @return array                The array or error of the target and corresponding message ID sent to
+     */
+    public function custom($target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        return $this->send('custom', $target_type, $target, $message, $from, $sync_device, $isOnline);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取用户离线消息数
+     * 
+     * @param  string $username 用户名
+     * @return int|array        用户离线消息数量或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the number of user offline messages
+     * 
+     * @param  string $username User name
+     * @return int|array        Number of offline messages or errors
+     */
+    public function countMissedMessages($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/offline_msg_count';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'][$username];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取某条离线消息状态
+     * 
+     * @param  string $username 用户名
+     * @param  string $msgId    消息 ID 编号
+     * @return string|array     离线消息状态（delivered：表示状态为消息已投递；undelivered：表示消息未投递；msg_not_found：消息不存在）或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the status of an offline message
+     * 
+     * @param  string $username User name
+     * @param  string $msgId    Message ID number
+     * @return string|array     Offline message status (delivered: indicates that the message has been delivered; undelivered: indicates that the message has not been delivered; msg_not_found: the message does not exist) or error
+     */
+    public function isMessageDeliveredToUser($username, $msgId)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+        
+        if (!trim($msgId)) {
+            \Easemob\exception('Please enter message ID');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/offline_msg_status/' . $msgId;
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'][$msgId];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取历史消息文件下载地址
+     * 
+     * \details
+     * 导出聊天记录接口不是实时接口，获取成功存在一定的延时，不能够作为实时拉取消息的接口使用。以下 API 均需要企业管理员权限才能访问。此接口一次只能获取一个小时的历史消息。
+     * 
+     * @param  int    $datetime 时间，每次只能获取一小时的消息，格式为 yyyyMMddHH 如 2018112717。
+     * @return string|array     聊天记录文件下载地址或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the download address of historical message file
+     * 
+     * \details
+     * The export chat record interface is not a real-time interface. There is a certain delay in obtaining success, so it can not be used as an interface for real-time pulling messages. The following APIs require enterprise administrator privileges to access. This interface can only get historical messages for one hour at a time.
+     * 
+     * @param  int    $datetime Time, only one hour of messages can be obtained at a time. The format is yyyymmddhh, such as 2018112717.
+     * @return string|array     Chat record file download address or error
+     */
+    public function getHistoryAsUri($dateTime)
+    {
+        $dateTime = (int)$dateTime;
+        if (!$dateTime) {
+            \Easemob\exception('Please enter the time period to get');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatmessages/' . $dateTime;
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return isset($data['data'][0]['url']) ? $data['data'][0]['url'] : $data;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 下载消息历史文件到本地
+     * 
+     * @param  int    $datetime 时间，每次只能获取一小时的消息，格式为 yyyyMMddHH 如 2018112717。
+     * @param  string $filename 下载后的文件名，消息历史文件是 gz 压缩的。
+     * @return boolean|array    下载成功或错误
+     * 
+     * \~english
+     * \brief
+     * Download message history file to local
+     * 
+     * @param  int    $datetime Time, only one hour of messages can be obtained at a time. The format is yyyymmddhh, such as 2018112717.
+     * @param  string $filename The downloaded file name and message history file are GZ compressed.
+     * @return boolean|array    Download success or error
+     */
+    public function getHistoryAsLocalFile($dateTime, $filename)
+    {
+        $fileurl = $this->getHistoryAsUri($dateTime);
+        return copy($fileurl, $filename);
+        // if (is_string($fileurl)) {
+        //     header("Content-Description: File Transfer");
+        //     header("Content-Type: application/octet-stream");
+        //     header("Content-Disposition: attachment;filename=".$filename);
+        //     header("Content-Transfer-Encoding: binary");
+        //     header("Expires: 0");
+        //     header("Cache-Control: must-revalidate");
+        //     header("Pragma: public");
+        //     header("Content-Length: ". filesize($fileurl));
+        //     ob_clean();
+        //     flush();
+        //     readfile($fileurl);
+        //     exit();
+        // }
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 服务端消息撤回
+     * 
+     * \details
+     * 应用管理员可调用接口撤回发送的消息，默认时限为 2 分钟，如需调整请联系环信商务经理。
+     * 
+     * @param  array $msg 要撤回的消息，一维数组代表撤回一条消息，二维数组代表撤回多条消息
+     *     - `msg_id` String 类型，撤回消息的消息 ID。
+     *     - `to` 可选，String 类型，撤回消息的接收方。如果不提供则消息体找不到就撤回不了。单聊为接收方用户名称，群组为群 ID，聊天室为聊天室 ID。
+     *     - `chat_type` String 类型，撤回消息的三种消息类型：单聊：chat；群聊：group_chat；聊天室：chatroom。
+     *     - `from` 可选，String 类型，消息撤回方，不传默认使用的是 admin，默认消息撤回方为原消息发送者。你可以通过用户 ID 指定消息撤回方。
+     *     - `force` boolean 类型，是否为强制撤回：
+     *         - true：是，即超过服务器保存消息时间消息也可以被撤回，具体见服务器消息保存时长；
+     *         - false：否，若设置的消息撤回时限超过服务端的消息保存时间，请求消息撤回时消息可能由于过期已在服务端删除，消息撤回请求会失败，即无法从收到该消息的客户端撤回该消息。
+     * @return array 撤回的消息或者错误
+     * 
+     * \~english
+     * \brief
+     * Server message withdrawal
+     * 
+     * \details
+     * The application administrator can call the interface to withdraw the sent message. The default time limit is 2 minutes. If you need to adjust, please contact the business manager of Huanxin.
+     * 
+     * @param  array $msgs For the message to be withdrawn, one-dimensional array represents withdrawing one message, and two-dimensional array represents withdrawing multiple messages
+     *     - `msg_id` String type, the message ID of the withdrawal message.
+     *     - `to` Optional, String type, The recipient of the recall message. If it is not provided, the message body cannot be found and cannot be withdrawn. The single chat is the user name of the receiver, the group is the group ID, and the chat room is the chat room ID.
+     *     - `chat_type` String type，Three message types of recall messages: single chat: chat; Group chat: Group_ chat； Chat room: chatroom.
+     *     - `from` Optional, String type，The message withdrawing party is not transmitted. By default, admin is used. By default, the message withdrawing party is the original message sender. You can specify the message withdrawing party through the user ID.
+     *     - `force` boolean type, Forced withdrawal:
+     *         - true: Yes, that is, the message can also be withdrawn after the server saves the message. See the server message saving time for details;
+     *         - false: No, if the set message withdrawal time limit exceeds the message saving time of the server, the message may have been deleted at the server due to expiration when requesting message withdrawal, and the message withdrawal request will fail, that is, the message cannot be withdrawn from the client receiving the message.
+     * @return array Withdrawn message or error
+     */
+    public function withdraw($msgs)
+    {
+        // 一维数组标识
+        $OneFlag = false;
+        if (count($msgs) == count($msgs, 1)) {
+            // 一维数组
+            $OneFlag = true;
+            $this->authMsg($msgs);
+        } else {
+            // 多维数组
+            foreach ($msgs as $msg) {
+                $this->authMsg($msg);
+            }
+        }
+
+        $body = compact('msgs');
+        $uri = $this->auth->getBaseUri() . '/messages/recall';
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return isset($data['data']['msgs']) ? $data['data']['msgs'] : $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 服务端单向删除会话
+     * 
+     * @param  string $username    用户名
+     * @param  string $channel     要删除的会话 ID。
+     * @param  string $type        会话类型。chat：单聊会话；groupchat：群聊会话。
+     * @param  string $delete_roam 是否删除服务端消息，不允许为空。true：是；false：否。
+     * @return boolean             成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Server side one-way deletion session
+     * 
+     * @param  string $username    User name
+     * @param  string $channel     Session ID to delete.
+     * @param  string $type        Session type. Chat: single chat session; Group chat: group chat conversation.
+     * @param  string $delete_roam Whether to delete the server message. It cannot be empty. True: Yes; False: No.
+     * @return boolean             Success or error
+     */
+    public function deleteSession($username, $channel, $type, $delete_roam = true)
+    {
+        if (!trim($username)) {
+            return \Easemob\exception('Please enter username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/'.$username.'/user_channel';
+        $delete_roam = (bool)$delete_roam;
+        $body = compact('channel', 'type', 'delete_roam');
+        $resp = Http::delete($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return isset($data['data']['result']) && $data['data']['result'] === 'ok' ? true : false;
+    }
+
+    /**
+     * @ignore 验证消息参数
+     * @param array $msg 消息参数
+     */
+    private function authMsg($msg)
+    {
+        if (!is_array($msg) || empty($msg)) {
+            return \Easemob\exception('Please enter a message to recall');
+        }
+
+        if (!isset($msg['msg_id']) || !trim($msg['msg_id']) || !isset($msg['chat_type']) || !trim($msg['chat_type']) || !isset($msg['force'])) {
+            return \Easemob\exception('Please enter msg_id, chat_type, force');
+        }
+    }
+
+    /**
+     * @ignore 发送消息
+     * @param  string  $type        消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息，cmd：透传消息，custom：自定义消息
+     * @param  string  $target_type 发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息
+     * @param  array   $target      发送的目标；注意这里需要用数组，数组内添加的最大用户数默认 600 个，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是 groupid。
+     * @param  mixed   $message     消息内容
+     * @param  string  $from        表示消息发送者；无此字段 Server 会默认设置为 "from": "admin"，有 from 字段但值为空串 ("") 时请求失败
+     * @param  string  $sync_device 消息发送成功后，是否将消息同步给发送方。true：是；false（默认）：否。
+     * @param  boolean $isOnline    该参数值为 true 时，代表 routetype 的值为 “ROUTE_ONLINE”，表示发送消息时只有接收方在线时，才进行消息投递。若接收方离线，将不会收到此条消息。
+     * @return array                发送给的目标和对应消息 id 的数组或者错误
+     */
+    private function send($type, $target_type, $target, $message, $from = 'admin', $sync_device = false, $isOnline = false)
+    {
+        if (!trim($type)) {
+            \Easemob\exception('Please enter type');
+        }
+
+        if (!trim($target_type)) {
+            \Easemob\exception('Please enter target_type');
+        }
+
+        if (!is_array($target) || empty($target)) {
+            \Easemob\exception('Please enter target');
+        }
+
+        if (!is_array($message)) {
+            \Easemob\exception('Please enter message');
+        }
+
+        if (!trim($from)) {
+            \Easemob\exception('If the message sender is delivered, it cannot be empty');
+        }
+
+        if (isset($message['ext'])) {
+            if (!$message['ext']) {
+                \Easemob\exception('If there is no extended attribute, please remove the EXT field');
+            } elseif (!is_array($message['ext'])) {
+                \Easemob\exception('The extended attribute, if any, must be an array');
+            }
+            $ext = $message['ext'];
+            unset($message['ext']);
+        }
+        
+        if ($type == 'txt') {
+            $msg = array('msg' => $message['msg']);
+        } else {
+            $msg = $message;
+        }
+        switch ($type) {
+            case 'txt':
+                // 文本消息
+                // $msg = array(
+                //     'msg' => $message['msg'],
+                // );
+                break;
+            case 'img': case 'audio':
+                // 图片消息 | 语音消息
+                $msg['url'] = $this->auth->getBaseUri() . '/chatfiles/' . $msg['uuid'];
+                unset($msg['uuid']);
+                break;
+            case 'video':
+                // 视频消息
+                $msg['url'] = $this->auth->getBaseUri() . '/chatfiles/' . $msg['uuid'];
+                $msg['thumb'] = $this->auth->getBaseUri() . '/chatfiles/' . $msg['thumb_uuid'];
+                unset($msg['uuid'], $msg['thumb_uuid']);
+                break;
+            case 'loc': case 'cmd':
+                // 位置消息 | 透传消息
+                break;
+            case 'custom':
+                // 自定义消息
+                if (!isset($message['customEvent']) || !preg_match('/^[a-zA-Z0-9-_\/\.]{1,32}$/', $message['customEvent'])) {
+                    \Easemob\exception('User defined event type format error');
+                }
+
+                if (isset($message['customExts']) && !is_array($message['customExts'])) {
+                    \Easemob\exception('User defined event attribute format error');
+                } elseif (isset($message['customExts'])) {
+                    if (count($message['customExts']) > 16) {
+                        \Easemob\exception('User defined event attributes can contain at most 16 elements');
+                    } else {
+                        foreach ($message['customExts'] as $key => $val) {
+                            if (!is_string($key) || !is_string($val)) {
+                                \Easemob\exception('User defined event attribute element key values can only be strings');
+                            }
+                        }
+                    }
+                }
+                break;
+        }
+
+        $msg['type'] = $type;
+        $uri = $this->auth->getBaseUri() . '/messages?useMsgId=true';
+        $body = compact('target_type', 'target', 'msg', 'from');
+        if (isset($ext)) {
+            $body['ext'] = $ext;
+        }
+
+        if ((bool)$sync_device) {
+            $body['sync_device'] = true;
+        }
+
+        if ((bool)$isOnline) {
+            $body['routetype'] = 'ROUTE_ONLINE';
+        }
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+}

vendor/maniac/easemob-php/src/Push.php

@@ -0,0 +1,179 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * Push 用来管理用户推送（设置推送免打扰等）
+ * 
+ * \~english
+ * The `Push` is used to manage user push (set push free, etc.)
+ */
+final class Push
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 设置推送昵称
+     * 
+     * \details
+     * 设置用户的推送昵称，在离线推送时使用。
+     * 
+     * @param  string  $username 用户名
+     * @param  string  $nickname 要设置的推送昵称
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Set push nickname
+     * 
+     * \details
+     * Set the user's push nickname and use it when pushing offline.
+     * 
+     * @param  string  $username User name
+     * @param  string  $nickname Nickname
+     * @return boolean|array     Success or error
+     */
+    public function updateUserNickname($username, $nickname)
+    {
+        if (!trim($username) || !trim($nickname)) {
+            \Easemob\exception('Please enter your username and nickname');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username;
+        $body = compact('nickname');
+        $resp = Http::put($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 设置推送消息展示方式
+     * 
+     * \details
+     * 设置推送消息至客户端的方式，修改后及时有效。服务端对应不同的设置，向用户发送不同展示方式的消息。
+     * 
+     * @param  string  $username                   用户名
+     * @param  int     $notification_display_style 消息提醒方式，0：仅通知；1：通知以及消息详情；
+     * @return boolean|array                       成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Set push message display method
+     * 
+     * \details
+     * Set the method of pushing messages to the client, which is timely and effective after modification. The server sends messages with different display methods to users according to different settings.
+     * 
+     * @param  string  $username                   User name
+     * @param  int     $notification_display_style Message reminder method, 0: notification only; 1: Notice and message details;
+     * @return boolean|array                       Success or error
+     */
+    public function setNotificationDisplayStyle($username, $notification_display_style = 1)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter your username');
+        }
+        $notification_display_style = (int)$notification_display_style ? 1 : 0;
+        $uri = $this->auth->getBaseUri() . '/users/' . $username;
+        $body = compact('notification_display_style');
+        $resp = Http::put($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 设置推送免打扰
+     * 
+     * \details
+     * 设置用户免打扰，在免打扰期间，用户将不会收到离线消息推送。
+     * 
+     * @param  string   $username  用户名
+     * @param  int      $startTime 免打扰起始时间，单位是小时，例如 8 代表每日 8:00 开启免打扰
+     * @param  int      $endTime   免打扰结束时间，单位是小时，例如 18 代表每日 18:00 关闭免打扰
+     * @return boolean|array       成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Set no disturb
+     * 
+     * \details
+     * Set the user to be undisturbed. During the undisturbed period, the user will not receive offline message push.
+     * 
+     * @param  string   $username  User name
+     * @param  int      $startTime The starting time of no disturbance, in hours, for example, 8 represents 8:00 every day
+     * @param  int      $endTime   The end time of no disturbance, in hours, for example, 18 means that no disturbance is closed at 18:00 every day
+     * @return boolean|array       Success or error
+     */
+    public function openNotificationNoDisturbing($username, $startTime, $endTime)
+    {
+        return $this->disturb($username, 1, $startTime, $endTime);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 取消推送免打扰
+     * 
+     * @param  string   $username  用户名
+     * @return boolean|array       成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Cancel push without interruption
+     * 
+     * @param  string   $username  User name
+     * @return boolean|array       Success or error
+     */
+    public function closeNotificationNoDisturbing($username)
+    {
+        return $this->disturb($username, 0);
+    }
+
+    /**
+     * @ignore 设置免打扰
+     * @param  string   $username                         用户名
+     * @param  int      $notification_no_disturbing       是否免打扰，0：代表免打扰关闭，1：免打扰开启
+     * @param  int      $notification_no_disturbing_start 免打扰起始时间，单位是小时，例如 8 代表每日 8:00 开启免打扰
+     * @param  int      $notification_no_disturbing_end   免打扰结束时间，单位是小时，例如 18 代表每日 18:00 关闭免打扰
+     * @return boolean|array                              成功或者错误
+     */    
+    private function disturb(
+        $username,
+        $notification_no_disturbing,
+        $notification_no_disturbing_start = 0,
+        $notification_no_disturbing_end = 0
+    ) {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter your username');
+        }
+        $notification_no_disturbing = (int)$notification_no_disturbing ? 1 : 0;
+        $uri = $this->auth->getBaseUri() . '/users/' . $username;
+        $body = compact('notification_no_disturbing', 'notification_no_disturbing_start', 'notification_no_disturbing_end');
+        $resp = Http::put($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+}

vendor/maniac/easemob-php/src/Room.php

@@ -0,0 +1,855 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * Room 用于管理聊天室
+ * 
+ * \~english
+ * The `Room` is used to manage chat rooms
+ */
+final class Room
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取 app 中所有的聊天室（分页）
+     * 
+     * @param  int    $limit  每页显示的数量，默认取 10 条
+     * @param  string $cursor 分页游标
+     * @return array          聊天室列表信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get all chat rooms in the app (paging)
+     * 
+     * @param  int    $limit  The number displayed on each page is 10 by default
+     * @param  string $cursor Paging cursor
+     * @return array          Chat room list information or error
+     */
+    public function listRooms($limit = 10, $cursor = '')
+    {
+        $limit = (int)$limit >= 0 ? (int)$limit : 10;
+        $uri = $this->auth->getBaseUri() . '/chatrooms';
+        $uri .= $limit ? '?limit=' . $limit : '';
+        $uri .= ($limit && $cursor) ? '&cursor='.$cursor : '';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return array(
+            'cursor' => isset($data['cursor']) ? $data['cursor'] : '',
+            'data' => $data['data'],
+        );
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取 app 中所有的聊天室
+     * 
+     * @return array 聊天室列表信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get all chat rooms in the app
+     * 
+     * @return array Chat room list information or error
+     */
+    public function listAllRooms()
+    {
+        $result = $this->listRooms(0);
+        return $result['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取用户加入的聊天室（分页）
+     * 
+     * \details
+     * 根据用户名称获取该用户加入的全部聊天室
+     * 
+     * @param  string $username 用户名
+     * @param  int    $pageSize 每页获取的群组数量，默认取 10 条
+     * @param  int    $pageNum  当前页码，默认取第 1 页
+     * @return array            用户加入的聊天室列表或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the chat room that the user joined (paging)
+     * 
+     * \details
+     * Get all chat rooms joined by the user according to the user name
+     * 
+     * @param  string $username User name
+     * @param  int    $pageSize The number of groups obtained per page is 10 by default
+     * @param  int    $pageNum  The current page number is page 1 by default
+     * @return array            The chat room list added by the user is incorrect
+     */
+    public function listRoomsUserJoined($username, $pageSize = 10, $pageNum = 1)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please pass the user name');
+        }
+        $pageSize = (int)$pageSize >= 0 ? (int)$pageSize : 10;
+        $pageNum = (int)$pageNum > 0 ? (int)$pageNum : 1;
+        $uri = $this->auth->getBaseUri() . '/users/' . trim($username) . '/joined_chatrooms';
+        $uri .= $pageSize ? ('?pagesize=' . $pageSize . '&pagenum=' . $pageNum) : '';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取用户加入的聊天室
+     * 
+     * \details
+     * 根据用户名称获取该用户加入的全部聊天室
+     * 
+     * @param  string $username 用户名
+     * @return array            用户加入的聊天室列表或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the chat room that the user joined
+     * 
+     * \details
+     * Get all chat rooms joined by the user according to the user name
+     * 
+     * @param  string $username User name
+     * @return array            The chat room list added by the user is incorrect
+     */
+    public function listAllRoomsUserJoined($username)
+    {
+        return $this->listRoomsUserJoined($username, 0);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取聊天室详情
+     * 
+     * \details
+     * 可以获取一个或多个聊天室的详情。当获取多个聊天室的详情时，可以直接填写多个 chatroom_id 并用 “,” 隔开，一次调用最多输入 100 个聊天室 ID，会返回所有存在的聊天室的详情，对于不存在的聊天室，response body 内返回 “chatroom id doesn’t exist”。
+     * 
+     * @param  string $roomId 聊天室 ID，多个之间用 “,” 分隔
+     * @return array          聊天室详情或者错误
+     * 
+     * \~english
+     * \brief
+     * Get chat room details
+     * 
+     * \details
+     * You can get details of one or more chat rooms. When obtaining the details of multiple chat rooms, you can directly fill in multiple chatrooms_ For all chat rooms that do not exist, enter "response ID" and return "response ID" at most once.
+     * 
+     * @param  string $roomId Chat room ID, separated by ","
+     * @return array          Chat room details or errors
+     */
+    public function getRoom($roomId)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId;
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return strpos($roomId, ',') !== false ? $data['data'] : $data['data'][0];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 创建聊天室
+     * 
+     * \details
+     * 创建一个聊天室，并设置聊天室名称、聊天室描述、公开聊天室/私有聊天室属性、聊天室成员最大人数（包括管理员）、加入公开聊天室是否需要批准、管理员、以及聊天室成员。
+     * 
+     * @param  array  $name        聊天聊天室名称
+     * @param  string $description 聊天室描述
+     * @param  string $owner       聊天室的管理员
+     * @param  array  $members     聊天室成员，此属性为可选的，但是如果加了此项，数组元素至少一个
+     * @param  int    $maxusers    聊天室成员最大数（包括聊天室所有者），值为数值类型。
+     * @return string|array        创建的聊天室 id 或者错误
+     * 
+     * \~english
+     * \brief
+     * Create a chat room
+     * 
+     * \details
+     * Create a chat room, and set the chat room name, chat room description, public chat room / private chat room properties, the maximum number of chat room members (including administrators), whether approval is required to join the public chat room, administrators, and chat room members.
+     * 
+     * @param  array  $name        Chat room name
+     * @param  string $description Chat room description
+     * @param  string $owner       Chat room administrator
+     * @param  array  $members     This attribute is optional for chat room members, but if this item is added, there must be at least one array element
+     * @param  int    $maxusers    Maximum number of chat room members (including chat room owners). The value is numeric.
+     * @return string|array        Created chat room ID or error
+     */
+    public function createRoom($name, $description, $owner, $members = array(), $maxusers = 0)
+    {
+        if (!trim($name)) {
+            \Easemob\exception('Please pass the chat room name');
+        }
+
+        if (!trim($description)) {
+            \Easemob\exception('Please pass the chat room description');
+        }
+
+        if (!trim($owner)) {
+            \Easemob\exception('Please pass the chat room administrator');
+        }
+
+        if ($members && (!is_array($members) || empty($members))) {
+            \Easemob\exception('Please pass chat room members');
+        }
+
+        $data = compact('name', 'description', 'owner', 'members');
+
+        $maxusers = (int)$maxusers > 0 ? (int)$maxusers : 0;
+        if ($maxusers) {
+            $data['maxusers'] = $maxusers;
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms';
+        $resp = Http::post($uri, $data, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data']['id'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 修改聊天室信息
+     * 
+     * \details
+     * 修改成功的数据行会返回 true，失败为 false。请求 body 只接收 name、description、maxusers 三个属性。传其他字段，或者不能修改的字段会抛异常。
+     * 
+     * @param  array   $data 聊天室信息
+     *     - `name` string 类型，聊天室名称，修改时值不能包含斜杠(“/”)。
+     *     - `description` string 类型，聊天室描述，修改时值不能包含斜杠(“/”)。
+     *     - `maxusers` int 类型，聊天室最大成员数（包括聊天室所有者），值为数值类型。
+     * @return boolean|array 成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Modify chat room information
+     * 
+     * \details
+     * The modified data row will return true, and the failure will be false. The request body only receives three attributes: name, description and maxusers. Exceptions will be thrown if other fields are passed or fields that cannot be modified.
+     * 
+     * @param  array   $data Chat room information
+     *     - `name` String type, chat room name. The value cannot contain slash ("/") when modified.
+     *     - `description` String type, chat room description. When modifying, the value cannot contain slash ("/").
+     *     - `maxusers` The type of chat room is int, and the value is the maximum number of chat room owners.
+     * @return boolean|array Success or error
+     */
+    public function updateRoom($data)
+    {
+        if (!is_array($data) || empty($data)) {
+            \Easemob\exception('Please pass the chat room information');
+        }
+
+        if (!isset($data['room_id']) || !trim($data['room_id'])) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if (isset($data['name']) && preg_match('/\//', $data['name'])) {
+            \Easemob\exception('Chat room names cannot contain slashes ("/")');
+        }
+
+        if (isset($data['description']) && preg_match('/\//', $data['description'])) {
+            \Easemob\exception('Chat room description cannot contain slashes ("/")');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $data['room_id'];
+        unset($data['room_id']);
+        if (isset($data['maxusers'])) {
+            $data['maxusers'] = (int)$data['maxusers'];
+        }
+        $resp = Http::put($uri, $data, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 删除聊天室
+     * 
+     * \details
+     * 删除单个聊天室。如果被删除的聊天室不存在，会返回错误。
+     * 
+     * @param  string  $roomId 聊天室 ID
+     * @return boolean|array   成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Delete chat room
+     * 
+     * \details
+     * Delete a single chat room. If the deleted chat room does not exist, an error will be returned.
+     * 
+     * @param  string  $roomId Chat room ID
+     * @return boolean|array   Success or error
+     */
+    public function destroyRoom($roomId)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取聊天室公告
+     * 
+     * \details
+     * 获取指定聊天室 ID 的聊天室公告。
+     * 
+     * @param  string $roomId 聊天室 id
+     * @return array          公告信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get chat announcements
+     * 
+     * \details
+     * Gets the chat announcement of the specified chat room ID.
+     * 
+     * @param  string $roomId Chat room ID
+     * @return array           Announcement information or error
+     */
+    public function getRoomAnnouncement($roomId)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/'. $roomId . '/announcement';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 修改聊天室公告
+     * 
+     * \details
+     * 修改指定聊天室 ID 的聊天室公告。聊天室公告内容不能超过 512 个字符。
+     * @param  string  $roomId       聊天室 ID
+     * @param  string  $announcement 聊天室公告内容
+     * @return boolean|array         成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Modify chat announcement
+     * 
+     * \details
+     * Modify the chat announcement of the specified chat ID. The content of chat room announcement cannot exceed 512 characters.
+     * @param  string  $roomId       Chat room ID
+     * @param  string  $announcement Chat room announcement content
+     * @return boolean|array         Success or error
+     */
+    public function updateRoomAnnouncement($roomId, $announcement)
+    {
+        if (!trim($roomId) || !trim($announcement)) {
+            \Easemob\exception('Please pass the chat room ID and announcement content');
+        }
+
+        if (mb_strlen($announcement) > 512) {
+            \Easemob\exception('The content of the announcement room cannot exceed 512 characters');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/announcement';
+        $body = compact('announcement');
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data']['result'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 分页获取聊天室成员
+     * 
+     * @param  string $roomId   聊天室 ID
+     * @param  int    $pageSize 每页获取的群组数量，默认取 10 条
+     * @param  int    $pageNum  当前页码，默认取第 1 页
+     * @return array            聊天室成员信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Paging to get chat room members
+     * 
+     * @param  string $roomId   Chat room ID
+     * @param  int    $pageSize The number of groups obtained per page is 10 by default
+     * @param  int    $pageNum  The current page number is page 1 by default
+     * @return array            Chat room member information or error
+     */
+    public function listRoomMembers($roomId, $pageSize = 10, $pageNum = 1)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $pageSize = (int)$pageSize >= 0 ? (int)$pageSize : 10;
+        $pageNum = (int)$pageNum > 0 ? (int)$pageNum : 1;
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/users';
+        $uri .= $pageSize ? ('?pagesize=' . $pageSize . '&pagenum=' . $pageNum) : '';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取聊天室所有成员
+     * 
+     * @param  string $roomId 聊天室 ID
+     * @return array          聊天室成员信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get all members of the chat room
+     * 
+     * @param  string $roomId Chat room ID
+     * @return array          Chat room member information or error
+     */
+    public function listRoomMembersAll($roomId)
+    {
+        return $this->listRoomMembers($roomId, 0);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加单个聊天室成员
+     * 
+     * \details
+     * 一次给聊天室添加一个成员，不能重复添加同一个成员。如果用户已经是聊天室成员，将添加失败，并返回错误。
+     * 
+     * @param  string $roomId   聊天室 ID
+     * @param  string $username 环信用户 ID
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add individual chat room members
+     * 
+     * \details
+     * Add one member to the chat room at a time. You cannot add the same member repeatedly. If the user is already a member of the chat room, the addition will fail with an error.
+     * 
+     * @param  string $roomId   Chat room ID
+     * @param  string $username User name
+     * @return boolean|array    Success or error
+     */
+    public function addRoomMember($roomId, $username)
+    {
+        return $this->addUsers($roomId, $username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量添加聊天室成员
+     * 
+     * \details
+     * 向聊天室添加多位用户，一次性最多可添加 60 位用户。
+     * 
+     * @param  string $roomId    聊天室 ID
+     * @param  array  $usernames 环信用户 ID 数组
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch add chat members
+     * 
+     * \details
+     * Add more than 60 users to the chat room at one time.
+     * 
+     * @param  string $roomId    Chat room ID
+     * @param  array  $usernames User name array
+     * @return boolean|array     Success or error
+     */
+    public function addRoomMembers($roomId, $usernames)
+    {
+        return $this->addUsers($roomId, $usernames);  
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 删除单个聊天室成员
+     * 
+     * \details
+     * 从聊天室删除一个成员。如果被删除用户不在聊天室中，或者聊天室不存在，将返回错误。
+     * 
+     * @param  string $roomId   聊天室 ID
+     * @param  string $username 环信用户 ID
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Delete individual chat members
+     * 
+     * \details
+     * Delete a member from the chat room. If the deleted user is not in the chat room, or the chat room does not exist, an error will be returned.
+     * 
+     * @param  string $roomId   Chat room ID
+     * @param  string $username User name
+     * @return boolean|array    Success or error
+     */
+    public function removeRoomMember($roomId, $username)
+    {
+        return $this->removeUsers($roomId, $username);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量删除聊天室成员
+     * 
+     * \details
+     * 从聊天室删除多个成员。如果被删除用户不在聊天室中，或者聊天室不存在，将返回错误。
+     * 
+     * 一次最多传 100 个用户 ID。
+     * 
+     * @param  string $roomId    聊天室 ID
+     * @param  array  $usernames 环信用户 ID 数组
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch delete chat room members
+     * 
+     * \details
+     * Delete multiple members from the chat room. If the deleted user is not in the chat room, or the chat room does not exist, an error will be returned.
+     * 
+     * Up to 100 user IDs can be transmitted at a time.
+     * 
+     * @param  string $roomId    Chat room ID
+     * @param  array  $usernames User name array
+     * @return boolean|array     Success or error
+     */
+    public function removeRoomMembers($roomId, $usernames)
+    {
+        return $this->removeUsers($roomId, $usernames);
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取聊天室管理员列表
+     * 
+     * @param  string $roomId 聊天室 ID
+     * @return array          聊天室管理员列表信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the list of chat room administrators
+     * 
+     * @param  string $roomId Chat room ID
+     * @return array          Chat room administrator list information or error
+     */
+    public function listRoomAdminsAll($roomId)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/admin';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加聊天室管理员
+     * 
+     * @param  string  $roomId   聊天室 ID
+     * @param  string  $newadmin 添加的新管理员用户 ID
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add chat administrator
+     * 
+     * @param  string  $roomId   Chat room ID
+     * @param  string  $newadmin New administrator user ID added
+     * @return boolean|array     Success or error
+     */
+    public function promoteRoomAdmin($roomId, $newadmin)
+    {
+        if (!trim($roomId) || !trim($newadmin)) {
+            \Easemob\exception('Please pass the chat room ID and the new administrator user ID to be added');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/admin';
+        $body = compact('newadmin');
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 移除聊天室管理员
+     * 
+     * \details
+     * 将用户的角色从聊天室管理员降为普通聊天室成员。
+     * 
+     * @param  string  $roomId   聊天室 ID
+     * @param  string  $oldadmin 移除的管理员用户 ID
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove chat admin
+     * 
+     * \details
+     * Reduce the user's role from chat room administrator to ordinary chat room member.
+     * 
+     * @param  string  $roomId   Chat room ID
+     * @param  string  $oldadmin Removed administrator user ID
+     * @return boolean|array     Success or error
+     */
+    public function demoteRoomAdmin($roomId, $oldadmin)
+    {
+        if (!trim($roomId) || !trim($oldadmin)) {
+            \Easemob\exception('Please pass the chat room ID and the administrator user ID to be removed');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/admin/' . $oldadmin;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data']['result'] === 'success' ? true : false;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 分页获取聊天室超级管理员列表
+     * 
+     * @param  int   $pageSize 每页获取的数量，默认取 10 条
+     * @param  int   $pageNum  当前页码，默认取第 1 页
+     * @return array           超级管理员列表信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Paging to get the list of chat room super administrators
+     * 
+     * @param  int   $pageSize The quantity obtained per page is 10 by default
+     * @param  int   $pageNum  The current page number is page 1 by default
+     * @return array           Super administrator list information or error
+     */
+    public function listRoomSuperAdmins($pageSize = 10, $pageNum = 1)
+    {
+        return $this->superAdmins($pageSize, $pageNum);
+    }
+
+    /// @cond
+    public function listRoomSuperAdminsAll()
+    {
+        return $this->superAdmins(0);
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加超级管理员
+     * 
+     * \details
+     * 给用户添加聊天室超级管理员身份，一次只能添加一个。
+     * 
+     * @param  string  $superadmin 添加的用户名称
+     * @return boolean|array       成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add super administrator
+     * 
+     * \details
+     * Add the chat room super administrator identity to users. You can only add one at a time.
+     * 
+     * @param  string  $superadmin User name
+     * @return boolean|array       Success or error
+     */
+    public function promoteRoomSuperAdmin($superadmin)
+    {
+        if (!is_string($superadmin) || !trim($superadmin)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/super_admin';
+        $resp = Http::post($uri, compact('superadmin'), $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 撤销超级管理员
+     * 
+     * @param  string  $superadmin 需要移除的 IM 用户名
+     * @return boolean|array       成功或者错误
+     * 
+     * \~chinese
+     * \brief
+     * 撤销超级管理员
+     * 
+     * @param  string  $superadmin User name
+     * @return boolean|array       Success or error
+     */
+    public function demoteRoomSuperAdmin($superadmin)
+    {
+        if (!trim($superadmin)) {
+            \Easemob\exception('Please pass the user name');
+        }
+        $uri = $this->auth->getBaseUri() . '/chatrooms/super_admin/' . $superadmin;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore （批量）添加聊天室成员
+     * @param  string       $roomId    聊天室 ID
+     * @param  string|array $usernames 环信用户 ID
+     * @return boolean|array           成功或者错误
+     */
+    private function addUsers($roomId, $usernames)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if ((is_array($usernames) && empty($usernames)) || (is_string($usernames) && !trim($usernames))) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/users';
+        $uri .= is_array($usernames) ? '' : ('/' . $usernames);
+        $body = is_array($usernames) ? compact('usernames') : null;
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore （批量）移除聊天室成员
+     * @param  string       $roomId    聊天室 ID
+     * @param  string|array $usernames 环信用户 ID，string: 移除单个成员；array: 批量移除成员
+     * @return boolean|array           成功或者错误
+     */
+    private function removeUsers($roomId, $usernames)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if ((is_array($usernames) && empty($usernames)) || (is_string($usernames) && !trim($usernames))) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/users/';
+        $uri .= is_array($usernames) ? implode(',', $usernames) : $usernames;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * @ignore 分页获取聊天室超级管理员列表
+     * @param  int    $pageSize 每页获取的群组数量，默认取 10 条
+     * @param  int    $pageNum  当前页码，默认取第 1 页
+     * @return array            超级管理员列表信息或者错误
+     */
+    private function superAdmins($pageSize = 10, $pageNum = 1)
+    {
+        $pageSize = (int)$pageSize >= 0 ? (int)$pageSize : 10;
+        $pageNum = (int)$pageNum > 0 ? (int)$pageNum : 1;
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/super_admin';
+        $uri .= $pageSize ? ('?pagesize=' . $pageSize . '&pagenum=' . $pageNum) : '';
+
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+}

vendor/maniac/easemob-php/src/User.php

@@ -0,0 +1,422 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * User 用来实现用户体系建立和管理
+ * 
+ * \~english
+ * The `User` is used to realize the establishment and management of user system
+ */
+final class User
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 注册单个用户 | 批量注册用户
+     * 
+     * @param array $users 要注册的用户信息，注册单个用户时传入一维数组，批量注册用户时传入二维数组。
+     *     - `username` String 类型，用户名，长度不可超过 64 个字节长度。支持以下字符集：
+     *         - 26 个小写英文字母 a-z；
+     *         - 26 个大写英文字母 A-Z；
+     *         - 10 个数字 0-9；
+     *         - “_”, “-”, “.”。
+     *         <pre><b style="color: red">注意：不区分大小写。同一个 app 下，用户名唯一。</b></pre>
+     *     - `password` String 类型，登录密码，长度不可超过 64 个字符长度。
+     *     - `nickname` String 类型，昵称（可选），仅用在客户端推送通知栏显示的昵称，并不是用户个人信息的昵称，开发者可自定义该内容。长度不可超过 100 个字符。支持以下字符集：
+     *         - 26 个小写英文字母 a-z；
+     *         - 26 个大写英文字母 A-Z；
+     *         - 10 个数字 0-9；
+     *         - 中文；
+     *         - 特殊字符。
+     * @return array 注册的用户信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Register individual users | Batch registered users
+     * 
+     * @param array $users For the user information to be registered, a one-dimensional array is passed in when registering a single user, and a two-dimensional array is passed in when registering users in batch.
+     *     - `username` String type, user name, length cannot exceed 64 bytes. The following character sets are supported:
+     *         - 26 lowercase English letters a-z;
+     *         - 26 uppercase English letters A-Z;
+     *         - 10 digits 0-9;
+     *         - "_", "-" ".".
+     *         <pre><b style="color: red">Note: case insensitive. Under the same app, the user name is unique.</b></pre>
+     *     - `password` String type, login password, the length cannot exceed 64 characters.
+     *     - `nickname` String type, nickname (optional). It is only used for the nickname displayed in the client push notification bar, not the nickname of the user's personal information. The developer can customize this content. The length cannot exceed 100 characters. The following character sets are supported:
+     *         - 26 lowercase English letters a-z;
+     *         - 26 uppercase English letters A-Z;
+     *         - 10 digits 0-9;
+     *         - Chinese;
+     *         - Special characters;
+     * @return array Registered user information or error
+     */
+    public function create($users)
+    {
+        // 一维数组标识
+        $usersOneFlag = false;
+        if (count($users) == count($users, 1)) {
+            // 一维数组
+            $usersOneFlag = true;
+            $this->authUser($users);
+        } else {
+            // 多维数组
+            foreach ($users as $user) {
+                $this->authUser($user);
+            }
+        }
+        
+        $uri = $this->auth->getBaseUri() . '/users';
+        $resp = Http::post($uri, $users, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        
+        $data = $resp->data();
+        return $usersOneFlag ? $data['entities'][0] : $data['entities'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取单个用户的详细信息
+     * 
+     * @param  string $username 用户名
+     * @return array            用户信息或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the details of a single user
+     * 
+     * @param  string $username User name
+     * @return array            User information or error
+     */
+    public function get($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter your username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username;
+
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        
+        $data = $resp->data();
+        return $data['entities'][0];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量获取用户
+     * 
+     * @param  int     $limit     获取用户的数量。默认值 10，最大值 100。超过 100 按照 100 返回。
+     * @param  string  $cursor    游标，用于分页显示用户列表。第一次发起批量查询用户请求时无需设置 cursor，请求成功后会获得第一页用户列表。从响应 body 中获取 cursor，并在下一次请求 中传入该 cursor，直到响应 body 中不再有 cursor 字段，则表示已查询到 app 中所有用户。
+     * @param  boolean $activated 用户是否激活。true：已激活；false：封禁，封禁需要通过解禁接口进行解禁，才能正常登录。
+     * @return array              分页用户信息或者错误
+     * 
+     * \~english
+     * \brief Get users in batch
+     * 
+     * @param  int     $limit     Gets the number of users. The default value is 10 and the maximum value is 100. If it exceeds 100, it will be returned as 100.
+     * @param  string  $cursor    Cursor, used to display the list of users in pages. When initiating a batch query user request for the first time, there is no need to set cursor. After the request is successful, the user list on the first page will be obtained. If there is no response from cursor to the next user in the URL field of cursor, it indicates that there is no response from cursor to the next user in the URL field of cursor.
+     * @param  boolean $activated Whether the user is activated. True: activated; False: blocking. The blocking needs to be lifted through the unblocking interface to log in normally.
+     * @return array              Paging user information or error
+     */
+    public function listUsers($limit = 10, $cursor = '', $activated = true)
+    {
+        $limit = (int)$limit <= 0 ? 10 : (int)$limit;
+        $limit = $limit > 100 ? 100 : $limit;
+        $activated = (boolean)$activated;
+
+        $uri = $this->auth->getBaseUri() . '/users';
+        $uri .= '?limit='.$limit;
+        $uri .= $cursor ? '&cursor='.$cursor : '';
+        $uri .= '&activated='.($activated ? 1 : 0);
+
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        
+        $data = $resp->data();
+        return array(
+            'data' => $data['entities'],
+            'cursor' => isset($data['cursor']) && $data['cursor'] ? $data['cursor'] : '', 
+        );
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 删除单个用户
+     * 
+     * \details
+     * 删除一个用户，如果此用户是群组或者聊天室的群主，系统会同时删除这些群组和聊天室。请在操作时进行确认。
+     * 
+     * @param  string  $username 用户名
+     * @return boolean|array     成功或失败或者错误
+     * 
+     * \~english
+     * \brief
+     * Delete single user
+     * 
+     * \details
+     * Delete a user. If the user is the group owner of a group or chat room, the system will delete these groups and chat rooms at the same time. Please confirm during operation.
+     * 
+     * @param  string  $username User name
+     * @return boolean|array     Success or failure or error
+     */
+    public function delete($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter your username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return isset($data['entities'][0]) && $data['entities'][0]['username'] === $username ? true : false;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量删除用户
+     * 
+     * \details
+     * 删除某个 APP 下指定数量的用户账号。
+     * 
+     * @param  int   $limit 要删除的用户数量，建议这个数值在 100-500 之间，不要过大。需要注意的是，这里只是批量的一次性删除掉 N 个用户，具体删除哪些并没有指定，可以在返回值中查看到哪些用户被删除掉了。如果 $limit 的值小于等于 0，值会按 1 处理
+     * @return array        被删除的用户信息或者错误
+     * 
+     * \~english 
+     * \brief
+     * Batch delete user
+     * 
+     * \details
+     * Delete a specified number of user accounts under an app.
+     * 
+     * @param  int   $limit The number of users to be deleted is recommended to be between 100-500, not too large. It should be noted that only n users are deleted in batches at one time. The specific deleted users are not specified. You can see which users have been deleted in the return value. If the value of $limit is less than or equal to 0, the value will be treated as 1
+     * @return array        Deleted user information or error
+     */
+    public function batchDelete($limit = 0)
+    {
+        $limit = (int)$limit <= 0 ? 1 : (int)$limit;
+        $uri = $this->auth->getBaseUri() . '/users?limit='.$limit;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['entities'];
+    }
+
+    /// @cond
+    public function deleteAll()
+    {
+        return $this->batchDelete(0);
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 修改用户密码
+     * 
+     * \details
+     * 可以修改用户的登录密码，不需要提供原密码。
+     * 
+     * @param  string  $username    用户名
+     * @param  string  $newpassword 新密码
+     * @return boolean|array        成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Modify user password
+     * 
+     * \details
+     * You can change the user's login password without providing the original password.
+     * 
+     * @param  string  $username    User name
+     * @param  string  $newpassword New password
+     * @return boolean|array        Success or error
+     */
+    public function updateUserPassword($username, $newpassword)
+    {
+        if (!trim($username) || !trim($newpassword)) {
+            \Easemob\exception('Please enter your username and password');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/password';
+        $body = compact('newpassword');
+        $resp = Http::put($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取用户在线状态
+     * 
+     * @param  string  $username 要获取在线状态的用户名
+     * @return boolean|array     是否在线（true：在线，false：离线）或者错误
+     * 
+     * \~english
+     * \brief
+     * Get user online status
+     * 
+     * @param  string  $username User name
+     * @return boolean|array     Online status (true: online, false: offline) or error
+     */
+    public function isUserOnline($username)
+    {
+        if (!is_string($username) || !trim($username)) {
+            \Easemob\exception('Please enter your username');
+        }
+        $result = $this->status($username);
+        return isset($result[$username]) && $result[$username] === 'online' ? true : false;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量获取用户在线状态
+     * 
+     * \details
+     * 批量查看用户的在线状态，最大同时查看100个用户。
+     * 
+     * @param  array $usernames 要获取在线状态的用户名数组，最多不能超过100个
+     * @return array            用户在线状态数组（数组键为用户名，数组值为用户对应的在线状态，true：在线，false：离线）或者错误
+     * 
+     * \~english
+     * \brief
+     * Get online status of users in batch
+     * 
+     * \details
+     * View the online status of users in batches, with a maximum of 100 users at the same time.
+     * 
+     * @param  array $usernames User name array, no more than 100
+     * @return array            User online status array (array key is user name, array value is user's corresponding online status, true: online, false: offline) or error
+     */
+    public function isUsersOnline($usernames)
+    {
+        if (!is_array($usernames) || empty($usernames)) {
+            \Easemob\exception('Please enter user name array');
+        }
+        $result = $this->status($usernames);
+        $data = array();
+        foreach ($result as $user => $status) {
+            $data[$user] = $status === 'online' ? true : false;
+        }
+        return $data;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 强制下线
+     * 
+     * \details
+     * 强制用户即把用户状态改为离线，用户需要重新登录才能正常使用。
+     * 
+     * @param  string  $username 要强制下线用户的用户名
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Force user offline
+     * 
+     * \details
+     * Force the user to change the user status to offline, and the user needs to log in again to use it normally.
+     * 
+     * @param  string  $username User name
+     * @return boolean|array     Success or error
+     */
+    public function forceLogoutAllDevices($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter your username');
+        }
+        $uri = $this->auth->getBaseUri() . '/users/' . $username . '/disconnect';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data']['result'];
+    }
+
+    /// @cond
+    public function forceLogoutOneDevice($username, $resource)
+    {
+
+    }
+    /// @endcond
+
+    /**
+     * @ignore 获取用户在线状态 | 批量获取用户在线状态
+     * @param  string|array $username 要获取在线状态的用户名，string：获取用户在线状态；array：批量获取用户在线状态
+     * @return boolean|array 是否在线（true：在线，false：离线）或者用户在线状态数组（数组键为用户名，数组值为用户对应的在线状态，true：在线，false：离线）或者错误
+     */
+    private function status($username)
+    {
+        if (is_array($username)) {
+            // 批量获取用户在线状态
+            $uri = $this->auth->getBaseUri() . '/users/batch/status';
+            $body = array('usernames' => $username);
+            $resp = Http::post($uri, $body, $this->auth->headers());
+        } else {
+            // 获取用户在线状态
+            $uri = $this->auth->getBaseUri() . '/users/' . $username . '/status';
+            $resp = Http::get($uri, $this->auth->headers());
+        }
+        
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        if (is_array($username)) {
+            $result = array();
+            foreach ($data['data'] as $val) {
+                foreach ($val as $key => $item) {
+                    $result[$key] = $item;
+                }
+            }
+            return $result;
+        }
+        return $data['data'];
+    }
+
+    /**
+     * @ignore 验证用户信息
+     * @param array $user 用户信息
+     */
+    private function authUser($user)
+    {
+        if (!isset($user['username']) || !trim($user['username']) || !isset($user['password']) || !trim($user['password'])) {
+            return \Easemob\exception('Please enter your username and password');
+        }
+    }
+}

vendor/maniac/easemob-php/src/UserMetadata.php

@@ -0,0 +1,211 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * UserMetadata 用来管理用户属性
+ * 
+ * \~english
+ * The `UserMetadata` is used to manage user attribute
+ */
+final class UserMetadata
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    /**
+     * \~chinese
+     * \brief
+     * 设置用户属性
+     * 
+     * \details
+     * 用户属性的内容为一个或多个纯文本键值对，默认单一用户的属性总长不得超过 2 KB，默认一个 app 下所有用户的所有属性总长不得超过 10 GB。
+     * 
+     * @param  string  $username 要设置属性的用户名
+     * @param  array   $metadata 要设置的属性（键：属性名；值：属性值）
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Set user properties
+     * 
+     * \details
+     * The content of user attributes is one or more plain text key value pairs. By default, the total length of attributes of a single user shall not exceed 2 kb. By default, the total length of all attributes of all users under an app shall not exceed 10 GB.
+     * 
+     * @param  string  $username User name
+     * @param  array   $metadata Properties(key: attribute name; value: attribute value)
+     * @return boolean|array     Success or error
+     */
+    public function setMetadataToUser($username, $metadata)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+        if (!is_array($metadata) || empty($metadata)) {
+            \Easemob\exception('Please enter metadata');
+        }
+        $uri = $this->auth->getBaseUri() . '/metadata/user/' . $username;
+        $resp = Http::put($uri, http_build_query($metadata), $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取用户属性
+     * 
+     * \details
+     * 获取指定用户的所有用户属性键值对。如果指定的用户或用户属性不存在，返回空数据 {}。
+     * 
+     * @param  string $username 要获取属性的用户名
+     * @return array            用户属性或者错误
+     * 
+     * \~english
+     * \brief
+     * Get user properties
+     * 
+     * \details
+     * Gets all user attribute key value pairs for the specified user. If the specified user or user attribute does not exist, null data {} is returned.
+     * 
+     * @param  string $username User name
+     * @return array            User properties or error
+     */
+    public function getMetadataFromUser($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+        $uri = $this->auth->getBaseUri() . '/metadata/user/' . $username;
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量获取用户属性
+     * 
+     * \details
+     * 根据指定的用户名列表和属性列表，查询用户属性。如果指定的用户或用户属性不存在，返回空数据 {}。 每次最多指定 100 个用户。
+     * 
+     * @param  array $targets    用户名列表，最多 100 个用户名。
+     * @param  array $properties 属性名列表，查询结果只返回该列表中包含的属性，不在该列表中的属性将被忽略。
+     * @return array             用户属性（数组键是用户名，数组值是用户对应的属性）或者错误
+     * 
+     * \~english
+     * \brief
+     * Get user attributes in batch
+     * 
+     * \details
+     * Query user attributes according to the specified user name list and attribute list. If the specified user or user attribute does not exist, null data {} is returned. Specify up to 100 users at a time.
+     * 
+     * @param  array $targets    User name list, up to 100 user names.
+     * @param  array $properties Attribute name list. The query result only returns the attributes contained in the list, and the attributes not in the list will be ignored.
+     * @return array             User attribute (the array key is the user name, and the array value is the attribute corresponding to the user) or error
+     */
+    public function batchGetMetadataFromUser($targets, $properties)
+    {
+        if (!is_array($targets) || empty($targets) || !is_array($properties) || empty($properties)) {
+            \Easemob\exception('Parameters error');
+        }
+
+        // 最多 100 个用户
+        $limitNums = 100;
+        if (count($targets) > $limitNums) {
+            // 截取前 100 个用户
+            $targets = array_slice($targets, 0, $limitNums);
+        }
+        $uri = $this->auth->getBaseUri() . '/metadata/user/get';
+        $body = compact('targets', 'properties');
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 获取用户属性总量大小
+     * 
+     * \details
+     * 获取该 app 下所有用户的属性数据大小，单位为 byte。
+     * 
+     * @return float|array 用户属性总量大小（单位：byte）或者错误
+     * 
+     * \~english
+     * \brief
+     * Get the total size of user attributes
+     * 
+     * \details
+     * Get the attribute data size of all users under the app, in bytes.
+     * 
+     * @return float|array Total size of user attributes (unit: byte) or error
+     */
+    public function getUsage()
+    {
+        $uri = $this->auth->getBaseUri() . '/metadata/user/capacity';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 删除用户属性
+     * 
+     * \details
+     * 删除指定用户的所有属性。如果指定的用户或用户属性不存在（可能已删除），也视为删除成功。
+     * 
+     * @param  string  $username 用户名
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Delete user attributes
+     * 
+     * \details
+     * Deletes all properties of the specified user. If the specified user or user attribute does not exist (may have been deleted), the deletion is also regarded as successful.
+     * 
+     * @param  string  $username User name
+     * @return boolean|array     Success or error
+     */
+    public function deleteMetadataFromUser($username)
+    {
+        if (!trim($username)) {
+            \Easemob\exception('Please enter username');
+        }
+        $uri = $this->auth->getBaseUri() . '/metadata/user/' . $username;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+}

vendor/maniac/easemob-php/src/WhiteList.php

@@ -0,0 +1,349 @@
+<?php
+namespace Easemob;
+
+use Easemob\Http\Http;
+
+/**
+ * \~chinese
+ * WhiteList 用于管理群组、聊天室白名单
+ * 
+ * \~english
+ * The `WhiteList` used to manage groups, chat rooms white lists
+ */
+final class WhiteList
+{
+    /**
+     * @ignore
+     * @var Auth $auth 授权对象
+     */
+    private $auth;
+
+    /// @cond
+    public function __construct($auth)
+    {
+        $this->auth = $auth;
+    }
+    /// @endcond
+
+    // Group
+    /**
+     * \~chinese
+     * \brief
+     * 查询群组白名单
+     * 
+     * \details
+     * 查询一个群组白名单中的用户列表。
+     * 
+     * @param  string $groupId 群组 id
+     * @return array           白名单列表或者错误
+     * 
+     * \~english
+     * \brief
+     * Query group whitelist
+     * 
+     * \details
+     * Query the list of users in a group white list.
+     * 
+     * @param  string $groupId group ID
+     * @return array           Whitelist or error
+     */
+    public function getGroupWhiteList($groupId)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/white/users';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加单个用户至群组白名单
+     * 
+     * \details
+     * 查询一个群组将指定的单个用户添加至群组白名单。用户在添加至群组白名单后，当群组全员被禁言时，仍可以在群组中发送消息。白名单中的用户列表。
+     * 
+     * @param  string $groupId  群组 id
+     * @param  string $username 用户名
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add a single user to the group whitelist
+     * 
+     * \details
+     * Query a group and add the specified individual user to the group white list. After being added to the group white list, users can still send messages in the group when all members of the group are banned. List of users in the whitelist.
+     * 
+     * @param  string $groupId  Group id
+     * @param  string $username user name
+     * @return boolean|array    Success or error
+     */
+    public function addUserToGroupWhiteList($groupId, $username)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if (!trim($username)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/white/users/' . $username;
+        $resp = Http::post($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量添加用户至群组白名单
+     * 
+     * \details
+     * 添加多个用户至群组白名单。你一次最多可添加 60 个用户。用户添加至白名单后在群组全员禁言时仍可以在群组中发送消息。
+     * 
+     * @param  string $groupId   群组 id
+     * @param  array  $usernames 用户名数组
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch add users to the group whitelist
+     * 
+     * \details
+     * Add multiple users to the group whitelist. You can add up to 60 users at a time. After users are added to the white list, they can still send messages in the group when all members of the group are forbidden.
+     * 
+     * @param  string $groupId   Group id
+     * @param  array  $usernames User name array
+     * @return boolean|array     Success or error
+     */
+    public function addUsersToGroupWhiteList($groupId, $usernames)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if (!is_array($usernames) || empty($usernames)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/white/users';
+        $body = compact('usernames');
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 将用户移除群组白名单
+     * 
+     * \details
+     * 将指定用户从群组白名单中移除。你每次最多可移除 60 个用户。
+     * 
+     * @param  string $groupId  群组 id
+     * @param  string $username 用户名，可以以逗号分隔传递多个用户名
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove user from group whitelist
+     * 
+     * \details
+     * Removes the specified user from the group whitelist. You can remove up to 60 users at a time.
+     * 
+     * @param  string $groupId   Group ID
+     * @param  string $username  User name. Multiple user names can be passed in comma separated form
+     * @return boolean|array     Success or error
+     */
+    public function removeUsersFromGroupWhiteList($groupId, $username)
+    {
+        if (!trim($groupId)) {
+            \Easemob\exception('Please pass the group ID');
+        }
+
+        if (!trim($username)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatgroups/' . $groupId . '/white/users/' . $username;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    // Room
+    /**
+     * \~chinese
+     * \brief
+     * 查询聊天室白名单
+     * 
+     * \details
+     * 查询一个聊天室白名单中的用户列表。
+     * 
+     * @param  string $roomId 聊天室 id
+     * @return array          白名单列表或者错误
+     * 
+     * \~english
+     * \brief
+     * Query chat room white list
+     * 
+     * \details
+     * Query the list of users in a chat room white list.
+     * 
+     * @param  string $roomId Chat room ID
+     * @return array          Whitelist or error
+     */
+    public function getRoomWhiteList($roomId)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/white/users';
+        $resp = Http::get($uri, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        $data = $resp->data();
+        return $data['data'];
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 添加单个用户至聊天室白名单
+     * 
+     * \details
+     * 将指定的单个用户添加至聊天室白名单。用户添加至聊天室白名单后，当聊天室全员禁言时，仍可以在聊天室中发送消息。
+     * 
+     * @param  string $roomId   聊天室 id
+     * @param  string $username 用户名
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Add a single user to the chat room whitelist
+     * 
+     * \details
+     * Adds the specified individual user to the chat room whitelist. After the user is added to the chat room white list, when the chat room is forbidden, he can still send messages in the chat room.
+     * 
+     * @param  string $roomId   Chat room id
+     * @param  string $username user name
+     * @return boolean|array    Success or error
+     */
+    public function addUserToRoomWhiteList($roomId, $username)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if (!trim($username)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/white/users/' . $username;
+        $resp = Http::post($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 批量添加用户至聊天室白名单
+     * 
+     * \details
+     * 添加多个用户至聊天室白名单。你一次最多可添加 60 个用户。用户添加至聊天室白名单后，在聊天室全员禁言时，仍可以在聊天室中发送消息。
+     * 
+     * @param  string $roomId    聊天室 id
+     * @param  array  $usernames 用户名数组
+     * @return boolean|array     成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Batch add users to chat room white list
+     * 
+     * \details
+     * Add multiple users to the chat room whitelist. You can add up to 60 users at a time. After users are added to the chat room white list, they can still send messages in the chat room when all members of the chat room are forbidden to speak.
+     * 
+     * @param  string $roomId    Chat room id
+     * @param  array  $usernames User name array
+     * @return boolean|array     Success or error
+     */
+    public function addUsersToRoomWhiteList($roomId, $usernames)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if (!is_array($usernames) || empty($usernames)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/white/users';
+        $body = compact('usernames');
+        $resp = Http::post($uri, $body, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+
+    /**
+     * \~chinese
+     * \brief
+     * 将用户移除聊天室白名单
+     * 
+     * \details
+     * 将指定用户从聊天室白名单移除。你每次最多可移除 60 个用户。
+     * 
+     * @param  string $roomId   聊天室 id
+     * @param  string $username 用户名，可以以逗号分隔传递多个用户名
+     * @return boolean|array    成功或者错误
+     * 
+     * \~english
+     * \brief
+     * Remove user from chat room whitelist
+     * 
+     * \details
+     * Remove the specified user from the chat room whitelist. You can remove up to 60 users at a time.
+     * 
+     * @param  string $roomId   Chat room ID
+     * @param  string $username User name. Multiple user names can be passed in comma separated form
+     * @return boolean|array    Success or error
+     */
+    public function removeUsersFromRoomWhiteList($roomId, $username)
+    {
+        if (!trim($roomId)) {
+            \Easemob\exception('Please pass the chat room ID');
+        }
+
+        if (!trim($username)) {
+            \Easemob\exception('Please pass the user name');
+        }
+
+        $uri = $this->auth->getBaseUri() . '/chatrooms/' . $roomId . '/white/users/' . $username;
+        $resp = Http::delete($uri, null, $this->auth->headers());
+        if (!$resp->ok()) {
+            return \Easemob\error($resp);
+        }
+        return true;
+    }
+}

vendor/maniac/easemob-php/src/functions.php

@@ -0,0 +1,39 @@
+<?php
+/**
+ * @ignore 公共函数库
+ */
+namespace Easemob;
+
+/**
+ * @ignore 返回错误信息
+ * @param  Response $response 响应对象
+ * @param  string   $message  错误信息
+ * @param  int      $code     错误码
+ * @return array              返回信息
+ */
+function error($response, $message = null, $code = 1)
+{
+    if ($response !== null) {
+        $data = $response->data();
+        return array(
+            'code' => $response->httpCode,
+            'error' => isset($data['error']) ? $data['error'] : $response->error,
+            'error_description' => isset($data['error_description']) ? $data['error_description'] : '',
+        );
+    }
+    return array(
+        'code' => $code,
+        'error' => $message,
+    );
+    // throw new \Exception($message, $code);
+}
+
+/**
+ * @ignore 输出异常信息
+ * @param string $message 异常信息
+ * @param int    $code    错误码
+ */
+function exception($message, $code = 1)
+{
+    throw new \Exception($message, $code);
+}

vendor/maniac/easemob-php/tests/AttachmentTest.php

@@ -0,0 +1,19 @@
+<?php
+namespace tests;
+
+class AttachmentTest extends Base
+{
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    public function testAttachmentUploadDownload()
+    {
+        $data = $this->attachment->uploadFile(dirname(__FILE__).'/assets/1.png');
+        $this->assertArrayHasKey('uuid', $data);
+
+        $this->assertIsInt($this->attachment->downloadFile(dirname(__FILE__).'/assets/11.png', $data['uuid'], $data['share-secret']));
+        $this->assertIsInt($this->attachment->downloadThumb(dirname(__FILE__).'/assets/11_thumb.png', $data['uuid'], $data['share-secret']));
+    }
+}

vendor/maniac/easemob-php/tests/Base.php

@@ -0,0 +1,45 @@
+<?php
+namespace tests;
+
+use PHPUnit\Framework\TestCase;
+use Easemob\Auth;
+use Easemob\User;
+use Easemob\Contact;
+use Easemob\Block;
+use Easemob\Message;
+use Easemob\UserMetadata;
+use Easemob\Push;
+use Easemob\Attachment;
+use Easemob\Group;
+use Easemob\Room;
+
+class Base extends TestCase
+{
+    public $auth;
+    public $user;
+    public $contact;
+    public $block;
+    public $message;
+    public $metadata;
+    public $push;
+    public $attachment;
+    public $group;
+    public $room;
+
+    public function __construct()
+    {
+        parent::__construct();
+        $this->auth = new Auth("appKey", "Client ID", "ClientSecret");
+        // 设置 Rest Api 域名
+        // $this->auth->setApiUri('http://a1-hsb.easemob.com');
+        $this->user = new User($this->auth);
+        $this->contact = new Contact($this->auth);
+        $this->block = new Block($this->auth);
+        $this->message = new Message($this->auth);
+        $this->metadata = new UserMetadata($this->auth);
+        $this->push = new Push($this->auth);
+        $this->attachment = new Attachment($this->auth);
+        $this->group = new Group($this->auth);
+        $this->room = new Room($this->auth);
+    }
+}

vendor/maniac/easemob-php/tests/GroupTest.php

@@ -0,0 +1,508 @@
+<?php
+namespace tests;
+
+class GroupTest extends Base
+{
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    public function testGroupCreatePublic()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+
+        $randomMemberUsername = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPublicGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $data = $this->group->listAllGroupMembers($groupId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(count($data) - 1, count($members));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupCreatePublicWithCustom()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+
+        $randomMemberUsername = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPublicGroup($randomOwnerUsername, "group", "group description", $members, 200, true, 'custom');
+        $this->assertIsString($groupId);
+
+        $data = $this->group->listAllGroupMembers($groupId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(count($data) - 1, count($members));
+
+        $result = $this->group->getGroup($groupId);
+
+        $this->assertArrayNotHasKey('code', $result);
+        $this->assertEquals($result['custom'], 'custom');
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupCreatePrivate()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+
+        $randomMemberUsername = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $data = $this->group->listAllGroupMembers($groupId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(count($data) - 1, count($members));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupCreatePrivateWithCustom()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+
+        $randomMemberUsername = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true, 'custom');
+        $this->assertIsString($groupId);
+
+        $data = $this->group->listAllGroupMembers($groupId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(count($data) - 1, count($members));
+
+        $group = $this->group->getGroup($groupId);
+        $this->assertArrayNotHasKey('code', $group);
+        $this->assertEquals($group['custom'], 'custom');
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupDestroy()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertArrayHasKey('code', $this->group->getGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupListAllGroups()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertArrayNotHasKey('code', $this->group->listAllGroups());
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupListGroups()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertArrayNotHasKey('code', $this->group->listGroups(1));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupGet()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $randomAdminUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword), array('username' => $randomAdminUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername, $randomAdminUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->group->addGroupAdmin($groupId, $randomAdminUsername));
+        $group = $this->group->getGroup($groupId);
+        $this->assertArrayNotHasKey('code', $group);
+        $this->assertEquals($group['affiliations_count'], 3);
+        $this->assertNotNull($group['affiliations']);
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+        $this->assertTrue($this->user->delete($randomAdminUsername));
+    }
+
+    public function testGroupUpdate()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $maxUsers = 400;
+        $this->assertTrue($this->group->updateGroup(array('group_id' => $groupId, 'maxusers' => $maxUsers)));
+
+        $group = $this->group->getGroup($groupId);
+        $this->assertArrayNotHasKey('code', $group);
+        $this->assertEquals($group['maxusers'], $maxUsers);
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupUpdateOwner()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->group->updateGroupOwner($groupId, $randomMemberUsername));
+
+        $group = $this->group->getGroup($groupId);
+        $this->assertArrayNotHasKey('code', $group);
+        $this->assertEquals($group['owner'], $randomMemberUsername);
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupGetAnnouncement()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertArrayNotHasKey('code', $this->group->getGroupAnnouncement($groupId));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupUpdateAnnouncement()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $announcement = "update announcement";
+        $this->assertTrue($this->group->updateGroupAnnouncement($groupId, $announcement));
+
+        $group = $this->group->getGroupAnnouncement($groupId);
+        $this->assertArrayNotHasKey('code', $group);
+        $this->assertEquals($announcement, $group['announcement']);
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupListAllGroupMembers()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertArrayNotHasKey('code', $this->group->listAllGroupMembers($groupId));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupListMembers()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertArrayNotHasKey('code', $this->group->listGroupMembers($groupId, 2));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupAddMemberSingle()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $randomMemberUsername1 = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername1, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->group->addGroupMember($groupId, $randomMemberUsername1));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername1));
+    }
+
+    public function testGroupAddMemberBatch()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $randomMemberUsername1 = Utils::randomUserName();
+        $randomMemberUsername2 = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername1, 'password' => $randomPassword), array('username' => $randomMemberUsername2, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $addMembers = array($randomMemberUsername1, $randomMemberUsername2);
+        $this->assertTrue($this->group->addGroupMembers($groupId, $addMembers));
+        
+        $members = $this->group->listAllGroupMembers($groupId);
+        $this->assertArrayNotHasKey('code', $members);
+        $this->assertEquals(4, count($members));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername1));
+        $this->assertTrue($this->user->delete($randomMemberUsername2));
+    }
+
+    public function testGroupRemoveMemberSingle()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->group->removeGroupMember($groupId, $randomMemberUsername));
+
+        $members = $this->group->listAllGroupMembers($groupId);
+        $this->assertArrayNotHasKey('code', $members);
+        $this->assertEquals(1, count($members));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupRemoveMemberBatch()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $randomMemberUsername1 = Utils::randomUserName();
+        $randomMemberUsername2 = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername1, 'password' => $randomPassword), array('username' => $randomMemberUsername2, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername, $randomMemberUsername1, $randomMemberUsername2);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->group->removeGroupMembers($groupId, $members));
+        
+        $members = $this->group->listAllGroupMembers($groupId);
+        $this->assertArrayNotHasKey('code', $members);
+        $this->assertEquals(1, count($members));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername1));
+        $this->assertTrue($this->user->delete($randomMemberUsername2));
+    }
+
+    public function testGroupAdmin()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $randomAdminUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword), array('username' => $randomAdminUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername, $randomAdminUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->group->addGroupAdmin($groupId, $randomAdminUsername));
+
+        $admins = $this->group->listGroupAdmins($groupId);
+        $this->assertArrayNotHasKey('code', $admins);
+        $this->assertEquals(1, count($admins));
+
+        $this->assertIsBool($this->group->removeGroupAdmin($groupId, $randomAdminUsername));
+
+        $admins = $this->group->listGroupAdmins($groupId);
+        $this->assertArrayNotHasKey('code', $admins);
+        $this->assertEquals(0, count($admins));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+        $this->assertTrue($this->user->delete($randomAdminUsername));
+    }
+
+    public function testGroupUsersBlockedJoin()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->block->blockUserJoinGroup($groupId, $randomMemberUsername));
+
+        $data = $this->block->getUsersBlockedJoinGroup($groupId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals($data[0], $randomMemberUsername);
+
+        $this->assertTrue($this->block->unblockUserJoinGroup($groupId, $randomMemberUsername));
+        $data = $this->block->getUsersBlockedJoinGroup($groupId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(count($data), 0);
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testGroupBlockUserSendMsg()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $groupId = $this->group->createPrivateGroup($randomOwnerUsername, "group", "group description", $members, 200, true);
+        $this->assertIsString($groupId);
+
+        $this->assertTrue($this->block->blockUserSendMsgToGroup($groupId, $members, 30000));
+
+        $data = $this->block->getUsersBlockedSendMsgToGroup($groupId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+
+        $this->assertTrue($this->block->unblockUserSendMsgToGroup($groupId, $members));
+
+        $data = $this->block->getUsersBlockedSendMsgToGroup($groupId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(0, count($data));
+
+        $this->assertTrue($this->group->destroyGroup($groupId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+}

vendor/maniac/easemob-php/tests/HistoryMessageTest.php

@@ -0,0 +1,24 @@
+<?php
+namespace tests;
+
+class HistoryMessageTest extends Base
+{
+    public function __construct()
+    {
+        parent::__construct();
+        date_default_timezone_set('PRC');
+    }
+
+    /* 
+    // 发送消息一小时后再测试
+    public function testHistoryMsgGetAsUri()
+    {
+        $this->assertIsNotArray($this->message->getHistoryAsUri(date('YmdH', time() - 60*60)));
+    }
+
+    public function testHistoryMsgGetAsLocalFile()
+    {
+        $this->assertIsNotArray($this->assertIsString($this->message->getHistoryAsUri(date('YmdH', time() - 60*60))));
+    }
+     */
+}

vendor/maniac/easemob-php/tests/MessageTest.php

@@ -0,0 +1,202 @@
+<?php
+namespace tests;
+
+class MessageTest extends Base
+{
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    public function testMessageSendText()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $this->assertArrayNotHasKey('code', $this->message->text('users', array($randomToUsername), array('msg' => 'hello', 'ext' => array('ext1' => 'val1')), $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+
+    public function testMessageSendImage()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $data = $this->attachment->uploadFile(dirname(__FILE__).'/assets/1.png');
+        $this->assertArrayHasKey('uuid', $data);
+
+        $msg = array(
+            'filename' => '1.png',
+            'uuid' => $data['uuid'],
+            'secret' => $data['share-secret'],
+            'size' => array(
+                'width' => 36,
+                'height' => 36,
+            ),
+        );
+        $this->assertArrayNotHasKey('code', $this->message->image('users', array($randomToUsername), $msg, $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+
+    public function testMessageSendVoice()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $data = $this->attachment->uploadFile(dirname(__FILE__).'/assets/mario.amr');
+        $this->assertArrayHasKey('uuid', $data);
+        
+        $msg = array(
+            'filename' => 'mario.amr',
+            'uuid' => $data['uuid'],
+            'secret' => $data['share-secret'],
+            'length' => 89,
+        );
+        $this->assertArrayNotHasKey('code', $this->message->audio('users', array($randomToUsername), $msg, $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+
+    public function testMessageSendVideo()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $movie = dirname(__FILE__).'/assets/movie.ogg';
+        $data = $this->attachment->uploadFile($movie);
+        $this->assertArrayHasKey('uuid', $data);
+
+        $thumb = $this->attachment->uploadFile(dirname(__FILE__).'/assets/1.png');
+        $this->assertArrayHasKey('uuid', $thumb);
+
+        $msg = array(
+            'filename' => 'movie.ogg',  // 视频文件名称
+            'uuid' => $data['uuid'],   // 成功上传视频文件返回的UUID
+            'secret' => $data['share-secret'], // 成功上传视频文件后返回的secret
+            'thumb_uuid' => $thumb['uuid'],  // 成功上传视频缩略图返回的 UUID
+            'thumb_secret' => $thumb['share-secret'],   // 成功上传视频缩略图后返回的secret
+            'length' => 3, // 视频播放长度
+            'file_length' => filesize($movie),    // 视频文件大小（单位：字节）
+        );
+        $this->assertArrayNotHasKey('code', $this->message->video('users', array($randomToUsername), $msg, $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+
+    public function testMessageSendFile()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $data = $this->attachment->uploadFile(dirname(__FILE__).'/assets/1.txt');
+        $this->assertArrayHasKey('uuid', $data);
+
+        $msg = array(
+            'filename' => '1.txt',  // 文件名称
+            'uuid' => $data['uuid'],   // 成功上传文件返回的UUID
+            'secret' => $data['share-secret'], // 成功上传文件后返回的secret
+        );
+        $this->assertArrayNotHasKey('code', $this->message->file('users', array($randomToUsername), $msg, $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+
+    public function testMessageSendLocation()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $msg = array(
+            'lat' => '39.966',  // 纬度
+            'lng' => '116.322',   // 经度
+            'addr' => '中国北京市海淀区中关村', // 地址
+        );
+        $this->assertArrayNotHasKey('code', $this->message->location('users', array($randomToUsername), $msg, $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+
+    public function testMessageSendCommand()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $msg = array(
+            'event' => 'notification',  // 自定义键值
+            'id' => '123',   // 自定义键值
+        );
+        $this->assertArrayNotHasKey('code', $this->message->cmd('users', array($randomToUsername), $msg, $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+
+    public function testMessageSendCustom()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $msg = array(
+            // 用户自定义的事件类型，必须是string，值必须满足正则表达式 [a-zA-Z0-9-_/\.]{1,32}，最短1个字符 最长32个字符
+            'customEvent' => 'xxx',
+            // 用户自定义的事件属性，类型必须是Map<String,String>，最多可以包含16个元素。customExts 是可选的，不需要可以不传
+            'customExts' => array(
+                'asd' => '123',
+            ),
+        );
+        $this->assertArrayNotHasKey('code', $this->message->custom('users', array($randomToUsername), $msg, $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+
+    public function testMessageSendExtension()
+    {
+        $randomFromUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomToUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomFromUsername, 'password' => $randomPassword), array('username' => $randomToUsername, 'password' => $randomPassword))));
+
+        $msg = array(
+            // 用户自定义的事件类型，必须是string，值必须满足正则表达式 [a-zA-Z0-9-_/\.]{1,32}，最短1个字符 最长32个字符
+            'customEvent' => 'xxx',
+            // 用户自定义的事件属性，类型必须是Map<String,String>，最多可以包含16个元素。customExts 是可选的，不需要可以不传
+            'customExts' => array(
+                'asd' => '123',
+            ),
+            'ext' => array(
+                "em_apns_ext" => array(
+                    "em_push_content" => "自定义推送显示"
+                )
+            )
+        );
+        $this->assertArrayNotHasKey('code', $this->message->custom('users', array($randomToUsername), $msg, $randomFromUsername));
+
+        $this->assertTrue($this->user->delete($randomFromUsername));
+        $this->assertTrue($this->user->delete($randomToUsername));
+    }
+}

vendor/maniac/easemob-php/tests/PushTest.php

@@ -0,0 +1,56 @@
+<?php
+namespace tests;
+
+class PushTest extends Base
+{
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    public function testUpdateUserNickname()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+        $this->assertTrue($this->push->updateUserNickname($username, sprintf("nickname-%s", $username)));
+        $data = $this->user->get($username);
+        $this->assertArrayHasKey('uuid', $data);
+        $this->assertEquals('nickname-' . $data['username'], $data['nickname']);
+        $this->assertTrue($this->user->delete($username));
+    }
+
+    public function testNotificationDisplayStyle()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+
+        $this->assertTrue($this->push->setNotificationDisplayStyle($username, 0));
+        $data = $this->user->get($username);
+        $this->assertEquals('0', $data['notification_display_style']);
+
+        $this->assertTrue($this->push->setNotificationDisplayStyle($username));
+        $data = $this->user->get($username);
+        $this->assertEquals('1', $data['notification_display_style']);
+
+        $this->assertTrue($this->user->delete($username));
+    }
+
+    public function testOpenCloseNotificationNoDisturbing()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+
+        $this->assertTrue($this->push->openNotificationNoDisturbing($username, 10, 19));
+        $data = $this->user->get($username);
+        $this->assertTrue($data['notification_no_disturbing']);
+
+        $this->assertTrue($this->push->closeNotificationNoDisturbing($username));
+        $data = $this->user->get($username);
+        $this->assertFalse($data['notification_no_disturbing']);
+
+        $this->assertTrue($this->user->delete($username));
+    }
+}

vendor/maniac/easemob-php/tests/RoomTest.php

@@ -0,0 +1,216 @@
+<?php
+namespace tests;
+
+class RoomTest extends Base
+{
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    public function testRoomCycles()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $roomId = $this->room->createRoom("chat room", "room description", $randomOwnerUsername, $members, 200);
+        $this->assertIsString($roomId);
+
+        $data = $this->room->getRoom($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals($data['name'], "chat room");
+
+        $this->assertTrue($this->room->updateRoom(array('room_id' => $roomId, 'name' => "room chat")));
+
+        $data = $this->room->getRoom($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals($data['name'], "room chat");
+
+        $this->assertTrue($this->room->destroyRoom($roomId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testRoomListAll()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $roomId = $this->room->createRoom("chat room", "room description", $randomOwnerUsername, $members, 200);
+        $this->assertIsString($roomId);
+
+        $this->assertArrayNotHasKey('code', $this->room->listAllRooms());
+        $this->assertArrayNotHasKey('code', $this->room->listRooms(1));
+
+        $this->assertTrue($this->room->destroyRoom($roomId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testRoomUserJoinedList()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $roomId = $this->room->createRoom("chat room", "room description", $randomOwnerUsername, $members, 200);
+        $this->assertIsString($roomId);
+
+        $data = $this->room->listAllRoomsUserJoined($randomOwnerUsername);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+
+        $this->assertTrue($this->room->destroyRoom($roomId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testRoomMembers()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array();
+        $roomId = $this->room->createRoom("chat room", "room description", $randomOwnerUsername, $members, 200);
+        $this->assertIsString($roomId);
+
+        $this->assertTrue($this->room->addRoomMember($roomId, $randomMemberUsername));
+
+        $data = $this->room->listRoomMembersAll($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(2, count($data));
+
+        $this->assertTrue($this->room->removeRoomMember($roomId, $randomMemberUsername));
+
+        $data = $this->room->listRoomMembersAll($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+
+        $this->assertArrayNotHasKey('code', $this->room->listRoomMembers($roomId, 2));
+
+        $this->assertTrue($this->room->destroyRoom($roomId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testRoomAdmins()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $roomId = $this->room->createRoom("chat room", "room description", $randomOwnerUsername, $members, 200);
+        $this->assertIsString($roomId);
+
+        $this->assertTrue($this->room->promoteRoomAdmin($roomId, $randomMemberUsername));
+
+        $data = $this->room->listRoomAdminsAll($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+
+        $this->assertTrue($this->room->demoteRoomAdmin($roomId, $randomMemberUsername));
+
+        $data = $this->room->listRoomAdminsAll($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(0, count($data));
+
+        $this->assertTrue($this->room->destroyRoom($roomId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testRoomSuperAdmins()
+    {
+        $randomUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $randomUsername, 'password' => $randomPassword)));
+
+        $this->assertTrue($this->room->promoteRoomSuperAdmin($randomUsername));
+
+        $data = $this->room->listRoomSuperAdminsAll();
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+
+        $this->assertTrue($this->room->demoteRoomSuperAdmin($randomUsername));
+
+        $data = $this->room->listRoomSuperAdminsAll();
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(0, count($data));
+
+        $this->assertTrue($this->user->delete($randomUsername));
+    }
+
+    public function testRoomUsersBlockedJoin()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $roomId = $this->room->createRoom("chat room", "room description", $randomOwnerUsername, $members, 200);
+        $this->assertIsString($roomId);
+
+        $this->assertTrue($this->block->blockUserJoinRoom($roomId, $randomMemberUsername));
+
+        $data = $this->block->getUsersBlockedJoinRoom($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals($data[0], $randomMemberUsername);
+
+        $this->assertTrue($this->block->unblockUserJoinRoom($roomId, $randomMemberUsername));
+        $data = $this->block->getUsersBlockedJoinRoom($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(count($data), 0);
+
+        $this->assertTrue($this->room->destroyRoom($roomId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+
+    public function testRoomBlockUserSendMsg()
+    {
+        $randomOwnerUsername = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+        $randomMemberUsername = Utils::randomUserName();
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomOwnerUsername, 'password' => $randomPassword), array('username' => $randomMemberUsername, 'password' => $randomPassword))));
+
+        $members = array($randomMemberUsername);
+        $roomId = $this->room->createRoom("chat room", "room description", $randomOwnerUsername, $members, 200);
+        $this->assertIsString($roomId);
+
+        $this->assertTrue($this->block->blockUserSendMsgToRoom($roomId, $members, 30000));
+
+        $data = $this->block->getUsersBlockedSendMsgToRoom($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+
+        $this->assertTrue($this->block->unblockUserSendMsgToRoom($roomId, $members));
+
+        $data = $this->block->getUsersBlockedSendMsgToRoom($roomId);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(0, count($data));
+
+        $this->assertTrue($this->room->destroyRoom($roomId));
+
+        $this->assertTrue($this->user->delete($randomOwnerUsername));
+        $this->assertTrue($this->user->delete($randomMemberUsername));
+    }
+}

vendor/maniac/easemob-php/tests/UserMetadataTest.php

@@ -0,0 +1,32 @@
+<?php
+namespace tests;
+
+class UserMetadataTest extends Base
+{
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    public function testMetadataCycles()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+
+        $data = array(
+            'nickname' => '昵称',
+            'avatar' => 'http://www.easemob.com/avatar.png',
+            'phone' => '159',
+        );
+        $this->assertTrue($this->metadata->setMetadataToUser($username, $data));
+
+        $this->assertArrayNotHasKey('code', $this->metadata->getMetadataFromUser($username));
+
+        $this->assertIsNumeric($this->metadata->getUsage());
+
+        $this->assertIsBool($this->metadata->deleteMetadataFromUser($username));
+
+        $this->assertTrue($this->user->delete($username));
+    }
+}

vendor/maniac/easemob-php/tests/UserTest.php

@@ -0,0 +1,262 @@
+<?php
+namespace tests;
+
+class UserTest extends Base
+{
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    public function testCreate()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+        $this->assertArrayHasKey('uuid', $this->user->get($username));
+    }
+
+    public function testBatchCreate()
+    {
+        $randomUsername = Utils::randomUserName();
+        $randomUsername1 = Utils::randomUserName();
+        $randomPassword = Utils::randomPassword();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $randomUsername, 'password' => $randomPassword), array('username' => $randomUsername1, 'password' => $randomPassword))));
+        $this->assertArrayHasKey('uuid', $this->user->get($randomUsername));
+        $this->assertArrayHasKey('uuid', $this->user->get($randomUsername1));
+    }
+
+    public function testUserLifeCycles()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+        $this->assertArrayHasKey('uuid', $this->user->get($username));
+        $this->assertTrue($this->user->delete($username));
+        $result = $this->user->get($username);
+        $this->assertEquals(404, $result['code']);
+    }
+
+    public function testUserForceLogout()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+        $this->assertIsBool($this->user->forceLogoutAllDevices($username));
+        $this->assertTrue($this->user->delete($username));
+    }
+
+    public function testUserUpdatePassword()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+        $this->assertIsBool($this->user->updateUserPassword($username, 'password'));
+        $this->assertTrue($this->user->delete($username));
+    }
+
+    public function testUserListUsers()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+        $data = $this->user->listUsers(1);
+        $this->assertArrayHasKey('data', $data);
+        $this->assertEquals(1, count($data['data']));
+        $this->assertArrayHasKey('uuid', $data['data'][0]);
+        $this->assertTrue($this->user->delete($username));
+    }
+
+    public function testUserContactLifeCycles()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+
+        $contactUsername = Utils::randomUserName();
+        $contactPassword = Utils::randomPassword();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $username, 'password' => $password), array('username' => $contactUsername, 'password' => $contactPassword))));
+
+        $this->assertIsBool($this->contact->add($username, $contactUsername));
+
+        $data = $this->contact->get($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+        $this->assertEquals($data[0], $contactUsername);
+
+        $this->assertIsBool($this->contact->remove($username, $contactUsername));
+
+        $data = $this->contact->get($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(0, count($data));
+
+        $this->assertTrue($this->user->delete($username));
+        $this->assertTrue($this->user->delete($contactUsername));
+    }
+
+    public function testUserGetUsersBlockedFromSendMsg()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+
+        $randomUsernameCodeJack = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $username, 'password' => $password), array('username' => $randomUsernameCodeJack, 'password' => $password))));
+
+        $this->assertTrue($this->block->blockUserSendMsgToUser($username, array($randomUsernameCodeJack)));
+
+        $data = $this->block->getUsersBlockedFromSendMsgToUser($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+        $this->assertEquals($data[0], $randomUsernameCodeJack);
+
+        $this->assertTrue($this->user->delete($username));
+        $this->assertTrue($this->user->delete($randomUsernameCodeJack));
+    }
+
+    public function testUserBlockUserSendMsg()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+
+        $randomUsernameCodeJack = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $username, 'password' => $password), array('username' => $randomUsernameCodeJack, 'password' => $password))));
+
+        $this->assertIsBool($this->contact->add($username, $randomUsernameCodeJack));
+
+        $data = $this->contact->get($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+        $this->assertEquals($data[0], $randomUsernameCodeJack);
+
+        $this->assertTrue($this->block->blockUserSendMsgToUser($username, array($randomUsernameCodeJack)));
+
+        $data = $this->block->getUsersBlockedFromSendMsgToUser($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+        $this->assertEquals($data[0], $randomUsernameCodeJack);
+
+        $data = $this->contact->get($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+        $this->assertEquals($data[0], $randomUsernameCodeJack);
+
+        $this->assertTrue($this->user->delete($username));
+        $this->assertTrue($this->user->delete($randomUsernameCodeJack));
+    }
+
+    public function testUserUnblockUserSendMsg()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+
+        $randomUsernameCodeJack = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $username, 'password' => $password), array('username' => $randomUsernameCodeJack, 'password' => $password))));
+
+        $this->assertIsBool($this->contact->add($username, $randomUsernameCodeJack));
+
+        $data = $this->contact->get($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+        $this->assertEquals($data[0], $randomUsernameCodeJack);
+
+        $this->assertTrue($this->block->blockUserSendMsgToUser($username, array($randomUsernameCodeJack)));
+
+        $data = $this->block->getUsersBlockedFromSendMsgToUser($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+        $this->assertEquals($data[0], $randomUsernameCodeJack);
+
+        $this->assertTrue($this->block->unblockUserSendMsgToUser($username, $randomUsernameCodeJack));
+
+        $data = $this->block->getUsersBlockedFromSendMsgToUser($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(0, count($data));
+
+        $data = $this->contact->get($username);
+        $this->assertArrayNotHasKey('code', $data);
+        $this->assertEquals(1, count($data));
+        $this->assertEquals($data[0], $randomUsernameCodeJack);
+
+        $this->assertTrue($this->user->delete($username));
+        $this->assertTrue($this->user->delete($randomUsernameCodeJack));
+    }
+
+    public function testUserCountMissedMessages()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+
+        $randomUsernameCodeJack = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $username, 'password' => $password), array('username' => $randomUsernameCodeJack, 'password' => $password))));
+
+        $this->assertArrayNotHasKey('code', $this->message->text('users', array($randomUsernameCodeJack), array('msg' => 'CountMissedMessages'), $username));
+
+        $data = $this->message->countMissedMessages($randomUsernameCodeJack);
+        $this->assertIsInt($data);
+        $this->assertEquals(1, $data);
+
+        $this->assertTrue($this->user->delete($username));
+        $this->assertTrue($this->user->delete($randomUsernameCodeJack));
+    }
+
+    public function testUserBlockLogin()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+
+        $this->assertTrue($this->block->blockUserLogin($username));
+        $result = $this->user->get($username);
+        $this->assertFalse($result['activated']);
+
+        $this->assertTrue($this->block->unblockUserLogin($username));
+        $result = $this->user->get($username);
+        $this->assertTrue($result['activated']);
+
+        $this->assertTrue($this->user->delete($username));
+    }
+
+    public function testUserOnlineStatus()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+
+        $this->assertIsBool($this->user->isUserOnline($username));
+
+        $this->assertTrue($this->user->delete($username));
+    }
+
+    public function testUsersOnlineStatus()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+
+        $randomUsernameCodeJack = Utils::randomUserName();
+
+        $this->assertArrayNotHasKey('code', $this->user->create(array(array('username' => $username, 'password' => $password), array('username' => $randomUsernameCodeJack, 'password' => $password))));
+
+        $this->assertArrayNotHasKey('code', $this->user->isUsersOnline(array($username, $randomUsernameCodeJack)));
+
+        $this->assertTrue($this->user->delete($username));
+        $this->assertTrue($this->user->delete($randomUsernameCodeJack));
+    }
+
+    public function testGetUserToken()
+    {
+        $username = Utils::randomUserName();
+        $password = Utils::randomPassword();
+        
+        $this->assertArrayNotHasKey('code', $this->user->create(array('username' => $username, 'password' => $password)));
+
+        $this->assertArrayHasKey('access_token', $this->auth->getUserToken($username, $password));
+
+        $this->assertTrue($this->user->delete($username));
+    }
+}

vendor/maniac/easemob-php/tests/Utils.php

@@ -0,0 +1,15 @@
+<?php
+namespace tests;
+
+class Utils
+{
+    public static function randomUserName()
+    {
+        return sprintf("it-%d-%d", mt_rand(), microtime(true));
+    }
+
+    public static function randomPassword()
+    {
+        return sprintf("it-password-%d-%d", mt_rand(), microtime(true));
+    }
+}

vendor/maniac/easemob-php/tests/assets/1.txt

@@ -0,0 +1 @@
+123123123

vendor/maniac/easemob-php/tests/bootstrap.php

@@ -0,0 +1,2 @@
+<?php
+require_once __DIR__ . '/../autoload.php';

vendor/maniac/easemob-php/tests/logs/junit.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<testsuites>
+  <testsuite name="tests\UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" tests="13" assertions="84" errors="0" warnings="0" failures="1" skipped="0" time="14.720870">
+    <testcase name="testUserLifeCycles" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="11" assertions="4" time="0.945469"/>
+    <testcase name="testUserForceLogout" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="22" assertions="2" time="0.232179">
+      <failure type="PHPUnit\Framework\ExpectationFailedException">tests\UserTest::testUserForceLogout
+Failed asserting that 0 is of type "bool".
+
+/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php:27</failure>
+    </testcase>
+    <testcase name="testUserUpdatePassword" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="31" assertions="3" time="1.726544"/>
+    <testcase name="testUserListUsers" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="40" assertions="5" time="0.768956"/>
+    <testcase name="testUserContactLifeCycles" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="52" assertions="10" time="1.571048"/>
+    <testcase name="testUserGetUsersBlockedFromSendMsg" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="79" assertions="7" time="1.231210"/>
+    <testcase name="testUserBlockUserSendMsg" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="99" assertions="14" time="1.546252"/>
+    <testcase name="testUserUnblockUserSendMsg" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="131" assertions="17" time="2.030985"/>
+    <testcase name="testUserCountMissedMessages" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="169" assertions="6" time="0.991811"/>
+    <testcase name="testUserBlockLogin" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="188" assertions="6" time="1.335960"/>
+    <testcase name="testUserOnlineStatus" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="205" assertions="3" time="0.695629"/>
+    <testcase name="testUsersOnlineStatus" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="217" assertions="4" time="0.982006"/>
+    <testcase name="testGetUserToken" class="tests\UserTest" classname="tests.UserTest" file="/Users/maniac/docker/nginx/www/sdk.com/tests/UserTest.php" line="232" assertions="3" time="0.662822"/>
+  </testsuite>
+</testsuites>

vendor/maniac/easemob-php/tests/logs/testdox.html

@@ -0,0 +1,48 @@
+<!doctype html>
+<html lang="en">
+    <head>
+        <meta charset="utf-8"/>
+        <title>Test Documentation</title>
+        <style>
+            body {
+                text-rendering: optimizeLegibility;
+                font-variant-ligatures: common-ligatures;
+                font-kerning: normal;
+                margin-left: 2em;
+            }
+
+            body > ul > li {
+                font-family: Source Serif Pro, PT Sans, Trebuchet MS, Helvetica, Arial;
+                font-size: 2em;
+            }
+
+            h2 {
+                font-family: Tahoma, Helvetica, Arial;
+                font-size: 3em;
+            }
+
+            ul {
+                list-style: none;
+                margin-bottom: 1em;
+            }
+        </style>
+    </head>
+    <body>
+        <h2 id="tests\UserTest">User (tests\User)</h2>
+        <ul>
+            <li style="color: #555753;">✓ User life cycles</li>
+            <li style="color: #ef2929;">❌ User force logout</li>
+            <li style="color: #555753;">✓ User update password</li>
+            <li style="color: #555753;">✓ User list users</li>
+            <li style="color: #555753;">✓ User contact life cycles</li>
+            <li style="color: #555753;">✓ User get users blocked from send msg</li>
+            <li style="color: #555753;">✓ User block user send msg</li>
+            <li style="color: #555753;">✓ User unblock user send msg</li>
+            <li style="color: #555753;">✓ User count missed messages</li>
+            <li style="color: #555753;">✓ User block login</li>
+            <li style="color: #555753;">✓ User online status</li>
+            <li style="color: #555753;">✓ Users online status</li>
+            <li style="color: #555753;">✓ Get user token</li>
+        </ul>
+    </body>
+</html>

vendor/maniac/easemob-php/tests/logs/testdox.xml

@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<tests>
+  <test className="tests\UserTest" methodName="testUserLifeCycles" prettifiedClassName="User (tests\User)" prettifiedMethodName="User life cycles" status="0" time="0.945468773" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserForceLogout" prettifiedClassName="User (tests\User)" prettifiedMethodName="User force logout" status="3" time="0.232178852" size="-1" groups="default" exceptionLine="27" exceptionMessage="Failed asserting that 0 is of type &quot;bool&quot;.">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserUpdatePassword" prettifiedClassName="User (tests\User)" prettifiedMethodName="User update password" status="0" time="1.726543796" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserListUsers" prettifiedClassName="User (tests\User)" prettifiedMethodName="User list users" status="0" time="0.768956463" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserContactLifeCycles" prettifiedClassName="User (tests\User)" prettifiedMethodName="User contact life cycles" status="0" time="1.571047531" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserGetUsersBlockedFromSendMsg" prettifiedClassName="User (tests\User)" prettifiedMethodName="User get users blocked from send msg" status="0" time="1.231210003" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserBlockUserSendMsg" prettifiedClassName="User (tests\User)" prettifiedMethodName="User block user send msg" status="0" time="1.546252359" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserUnblockUserSendMsg" prettifiedClassName="User (tests\User)" prettifiedMethodName="User unblock user send msg" status="0" time="2.030984724" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserCountMissedMessages" prettifiedClassName="User (tests\User)" prettifiedMethodName="User count missed messages" status="0" time="0.991811143" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserBlockLogin" prettifiedClassName="User (tests\User)" prettifiedMethodName="User block login" status="0" time="1.33595969" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUserOnlineStatus" prettifiedClassName="User (tests\User)" prettifiedMethodName="User online status" status="0" time="0.695628743" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testUsersOnlineStatus" prettifiedClassName="User (tests\User)" prettifiedMethodName="Users online status" status="0" time="0.982005793" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+  <test className="tests\UserTest" methodName="testGetUserToken" prettifiedClassName="User (tests\User)" prettifiedMethodName="Get user token" status="0" time="0.662822307" size="-1" groups="default">
+    <group name="default"/>
+  </test>
+</tests>