README

环信 IM 服务端 API PHP 封装，节省服务器端开发者对接环信 API 的时间，只需配置 appkey 相关信息即可使用。

功能

PHP SDK 提供了用户、消息、群组、聊天室等资源的操作管理能力。

环境要求

• PHP >= 5.3.3

安装

composer require easemob-community/easemob-php

目录结构

准备

在使用之前，需要准备环信 appKey、Client ID、ClientSecret。

• 已有账号：登录 环信管理后台 → 应用列表 → 查看
• 没有账号：注册 → 添加应用 → 查看

快速开始

使用所有类之前，先初始化 Auth 对象，再将其传入其他类：

require 'vendor/autoload.php';

use Easemob\Auth;
use Easemob\User;

$auth = new Auth("appKey", "Client ID", "ClientSecret");
$user = new User($auth);

框架用户（Laravel / Yii / ThinkPHP）无需手动引入 autoload.php。

API 模块

示例

注册单个用户：

$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 页面
header("Content-Type:text/html;charset=utf-8");

// HTML 混编页面
// <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>

错误码说明

SDK 直接返回 REST API 的错误码及描述，详见 REST API 常见错误码。

使用代理

use Easemob\Auth;
use Easemob\Http\Http;

$auth = new Auth("appKey", "Client ID", "ClientSecret");
Http::setProxy("ip地址", 8080);

链接

• GitHub 仓库
• Packagist
• 环信服务端文档